PowerShell Cmdlet - New-TimeSpan
 記事記号:[mg1934] 初版:2011/Sep/30

この文書は、Windows PowerShellのヘルプ機能で表示される内容を再構成したものです。

名前
    New-TimeSpan
    
概要
    TimeSpan オブジェクトを作成します。
    
構文
    New-TimeSpan [[-Start] <DateTime>] [[-End] <DateTime>] [<CommonParameters>]
    
    New-TimeSpan [-Days <int>] [-Hours <int>] [-Minutes <int>] [-Seconds <int>] 
    [<CommonParameters>]
        
説明
    New-TimeSpan コマンドレットは、時間間隔を表す TimeSpan オブジェクトを作成し
    ます。TimeSpan オブジェクトを使用して、DateTime オブジェクトに対して時間の加
    算または減算を行うことができます。
    
    パラメーターが指定されていない場合、"New-Timespan" コマンドは時間間隔 0 を表
    す TimeSpan オブジェクトを返します。
    
パラメーター
    -Days <int>
        期間の日数を示します。既定値は 0 です。
        
        必須                         false
        位置                         named
        既定値                       0
        パイプライン入力を許可する   false
        ワイルドカード文字を許可する false
        
    -End <DateTime>
        期間の終了日時を示します。既定値は現在の日時です。
        
        必須                         false
        位置                         2
        既定値                       現在の日付と時刻
        パイプライン入力を許可する   true (ByPropertyName)
        ワイルドカード文字を許可する false
        
    -Hours <int>
        期間の時間数を示します。既定値はゼロです。
        
        必須                         false
        位置                         named
        既定値                       0
        パイプライン入力を許可する   false
        ワイルドカード文字を許可する false
        
    -Minutes <int>
        期間の分数を示します。既定値は 0 です。
        
        必須                         false
        位置                         named
        既定値                       0
        パイプライン入力を許可する   false
        ワイルドカード文字を許可する false
        
    -Seconds <int>
        期間の秒数を示します。既定値は 0 です。
        
        必須                         false
        位置                         named
        既定値                       0
        パイプライン入力を許可する   false
        ワイルドカード文字を許可する false
        
    -Start <DateTime>
        期間の開始日時を示します。"3/15/09" のような日時を表す文字列を入力するか、
        Get-Date コマンドが返すような DateTime オブジェクトを入力します。
        
        既定値は現在の日時です。
        
        必須                         false
        位置                         1
        既定値                       現在の日付と時刻
        パイプライン入力を許可する   true (ByValue, ByPropertyName)
        ワイルドカード文字を許可する false
        
    <CommonParameters>
        このコマンドレットは、次の共通パラメーターをサポートします: Verbose、
        Debug、ErrorAction、ErrorVariable、WarningAction、WarningVariable、
        OutBuffer、および OutVariable。詳細については、
        「get-help about_commonparameters」と入力してヘルプを参照してください。
    
入力
    System.DateTime
        パイプを使用して、開始日時を表す DateTime オブジェクトを New-TimeSpan に
        渡すことができます。
    
出力
    System.Timespan
        New-TimeSpan は、期間を表すオブジェクトを返します。
    
メモ
    -------------------------- 例 1 --------------------------
    
    C:\PS>$timespan = new-timespan -hour 1 -minute 25
    
    説明
    -----------
    このコマンドは、期間が 1 時間 25 分である TimeSpan オブジェクトを作成し、$ti
    mespan という名前の変数に保存します。TimeSpan オブジェクトの表記を表示します。
    
    -------------------------- 例 2 --------------------------
    
    C:\PS>new-timespan -end (get-date -year 2010 -month 1 -day 1)
    
    説明
    -----------
    この例では、コマンドが実行された日から 2010 年 1 月 1 日までの期間を表す新し
    い TimeSpan オブジェクトを作成しています。
    
    Start パラメーターの既定値は現在の日時なので、このコマンドには Start パラメ
    ーターは不要です。
    
    -------------------------- 例 3 --------------------------
    
    C:\PS>$90days = new-timespan -days 90
    
    C:\PS> (get-date) + $90days
    
    説明
    -----------
    これらコマンドは、現在の日付から 90 日後の日付を返します。
    
関連するリンク
    Online version: http://go.microsoft.com/fwlink/?LinkID=113360
    Set-Date 
    Get-Date 
    	
記事で解説しているパソコンの環境
 基本ソフト: Windows 7
 キーワード: Windows PowerShell、ヘルプ、Cmdlet、New-TimeSpan
ご利用数: 1859784
感想・要望・問い合わせは こちら