DateDifference

DateDifference[date1,date2]

date1から date2までの日数を返す.

DateDifference[date1,date2,"unit"]

date1date2の違いを指定した単位で返す.

DateDifference[date1,date2,{"unit1","unit2",}]

違いを連続する"uniti"に対応する要素のリストとして返す.

詳細とオプション

  • DateDifferenceは,指定された日付間の時間量を計算し,結果を物理的な期間か暦ステップの数として表す.
  • DateDifferenceQuantityオブジェクトを返す.
  • 日付は次の形式で指定できる.
  • DateObject[]日付オブジェクト
    {y,m,d}年,月,日
    {y,m}指定の月の最初の日
    {y}y 年1月1日
    "string"文字列としての日付("Jan. 1, 2022"
    {y,m,d,h,m,s}正確な時間
    time絶対時間指定
  • 使用可能な単位は,"Year""Quarter""Month""Week""Day""Hour""Minute""Second"である.
  • {y,m,d}{y,m,d,0,0,0}等と等しいとみなされる.
  • DateDifferenceは次のオプションを取る.
  • DayCountConvention "ActualActual"差を計算するときに使われる数え方の慣例
    Method Automatic使用する日付計算法
  • 日付計算は,変数の期間(例:"Month")として加えられた時間ステップを物理的な期間に変換する(連続計算)か,すべてを離散的な暦のステップとして扱う(離散計算)かする.
  • オプション値Method"Continuous"は連続計算を実装する.離散計算はMethodrolling で実装される.指標可能なオプションには"RollForward""RollBackward""RollOver"がある.デフォルトは"RollBackward"である.
  • 離散計算では,例えば1ヶ月を加えると存在しない日付(例:February 30)になることがある.そのような場合に日付を解決するために使えるオプションには以下の3つある.
  • "RollBackward"既存の最後の日付(Feb 28)まで戻る
    "RollForward"次の既存の日付(Mar 1)まで進む
    "RollOver"次の既存の日付(Mar )から増分する
  • 日数で数えられたDateDifferenceは,差の大きさには関係なく,日数を数える慣例に従う.
  • DateDifference[date2]は,現行の日付から date2までの日数を分数で返す.

例題

すべて開くすべて閉じる

  (4)

1月1日から7月4日までの日数を返す:

{y,m,d}の形式の日付指定を使う:

日数差を週単位で求める:

2番目の日付が最初の日付の前になる場合,日数差は負になる:

スコープ  (6)

日付形式  (3)

DateStringがサポートしている任意の形式で日付を返す:

異なる日付指定を混ぜることができる:

DateDifference{y,m,d,h,m,s}形式の時間を使うことができる:

単位  (3)

2つの日付間の時間数を求める:

2つの日付間の年数を求める:

2つの日付の差を月数と日数で求める:

オプション  (6)

DayCountConvention  (2)

日数を数える慣例は,月の最終日に適用される数え方について異なる:

日数を数える慣例に従って,年数での差を計算する:

CalendarType  (2)

ユダヤ暦での日数差を計算する:

イスラム暦の年はグレゴリオ暦の年より短い:

Method  (2)

デフォルトで,3月31日は6月30日の3ヶ月前になる:

Method"RollForward"を使うと日付間の距離は2ヶ月と30日になる:

異なる計算法で2つの日付を比較した結果を比較する:

アプリケーション  (2)

2000年の最初からの年数,月数,日数を求める:

3月21日から9月21日までは,常に184日である:

閏年でなければ,9月21日から3月21日までは181日である:

閏年なら182日になる:

特性と関係  (1)

DatePlusは時間単位を日付に加えるのに対し,DateDifferenceは日付間の単位を計算する:

逆の関係:

考えられる問題  (2)

日付文字列は曖昧なことがある:

DateObjectを使って異なる解釈間の曖昧さを回避する:

以前のWolfram言語のリリースでは,DateDifferenceは純粋な数値結果を返した.このレガシー動作はSetSystemOptionsで有効にすることができる:

Quantity結果は上記と同じシステムオプションの値をTrueに設定することで,再び有効にすることができる:

Wolfram Research (2007), DateDifference, Wolfram言語関数, https://reference.wolfram.com/language/ref/DateDifference.html (2022年に更新).

テキスト

Wolfram Research (2007), DateDifference, Wolfram言語関数, https://reference.wolfram.com/language/ref/DateDifference.html (2022年に更新).

CMS

Wolfram Language. 2007. "DateDifference." Wolfram Language & System Documentation Center. Wolfram Research. Last Modified 2022. https://reference.wolfram.com/language/ref/DateDifference.html.

APA

Wolfram Language. (2007). DateDifference. Wolfram Language & System Documentation Center. Retrieved from https://reference.wolfram.com/language/ref/DateDifference.html

BibTeX

@misc{reference.wolfram_2024_datedifference, author="Wolfram Research", title="{DateDifference}", year="2022", howpublished="\url{https://reference.wolfram.com/language/ref/DateDifference.html}", note=[Accessed: 21-November-2024 ]}

BibLaTeX

@online{reference.wolfram_2024_datedifference, organization={Wolfram Research}, title={DateDifference}, year={2022}, url={https://reference.wolfram.com/language/ref/DateDifference.html}, note=[Accessed: 21-November-2024 ]}