Dates

Dates モジュールは、日付を扱うための2つのタイプを提供します: Date と DateTime で、前者は日単位、後者はミリ秒単位の精度を表します。両者は抽象型 TimeType のサブタイプです。異なるタイプの動機はシンプルです: 一部の操作は、より高い精度の複雑さに対処する必要がない場合、コードと精神的な推論の両方の観点からはるかに簡単になります。例えば、4d61726b646f776e2e436f64652822222c2022446174652229_40726566 タイプは単一の日付の精度（すなわち、時間、分、秒は含まれない）にのみ解決されるため、タイムゾーン、夏時間、うるう秒に関する通常の考慮事項は不要であり、回避されます。

両方の Date と DateTime は基本的に不変の Int64 ラッパーです。いずれのタイプの単一の instant フィールドは実際には UTInstant{P} タイプであり、これは UT 秒に基づく連続的に増加する機械のタイムラインを表します ^[1]。4d61726b646f776e2e436f64652822222c20224461746554696d652229_40726566 タイプはタイムゾーンを認識していません（Python の用語で言うと naive）、Java 8 の LocalDateTime に類似しています。追加のタイムゾーン機能は TimeZones.jl package を通じて追加でき、これは IANA time zone database をコンパイルします。両方の 4d61726b646f776e2e436f64652822222c2022446174652229_40726566 と 4d61726b646f776e2e436f64652822222c20224461746554696d652229_40726566 は ISO 8601 標準に基づいており、これは先行グレゴリオ暦に従っています。1つの注意点は、ISO 8601 標準が BC/BCE 日付に関して特に厳密であることです。一般的に、BC/BCE 時代の最終日である 1-12-31 BC/BCE の後には 1-1-1 AD/CE が続くため、年ゼロは存在しません。しかし、ISO 標準では 1 BC/BCE が年ゼロであると述べているため、0000-12-31 は 0001-01-01 の前日であり、年 -0001（年のための負の1）は 2 BC/BCE、年 -0002 は 3 BC/BCE などです。

Constructors

Date および DateTime タイプは、整数または Period タイプによって構築することができ、パースまたはアジャスターを通じて行うことができます（その詳細については後で説明します）：

julia> DateTime(2013)
2013-01-01T00:00:00

julia> DateTime(2013,7)
2013-07-01T00:00:00

julia> DateTime(2013,7,1)
2013-07-01T00:00:00

julia> DateTime(2013,7,1,12)
2013-07-01T12:00:00

julia> DateTime(2013,7,1,12,30)
2013-07-01T12:30:00

julia> DateTime(2013,7,1,12,30,59)
2013-07-01T12:30:59

julia> DateTime(2013,7,1,12,30,59,1)
2013-07-01T12:30:59.001

julia> Date(2013)
2013-01-01

julia> Date(2013,7)
2013-07-01

julia> Date(2013,7,1)
2013-07-01

julia> Date(Dates.Year(2013),Dates.Month(7),Dates.Day(1))
2013-07-01

julia> Date(Dates.Month(7),Dates.Year(2013))
2013-07-01

Date または DateTime の解析は、フォーマット文字列を使用して行われます。フォーマット文字列は、解析するための期間を含む 区切られた または 固定幅 の "スロット" を定義するという概念によって機能し、解析するテキストとフォーマット文字列を 4d61726b646f776e2e436f64652822222c2022446174652229_40726566 または 4d61726b646f776e2e436f64652822222c20224461746554696d652229_40726566 コンストラクタに渡します。形式は Date("2015-01-01",dateformat"y-m-d") または DateTime("20150101",dateformat"yyyymmdd") です。

区切りスロットは、2つの連続する期間の間にパーサーが期待する区切り文字を指定することでマークされます。したがって、"y-m-d"は、日付文字列"2014-07-16"の最初と2番目のスロットの間に-文字があるべきことをパーサーに知らせます。y、m、およびd文字は、各スロットでどの期間を解析するかをパーサーに知らせます。

上記のコンストラクタの例 Date(2013) のように、区切り付きの DateFormat は、前の部分が与えられている限り、日付や時間の欠落した部分を許可します。他の部分には通常のデフォルト値が与えられます。例えば、Date("1981-03", dateformat"y-m-d") は 1981-03-01 を返し、Date("31/12", dateformat"d/m/y") は 0001-12-31 を返します。（デフォルトの年は1年AD/CEであることに注意してください。）ただし、空の文字列は常に ArgumentError をスローします。

固定幅スロットは、幅に対応する回数だけピリオド文字を繰り返すことで指定され、文字の間に区切りはありません。したがって、dateformat"yyyymmdd"は、日付文字列のように"20140716"に対応します。パーサーは、区切りがないことによって固定幅スロットを区別し、1つのピリオド文字から次のピリオド文字への遷移"yyyymm"に注目します。

テキスト形式の月の解析は、略称とフルネームの月名にそれぞれ u と U 文字を通じてサポートされています。デフォルトでは、英語の月名のみがサポートされているため、u は "Jan"、"Feb"、"Mar" などに対応します。そして U は "January"、"February"、"March" などに対応します。他の名前=>値マッピング関数 dayname と monthname と同様に、カスタムロケールは MONTHTOVALUEABBR および MONTHTOVALUE 辞書に略称およびフルネームの月名のために locale=>Dict{String,Int} マッピングを渡すことでロードできます。

上記の例では、dateformat""文字列マクロが使用されました。このマクロは、マクロが展開されるときに一度DateFormatオブジェクトを作成し、コードスニペットが複数回実行されても同じDateFormatオブジェクトを使用します。

julia> for i = 1:10^5
           Date("2015-01-01", dateformat"y-m-d")
       end

または、DateFormatオブジェクトを明示的に作成することもできます：

julia> df = DateFormat("y-m-d");

julia> dt = Date("2015-01-01",df)
2015-01-01

julia> dt2 = Date("2015-01-02",df)
2015-01-02

代わりに、ブロードキャスティングを使用します：

julia> years = ["2015", "2016"];

julia> Date.(years, DateFormat("yyyy"))
2-element Vector{Date}:
 2015-01-01
 2016-01-01

便利のために、フォーマット文字列を直接渡すこともできます（例：Date("2015-01-01","y-m-d")）。ただし、この形式は同じフォーマットを繰り返し解析する場合にパフォーマンスコストが発生します。なぜなら、内部的に毎回新しいDateFormatオブジェクトを作成するからです。

Date または DateTime は、コンストラクタを介してだけでなく、文字列からも構築できます。これは parse および tryparse 関数を使用して行いますが、オプションの第三引数として DateFormat 型のフォーマットを指定できます。例えば、parse(Date, "06.23.2013", dateformat"m.d.y") や、デフォルトフォーマットを使用する tryparse(DateTime, "1999-12-31T23:59:59") があります。これらの関数の顕著な違いは、4d61726b646f776e2e436f64652822222c202274727970617273652229_40726566 を使用する場合、文字列が空であるか無効なフォーマットであってもエラーはスローされず、代わりに nothing が返されることです。

Julia 1.9

Julia 1.9以前は、空の文字列をコンストラクタやparseに渡してもエラーが発生せず、適切にDateTime(1)、Date(1)、またはTime(0)が返されていました。同様に、tryparseはnothingを返しませんでした。

stdlib/Dates/test/io.jlの完全なパースおよびフォーマットテストと例のスイートが利用可能です。

Durations/Comparisons

Finding the length of time between two Date or DateTime is straightforward given their underlying representation as UTInstant{Day} and UTInstant{Millisecond}, respectively. The difference between Date is returned in the number of Day, and DateTime in the number of Millisecond. Similarly, comparing TimeType is a simple matter of comparing the underlying machine instants (which in turn compares the internal Int64 values).

julia> dt = Date(2012,2,29)
2012-02-29

julia> dt2 = Date(2000,2,1)
2000-02-01

julia> dump(dt)
Date
  instant: Dates.UTInstant{Day}
    periods: Day
      value: Int64 734562

julia> dump(dt2)
Date
  instant: Dates.UTInstant{Day}
    periods: Day
      value: Int64 730151

julia> dt > dt2
true

julia> dt != dt2
true

julia> dt + dt2
ERROR: MethodError: no method matching +(::Date, ::Date)
[...]

julia> dt * dt2
ERROR: MethodError: no method matching *(::Date, ::Date)
[...]

julia> dt / dt2
ERROR: MethodError: no method matching /(::Date, ::Date)

julia> dt - dt2
4411 days

julia> dt2 - dt
-4411 days

julia> dt = DateTime(2012,2,29)
2012-02-29T00:00:00

julia> dt2 = DateTime(2000,2,1)
2000-02-01T00:00:00

julia> dt - dt2
381110400000 milliseconds

Accessor Functions

Date および DateTime タイプは、単一の Int64 値として保存されているため、日付の部分やフィールドはアクセサ関数を通じて取得できます。小文字のアクセサはフィールドを整数として返します：

julia> t = Date(2014, 1, 31)
2014-01-31

julia> Dates.year(t)
2014

julia> Dates.month(t)
1

julia> Dates.week(t)
5

julia> Dates.day(t)
31

While propercase return the same value in the corresponding Period type:

julia> Dates.Year(t)
2014 years

julia> Dates.Day(t)
31 days

複合メソッドは、個別にアクセスするよりも同時に複数のフィールドにアクセスする方が効率的であるため提供されています：

julia> Dates.yearmonth(t)
(2014, 1)

julia> Dates.monthday(t)
(1, 31)

julia> Dates.yearmonthday(t)
(2014, 1, 31)

基礎となる UTInstant または整数値にもアクセスできます:

julia> dump(t)
Date
  instant: Dates.UTInstant{Day}
    periods: Day
      value: Int64 735264

julia> t.instant
Dates.UTInstant{Day}(Day(735264))

julia> Dates.value(t)
735264

Query Functions

クエリ関数は、TimeTypeに関するカレンダー情報を提供します。これには、曜日に関する情報が含まれています：

julia> t = Date(2014, 1, 31)
2014-01-31

julia> Dates.dayofweek(t)
5

julia> Dates.dayname(t)
"Friday"

julia> Dates.dayofweekofmonth(t) # 5th Friday of January
5

年の月:

julia> Dates.monthname(t)
"January"

julia> Dates.daysinmonth(t)
31

TimeTypeの年と四半期に関する情報:

julia> Dates.isleapyear(t)
false

julia> Dates.dayofyear(t)
31

julia> Dates.quarterofyear(t)
1

julia> Dates.dayofquarter(t)
31

dayname および monthname メソッドは、他の言語/ロケールのために曜日や月の名前を返すために使用できるオプションの locale キーワードを取ることもできます。これらの関数には、省略形の名前を返すバージョンもあり、具体的には dayabbr および monthabbr です。最初に、マッピングが LOCALES 変数にロードされます：

julia> french_months = ["janvier", "février", "mars", "avril", "mai", "juin",
                        "juillet", "août", "septembre", "octobre", "novembre", "décembre"];

julia> french_months_abbrev = ["janv","févr","mars","avril","mai","juin",
                              "juil","août","sept","oct","nov","déc"];

julia> french_days = ["lundi","mardi","mercredi","jeudi","vendredi","samedi","dimanche"];

julia> Dates.LOCALES["french"] = Dates.DateLocale(french_months, french_months_abbrev, french_days, [""]);

上記の関数は、クエリを実行するために使用できます：

julia> Dates.dayname(t;locale="french")
"vendredi"

julia> Dates.monthname(t;locale="french")
"janvier"

julia> Dates.monthabbr(t;locale="french")
"janv"

省略形の曜日が読み込まれていないため、dayabbr 関数を使用しようとするとエラーが発生します。

julia> Dates.dayabbr(t;locale="french")
ERROR: BoundsError: attempt to access 1-element Vector{String} at index [5]
Stacktrace:
[...]

TimeType-Period Arithmetic

It's good practice when using any language/date framework to be familiar with how date-period arithmetic is handled as there are some tricky issues to deal with (though much less so for day-precision types).

Dates モジュールのアプローチは、Period 算術を行う際に、できるだけ少ない変更を試みるというシンプルな原則に従おうとします。このアプローチは、カレンダー 算術としても知られており、誰かが会話の中で同じ計算を尋ねた場合にあなたが推測するであろうことです。なぜこれほど騒がれているのでしょうか？クラシックな例を見てみましょう：2014年1月31日に1ヶ月を加えます。答えは何でしょうか？Javascriptは March 3 （31日を仮定）と言います。PHPは March 2 （30日を仮定）と言います。実際のところ、正しい答えはありません。Dates モジュールでは、結果として2月28日を返します。どのようにそれを計算するのでしょうか？カジノのクラシックな7-7-7ギャンブルゲームを考えてみてください。

今、7-7-7の代わりにスロットが年-月-日であると想像してみてください。私たちの例では、2014-01-31です。この日付に1か月を追加するように頼むと、月のスロットが増加し、2014-02-31になります。次に、日付が新しい月の有効な最終日より大きいかどうかがチェックされます。もしそうであれば（上記のケースのように）、日付は最終有効日（28）に調整されます。このアプローチの影響は何でしょうか？日付 2014-02-28 + Month(1) == 2014-03-28 にもう1か月を追加してみましょう。え？3月の最終日を期待していましたか？いいえ、申し訳ありませんが、7-7-7のスロットを思い出してください。できるだけ少ないスロットが変更されるので、まず月のスロットを1増やして2014-03-28にし、これで完了です。これは有効な日付です。一方、元の日時2014-01-31に2か月を追加すると、予想通り2014-03-31になります。このアプローチのもう一つの影響は、特定の順序が強制されると結合性が失われることです（つまり、異なる順序で追加すると異なる結果が得られます）。例えば：

julia> (Date(2014,1,29)+Dates.Day(1)) + Dates.Month(1)
2014-02-28

julia> (Date(2014,1,29)+Dates.Month(1)) + Dates.Day(1)
2014-03-01

何が起こっているのでしょうか？最初の行では、1日を1月29日に加えています。これにより2014-01-30になります。その後、1ヶ月を加えると2014-02-30になり、これが2014-02-28に調整されます。2番目の例では、最初に1ヶ月を加えます。これにより2014-02-29になり、2014-02-28に調整され、その後1日を加えると2014-03-01になります。この場合に役立つデザイン原則の1つは、複数の期間が存在する場合、操作が期間のタイプによって順序付けられるということです。これは、Yearが常に最初に加えられ、その後にMonth、Weekなどが続くことを意味します。したがって、以下のは結合性を持ち、うまく機能します：

julia> Date(2014,1,29) + Dates.Day(1) + Dates.Month(1)
2014-03-01

julia> Date(2014,1,29) + Dates.Month(1) + Dates.Day(1)
2014-03-01

トリッキーですか？おそらく。無邪気な Dates ユーザーは何をすべきでしょうか？要するに、月を扱う際に特定の結合性を明示的に強制することは、予期しない結果を招く可能性があることを認識しておくべきですが、それ以外はすべてが期待通りに機能するはずです。幸いなことに、UTでの時間を扱う際の日付期間の算術における奇妙なケースはこれがほとんどです（夏時間、うるう秒などの「喜び」を避けること）。

ボーナスとして、すべての期間算術オブジェクトは範囲と直接連携します：

julia> dr = Date(2014,1,29):Day(1):Date(2014,2,3)
Date("2014-01-29"):Day(1):Date("2014-02-03")

julia> collect(dr)
6-element Vector{Date}:
 2014-01-29
 2014-01-30
 2014-01-31
 2014-02-01
 2014-02-02
 2014-02-03

julia> dr = Date(2014,1,29):Dates.Month(1):Date(2014,07,29)
Date("2014-01-29"):Month(1):Date("2014-07-29")

julia> collect(dr)
7-element Vector{Date}:
 2014-01-29
 2014-02-28
 2014-03-29
 2014-04-29
 2014-05-29
 2014-06-29
 2014-07-29

Adjuster Functions

日付の期間算術が便利である一方で、日付に必要な計算の多くは、固定された期間の数ではなく、カレンダー的または時間的な性質を持つことがよくあります。祝日はその完璧な例です。ほとんどは「メモリアルデー = 5月の最後の月曜日」や「感謝祭 = 11月の第4木曜日」といったルールに従います。このような時間的表現は、月の最初または最後、次の火曜日、または最初と第3の水曜日など、カレンダーに関連するルールを扱います。

Datesモジュールは、時間的ルールを簡潔に表現するのに役立つ便利なメソッドを通じてアジャスターAPIを提供します。最初のグループのアジャスターメソッドは、週、月、四半期、年の最初と最後に関するものです。それぞれは単一のTimeTypeを入力として受け取り、入力に対して希望する期間の最初または最後に調整します。

julia> Dates.firstdayofweek(Date(2014,7,16)) # Adjusts the input to the Monday of the input's week
2014-07-14

julia> Dates.lastdayofmonth(Date(2014,7,16)) # Adjusts to the last day of the input's month
2014-07-31

julia> Dates.lastdayofquarter(Date(2014,7,16)) # Adjusts to the last day of the input's quarter
2014-09-30

次の2つの高次のメソッド、tonext と toprev は、最初の引数として DateFunction を取り、開始 TimeType とともに、時間的表現を扱うことを一般化します。DateFunction は、通常は匿名の関数で、単一の 4d61726b646f776e2e436f64652822222c202254696d65547970652229_40726566 を入力として受け取り、Bool を返し、調整基準が満たされていることを示す true を返します。例えば：

julia> istuesday = x->Dates.dayofweek(x) == Dates.Tuesday; # Returns true if the day of the week of x is Tuesday

julia> Dates.tonext(istuesday, Date(2014,7,13)) # 2014-07-13 is a Sunday
2014-07-15

julia> Dates.tonext(Date(2014,7,13), Dates.Tuesday) # Convenience method provided for day of the week adjustments
2014-07-15

これは、より複雑な時間表現のためのdoブロック構文で役立ちます：

julia> Dates.tonext(Date(2014,7,13)) do x
           # Return true on the 4th Thursday of November (Thanksgiving)
           Dates.dayofweek(x) == Dates.Thursday &&
           Dates.dayofweekofmonth(x) == 4 &&
           Dates.month(x) == Dates.November
       end
2014-11-27

Base.filter メソッドを使用すると、指定された範囲内のすべての有効な日付/瞬間を取得できます：

# Pittsburgh street cleaning; Every 2nd Tuesday from April to November
# Date range from January 1st, 2014 to January 1st, 2015
julia> dr = Dates.Date(2014):Day(1):Dates.Date(2015);

julia> filter(dr) do x
           Dates.dayofweek(x) == Dates.Tue &&
           Dates.April <= Dates.month(x) <= Dates.Nov &&
           Dates.dayofweekofmonth(x) == 2
       end
8-element Vector{Date}:
 2014-04-08
 2014-05-13
 2014-06-10
 2014-07-08
 2014-08-12
 2014-09-09
 2014-10-14
 2014-11-11

追加の例とテストは stdlib/Dates/test/adjusters.jl で入手できます。

Period Types

期間は、人間が捉える離散的で時には不規則な時間の長さです。1か月を考えてみてください。それは、年や月の文脈に応じて、28、29、30、または31日の値を表すことがあります。また、1年は、うるう年の場合、365日または366日を表すことがあります。 Period タイプは単純な Int64 ラッパーであり、任意の Int64 変換可能なタイプをラップすることによって構築されます。つまり、Year(1) や Month(3.0) です。同じタイプの 4d61726b646f776e2e436f64652822222c2022506572696f642229_40726566 同士の算術は整数のように振る舞い、制限された Period-Real 算術が利用可能です。基礎となる整数は Dates.value を使って抽出できます。

julia> y1 = Dates.Year(1)
1 year

julia> y2 = Dates.Year(2)
2 years

julia> y3 = Dates.Year(10)
10 years

julia> y1 + y2
3 years

julia> div(y3,y2)
5

julia> y3 - y2
8 years

julia> y3 % y2
0 years

julia> div(y3,3) # mirrors integer division
3 years

julia> Dates.value(Dates.Millisecond(10))
10

整数倍ではない期間や持続時間を表現するには、Dates.CompoundPeriod 型を使用できます。複合期間は、単純な Period 型から手動で構築することができます。さらに、canonicalize 関数を使用して、期間を 4d61726b646f776e2e436f64652822222c202244617465732e436f6d706f756e64506572696f642229_40726566 に分解することができます。これは、例えば、2つの DateTime の差をより便利な表現に変換するのに特に役立ちます。

julia> cp = Dates.CompoundPeriod(Day(1),Minute(1))
1 day, 1 minute

julia> t1 = DateTime(2018,8,8,16,58,00)
2018-08-08T16:58:00

julia> t2 = DateTime(2021,6,23,10,00,00)
2021-06-23T10:00:00

julia> canonicalize(t2-t1) # creates a CompoundPeriod
149 weeks, 6 days, 17 hours, 2 minutes

Rounding

Date と DateTime の値は、floor、ceil、または round を使用して、指定された解像度（例：1か月または15分）に丸めることができます。

julia> floor(Date(1985, 8, 16), Dates.Month)
1985-08-01

julia> ceil(DateTime(2013, 2, 13, 0, 31, 20), Dates.Minute(15))
2013-02-13T00:45:00

julia> round(DateTime(2016, 8, 6, 20, 15), Dates.Day)
2016-08-07T00:00:00

数値 round メソッドとは異なり、デフォルトで偶数に向かって引き分けを行うのではなく、TimeType4d61726b646f776e2e436f64652822222c2022726f756e642229_40726566 メソッドは RoundNearestTiesUp 丸めモードを使用します。引き分けを最も近い「偶数」にする 4d61726b646f776e2e436f64652822222c202254696d65547970652229_40726566 が何を意味するのかを推測するのは難しいです。利用可能な RoundingMode についての詳細は API reference で確認できます。

丸めは一般的に期待通りに動作するべきですが、期待される動作が明らかでないいくつかのケースがあります。

Rounding Epoch

多くの場合、丸めのために指定された解像度（例：Dates.Second(30)）は、次に大きな期間（この場合はDates.Minute(1)）に均等に分割されます。しかし、これが当てはまらない場合の丸めの挙動は混乱を招く可能性があります。DateTimeを最も近い10時間に丸めた場合の期待される結果は何ですか？

julia> round(DateTime(2016, 7, 17, 11, 55), Dates.Hour(10))
2016-07-17T12:00:00

それは混乱を招くかもしれませんが、時間（12）は10で割り切れません。2016-07-17T12:00:00が選ばれた理由は、0000-01-01T00:00:00から17,676,660時間後であり、17,676,660は10で割り切れるからです。

ジュリア Date と DateTime の値は ISO 8601 標準に従って表現されており、日数（およびミリ秒）の計算に使用される丸め計算の開始点として 0000-01-01T00:00:00 が基準（または「丸めエポック」）として選ばれました。（これは、ジュリアの内部表現 4d61726b646f776e2e436f64652822222c2022446174652229_40726566 が Rata Die notation を使用しているのとはわずかに異なることに注意してください。しかし、ISO 8601 標準はエンドユーザーに最も見えるため、混乱を最小限に抑えるために内部で使用される 0000-12-31T00:00:00 の代わりに 0000-01-01T00:00:00 が丸めエポックとして選ばれました。）

0000-01-01T00:00:00を丸めの基準点として使用する唯一の例外は、週に丸める場合です。最も近い週に丸めると、常に月曜日（ISO 8601で指定された週の最初の日）が返されます。このため、週数に丸める際の基準として、0000-01-03T00:00:00（ISO 8601で定義された年0000の最初の週の最初の日）を使用します。

ここに、期待される動作が必ずしも明白ではない関連するケースがあります：PがPeriod型であるとき、最も近いP(2)に丸めると何が起こるでしょうか？いくつかのケース（具体的には、P <: Dates.TimePeriodの場合）では、答えは明確です：

julia> round(DateTime(2016, 7, 17, 8, 55, 30), Dates.Hour(2))
2016-07-17T08:00:00

julia> round(DateTime(2016, 7, 17, 8, 55, 30), Dates.Minute(2))
2016-07-17T08:56:00

これは明らかに思えます。なぜなら、これらの各期間の2つは次の大きな順序の期間に均等に分割されるからです。しかし、2か月の場合（これはまだ1年に均等に分割されます）、答えは驚くべきものかもしれません：

julia> round(DateTime(2016, 7, 17, 8, 55, 30), Dates.Month(2))
2016-07-01T00:00:00

なぜ7月の最初の日に丸めるのか、月が奇数であるにもかかわらず？鍵は、月が1から始まる（最初の月は1が割り当てられる）のに対し、時間、分、秒、ミリ秒は0から始まるということです。

これは、DateTimeを秒、分、時間、または年の偶数倍に丸めると（ISO 8601仕様には年ゼロが含まれているため）、そのフィールドに偶数の値を持つ4d61726b646f776e2e436f64652822222c20224461746554696d652229_40726566が得られることを意味します。一方、4d61726b646f776e2e436f64652822222c20224461746554696d652229_40726566を月の偶数倍に丸めると、月のフィールドには奇数の値が得られます。月と年の両方が不規則な日数を含む可能性があるため、偶数の日数に丸めると日数フィールドに偶数の値が得られるかどうかは不確かです。

Datesモジュールからエクスポートされたメソッドに関する追加情報は、API referenceを参照してください。

API reference

Dates and Time Types

Dates.Period — Type

期間
年
四半期
月
週
日
時間
分
秒
ミリ秒
マイクロ秒
ナノ秒

Period 型は、時間の離散的で人間の表現を表します。

コード	例	コメント
`y`	6	固定幅の数値年
`Y`	1996	最小幅の数値年
`m`	1, 12	最小幅の数値月
`u`	Jan	`locale`に従った3文字に短縮された月名
`U`	January	`locale`キーワードに従った完全な月名
`d`	1, 31	最小幅の日付
`H`	0, 23	最小幅の時間（24時間制）
`M`	0, 59	最小幅の分
`S`	0, 59	最小幅の秒
`s`	000, 500	最小幅3のミリ秒
`e`	Mon, Tue	短縮された曜日名
`E`	Monday	完全な曜日名

コード	一致する	コメント
`Y`	1996, 96	1996年、0096を返します
`y`	1996, 96	`parse`では`Y`と同じですが、`format`では余分な桁を破棄します
`m`	1, 01	1桁または2桁の月に一致します
`u`	Jan	`locale`キーワードに従って省略形の月に一致します
`U`	January	`locale`キーワードに従って完全な月名に一致します
`d`	1, 01	1桁または2桁の日に一致します
`H`	00	時間（24時間制）に一致します
`I`	00	12時間制で時間を出力するためのもの
`M`	00	分に一致します
`S`	00	秒に一致します
`s`	.500	ミリ秒に一致します
`e`	Mon, Tues	週の省略形の日に一致します
`E`	Monday	週の完全な名前の日に一致します
`p`	AM	AM/PMに一致します（大文字小文字を区別しない）
`yyyymmdd`	19960101	固定幅の年、月、日と一致します

Variable	Abbr.	Value (Int)
`Monday`	`Mon`	1
`Tuesday`	`Tue`	2
`Wednesday`	`Wed`	3
`Thursday`	`Thu`	4
`Friday`	`Fri`	5
`Saturday`	`Sat`	6
`Sunday`	`Sun`	7

Variable	Abbr.	Value (Int)
`January`	`Jan`	1
`February`	`Feb`	2
`March`	`Mar`	3
`April`	`Apr`	4
`May`	`May`	5
`June`	`Jun`	6
`July`	`Jul`	7
`August`	`Aug`	8
`September`	`Sep`	9
`October`	`Oct`	10
`November`	`Nov`	11
`December`	`Dec`	12