Dates

وحدة Dates توفر نوعين للعمل مع التواريخ: Date و DateTime، والتي تمثل دقة اليوم والمللي ثانية، على التوالي؛ وكلاهما نوعان فرعيان من النوع المجرد TimeType. الدافع وراء وجود أنواع متميزة بسيط: بعض العمليات تكون أبسط بكثير، سواء من حيث الكود أو التفكير العقلي، عندما لا يتعين التعامل مع تعقيدات الدقة الأكبر. على سبيل المثال، نظرًا لأن نوع 4d61726b646f776e2e436f64652822222c2022446174652229_40726566 يحل فقط إلى دقة تاريخ واحد (أي لا ساعات، دقائق، أو ثواني)، فإن الاعتبارات العادية للمناطق الزمنية، وتوفير ضوء النهار/الوقت الصيفي، والثواني الكبيسة غير ضرورية ويتم تجنبها.

كلا من Date و DateTime هما في الأساس أغلفة غير قابلة للتغيير Int64. الحقل الفردي instant من أي نوع هو في الواقع نوع UTInstant{P}، والذي يمثل خط زمن آلي متزايد باستمرار بناءً على الثانية UT ^[1]. نوع 4d61726b646f776e2e436f64652822222c20224461746554696d652229_40726566 غير مدرك لمناطق الزمن (naive، في مصطلحات بايثون)، وهو مشابه لـ LocalDateTime في Java 8. يمكن إضافة وظائف منطقة زمنية إضافية من خلال TimeZones.jl package، والذي يجمع IANA time zone database. كلا من 4d61726b646f776e2e436f64652822222c2022446174652229_40726566 و 4d61726b646f776e2e436f64652822222c20224461746554696d652229_40726566 مبنيان على معيار ISO 8601، الذي يتبع التقويم الغريغوري الاستباقي. ملاحظة واحدة هي أن معيار 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 (نعم، سالب واحد للسنة) هو 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").

تُحدد الفتحات المفصولة عن طريق تحديد الفاصل الذي يجب أن يتوقعه المحلل بين فترتين متتاليتين؛ لذا فإن "y-m-d" يُعلم المحلل أنه بين الفتحتين الأولى والثانية في سلسلة التاريخ مثل "2014-07-16"، يجب أن يجد حرف -. تُعلم الأحرف 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 ميلادي/ميلادي). ومع ذلك، فإن سلسلة فارغة دائمًا ما ترمي ArgumentError.

تحدد الفتحات ذات العرض الثابت عن طريق تكرار حرف النقطة بعدد المرات التي تتوافق مع العرض دون فاصل بين الأحرف. لذا فإن dateformat"yyyymmdd" ستتوافق مع سلسلة تاريخ مثل "20140716". يميز المحلل الفتحة ذات العرض الثابت من خلال غياب الفاصل، مشيرًا إلى الانتقال "yyyymm" من حرف نقطة واحد إلى التالي.

يدعم تحليل النصوص للأشهر من خلال استخدام الحرفين u و U، للأسماء المختصرة والطويلة للأشهر، على التوالي. بشكل افتراضي، يتم دعم أسماء الأشهر باللغة الإنجليزية فقط، لذا فإن u يتوافق مع "Jan" و "Feb" و "Mar" وما إلى ذلك. و U يتوافق مع "January" و "February" و "March" وما إلى ذلك. مشابهًا لوظائف الربط بين الاسم=>القيمة الأخرى dayname و monthname، يمكن تحميل محليات مخصصة عن طريق تمرير الربط locale=>Dict{String,Int} إلى القواميس MONTHTOVALUEABBR و MONTHTOVALUE لأسماء الأشهر المختصرة والطويلة، على التوالي.

تستخدم الأمثلة أعلاه ماكرو 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

بينما تعيد propercase نفس القيمة في النوع المقابل Period:

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

من الجيد أن تكون على دراية بكيفية التعامل مع حسابات فترات التاريخ عند استخدام أي إطار عمل للغة/التاريخ، حيث يوجد بعض tricky issues للتعامل معها (على الرغم من أن هذا أقل بكثير بالنسبة لأنواع الدقة اليومية).

تسعى مقاربة وحدة Dates إلى اتباع المبدأ البسيط المتمثل في محاولة تغيير أقل ما يمكن عند إجراء العمليات الحسابية Period. تُعرف هذه المقاربة أيضًا غالبًا باسم الحسابات التقويمية أو ما قد تخمنه إذا سُئلت عن نفس الحساب في محادثة. لماذا كل هذه الضجة حول هذا؟ دعنا نأخذ مثالًا كلاسيكيًا: أضف شهرًا واحدًا إلى 31 يناير 2014. ما هي الإجابة؟ ستقول جافا سكريبت March 3 (تفترض 31 يومًا). تقول PHP March 2 (تفترض 30 يومًا). الحقيقة هي أنه لا توجد إجابة صحيحة. في وحدة Dates، تعطي النتيجة 28 فبراير. كيف تكتشف ذلك؟ اعتبر لعبة القمار الكلاسيكية 7-7-7 في الكازينوهات.

الآن تخيل فقط أنه بدلاً من 7-7-7، فإن الفتحات هي السنة-الشهر-اليوم، أو في مثالنا، 2014-01-31. عندما تطلب إضافة شهر واحد إلى هذا التاريخ، يتم زيادة خانة الشهر، لذا لدينا الآن 2014-02-31. ثم يتم التحقق من رقم اليوم إذا كان أكبر من آخر يوم صالح في الشهر الجديد؛ إذا كان كذلك (كما في الحالة أعلاه)، يتم تعديل رقم اليوم إلى آخر يوم صالح (28). ما هي العواقب مع هذا النهج؟ تابع وأضف شهرًا آخر إلى تاريخنا، 2014-02-28 + Month(1) == 2014-03-28. ماذا؟ هل كنت تتوقع آخر يوم من مارس؟ لا، آسف، تذكر الفتحات 7-7-7. أقل عدد ممكن من الفتحات سيتغير، لذا نقوم أولاً بزيادة خانة الشهر بمقدار 1، 2014-03-28، وبوم، نحن انتهينا لأن هذا تاريخ صالح. من ناحية أخرى، إذا كنا سنضيف شهرين إلى تاريخنا الأصلي، 2014-01-31، فإننا ننتهي بـ 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

ما الذي يحدث هناك؟ في السطر الأول، نحن نضيف يومًا واحدًا إلى 29 يناير، مما يؤدي إلى 2014-01-30؛ ثم نضيف شهرًا واحدًا، لذا نحصل على 2014-02-30، والذي يتم تعديله إلى 2014-02-28. في المثال الثاني، نضيف شهرًا واحدًا أولاً، حيث نحصل على 2014-02-29، والذي يتم تعديله إلى 2014-02-28، و ثم نضيف يومًا واحدًا، مما يؤدي إلى 2014-03-01. مبدأ تصميم واحد يساعد في هذه الحالة هو أنه، في وجود فترات متعددة، سيتم ترتيب العمليات حسب أنواع الفترات، وليس حسب قيمتها أو ترتيبها الموضعي؛ وهذا يعني أن 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

بقدر ما تكون حسابات فترات التواريخ مريحة، غالبًا ما تأخذ أنواع الحسابات المطلوبة على التواريخ طابعًا تقويميًا أو زمانيًا بدلاً من عدد ثابت من الفترات. العطلات هي مثال مثالي؛ حيث تتبع معظمها قواعد مثل "يوم الذكرى = آخر يوم اثنين من مايو"، أو "عيد الشكر = الخميس الرابع من نوفمبر". تتعامل هذه الأنواع من التعبيرات الزمنية مع قواعد تتعلق بالتقويم، مثل الأول أو الأخير من الشهر، الثلاثاء المقبل، أو الأربعاء الأول والثالث، إلخ.

يوفر نموذج Dates واجهة برمجة التطبيقات المعدل من خلال عدة طرق ملائمة تساعد في التعبير ببساطة واختصار عن القواعد الزمنية. تتعامل المجموعة الأولى من طرق المعدل مع الأول والأخير من الأسابيع، الأشهر، الأرباع، والسنوات. تأخذ كل منها مدخلًا واحدًا 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

الطرق الأعلى ترتيبًا التالية، 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-block للتعبيرات الزمنية الأكثر تعقيدًا:

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

الفترات هي وجهة نظر إنسانية لفترات زمنية منفصلة، وأحيانًا غير منتظمة. اعتبر شهرًا واحدًا؛ يمكن أن يمثل، بالأيام، قيمة 28 أو 29 أو 30 أو 31 اعتمادًا على سياق السنة والشهر. أو يمكن أن تمثل السنة 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. هذا مفيد بشكل خاص لتحويل مدة، على سبيل المثال، فرق بين تاريخين 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 يمكن تقريبهما إلى دقة محددة (مثل، شهر واحد أو 15 دقيقة) مع floor، ceil، أو round:

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 هو أنه بعد 17,676,660 ساعة من 0000-01-01T00:00:00، و17,676,660 قابلة للقسمة على 10.

كما تم تمثيل قيم جوليا Date و DateTime وفقًا لمعيار ISO 8601، تم اختيار 0000-01-01T00:00:00 كقاعدة (أو "عصر التقريب") التي تبدأ منها حساب الأيام (والميلي ثانية) المستخدمة في حسابات التقريب. (لاحظ أن هذا يختلف قليلاً عن التمثيل الداخلي لجوليا لـ 4d61726b646f776e2e436f64652822222c2022446174652229_40726566 باستخدام Rata Die notation؛ ولكن نظرًا لأن معيار ISO 8601 هو الأكثر وضوحًا للمستخدم النهائي، تم اختيار 0000-01-01T00:00:00 كعصر التقريب بدلاً من 0000-12-31T00:00:00 المستخدم داخليًا لتقليل الارتباك.)

الاستثناء الوحيد لاستخدام 0000-01-01T00:00:00 كعصر تقريب هو عند التقريب إلى الأسابيع. سيؤدي التقريب إلى أقرب أسبوع دائمًا إلى يوم الاثنين (أول يوم في الأسبوع كما هو محدد بواسطة ISO 8601). لهذا السبب، نستخدم 0000-01-03T00:00:00 (أول يوم من الأسبوع الأول من السنة 0000، كما هو محدد بواسطة ISO 8601) كقاعدة عند التقريب إلى عدد من الأسابيع.

هنا حالة ذات صلة حيث لا يكون السلوك المتوقع واضحًا بالضرورة: ماذا يحدث عندما نقوم بالتقريب إلى أقرب P(2)، حيث P هو نوع Period؟ في بعض الحالات (على وجه التحديد، عندما يكون 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

يبدو أن هذا واضح، لأن اثنين من كل من هذه الفترات لا يزال يقسم بالتساوي إلى الفترة الأكبر التالية. ولكن في حالة الشهرين (التي لا تزال تقسم بالتساوي إلى سنة واحدة)، قد تكون الإجابة مفاجئة:

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 إلى مضاعف زوجي من الأشهر سيؤدي إلى أن يحتوي حقل الأشهر على قيمة فردية. نظرًا لأن الأشهر والسنوات قد تحتوي على عدد غير منتظم من الأيام، فإن ما إذا كان التقريب إلى عدد زوجي من الأيام سيؤدي إلى قيمة زوجية في حقل الأيام غير مؤكد.

انظر إلى API reference لمزيد من المعلومات حول الطرق المصدرة من وحدة Dates.

API reference

Dates and Time Types

Dates.Period — Type

فترة
سنة
ربع
شهر
أسبوع
يوم
ساعة
دقيقة
ثانية
مللي ثانية
ميكرو ثانية
نانوسكند

Period types represent discrete, human representations of time.

الرمز	الأمثلة	التعليق
`y`	6	السنة الرقمية بعرض ثابت
`Y`	1996	السنة الرقمية بعرض أدنى
`m`	1, 12	الشهر الرقمي بعرض أدنى
`u`	Jan	اسم الشهر مختصر إلى 3 أحرف وفقًا لـ `locale`
`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	نفس `Y` عند `parse` ولكن يتجاهل الأرقام الزائدة عند `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