کتابخانه‌ی استاندارد · زمان و همروندی

زمان time

ساعت فعلی، مدت، قالب‌بندی و خواندن تاریخ، ساعت یکنواخت، زمان‌سنج و تیک‌زن.

واردسازی زمان

نام آرگومان‌ها شناسه‌ی خود کد است و معادل فارسی ندارد؛ گونه‌ها، کلیدواژه‌ها و نام بسته‌ها با معادل فارسی نوشته می‌شوند.

بسته‌ی زمان ساعت را می‌خواند، تاریخ را به متن و متن را به تاریخ تبدیل می‌کند، حساب تاریخ انجام می‌دهد، مدت اجرای کد را می‌سنجد و صبر می‌کند. با دو جور مقدار کار می‌کند:

  • لحظه عددی از نوع صحیح۶۴ است: ثانیه‌های گذشته از آغاز ۱۹۷۰ به وقت جهانی (مبدأ یونیکس). اکنون یک لحظه برمی‌گرداند و تاریخ‌ها به شکل لحظه ذخیره، مقایسه و فرستاده می‌شوند.
  • مدت یک مدت است: فاصله‌ای با دقت نانوثانیه، مثل 1h30m، که می‌شود جمع و مقایسه و چاپش کرد.

دو ساعت هم در کار است. ساعت دیواری (اکنون، اکنون میلی ثانیه) تاریخ را می‌گوید و وقتی ساعت سیستم تنظیم شود ممکن است بپرد. ساعت یکنواخت (نانوثانیه یکنواخت) فقط جلو می‌رود و برای سنجیدن مدت و مهلت به کار می‌رود؛ زمان‌سنج‌ها و تیک‌زن‌ها همین را به کار می‌برند.

برای تقویم شمسی و قمری و منطقه‌های زمانی نام‌دار مثل Asia/Tehran، بسته‌ی تقویم را ببینید. برای زمان‌سنجی بخش‌های برنامه هنگام اشکال‌زدایی، اشکال زدایی زمان‌سنج‌های نام‌دار دارد.

اشتباه‌های رایج:

  • سال، قالب تاریخ، قالب بندی، قالب ایزو و روز هفته منطقه‌ی زمانی محلی دستگاه را به کار می‌برند؛ پس یک لحظه روی سروری با وقت جهانی و لپ‌تاپی در تهران دو جور چاپ می‌شود. برای هر چیزی که ذخیره یا مقایسه می‌شود، تابع‌های جهانی و قالب ایزو جهانی را به کار ببرید.
  • قالب ایزو اختلاف منطقه ندارد، پس متنش روی دستگاه دیگری به همان لحظه برنمی‌گردد. قالب ایزو جهانی یا قالب آر‌اف‌سی۳۳۳۹ را بفرستید.
  • روزها(۳۰) یعنی ۳۰ بار ۲۴ ساعت، نه یک ماه. حساب ماه در کار نیست؛ تاریخ را با از اجزای جهانی و یک ماه بیشتر بسازید (ماه ۱۳ به ژانویه‌ی سال بعد می‌رود).
  • از اجزای جهانی و از اجزای محلی هر عددی را می‌پذیرند و سرریزش را به بعد می‌برند: ۳۰ فوریه می‌شود ۱ مارس. تابع‌های تجزیه، برعکس، برای روزی که در آن ماه نیست خطا پرتاب می‌کنند.
  • سنجیدن زمان اجرا با اکنون. این تابع ثانیه‌ی کامل می‌دهد و با تغییر ساعت جابه‌جا می‌شود؛ نانوثانیه یکنواخت را به کار ببرید.

تاریخ از متن، و حساب تاریخ

تاریخ‌ها معمولاً به شکل متن می‌رسند: از JSON، پایگاه داده یا یک فرم. تجزیه ایزو شکل ISO 8601 را می‌خواند و لحظه را برمی‌گرداند. ورودی نادرست زیاد پیش می‌آید، پس این تابع خطادار است: خطا را با تلاش: ... گرفتن خطا خ: بگیرید و مقدار را گزارش کنید یا از آن بگذرید. وقتی لحظه را داشتید، حسابش یک حساب ساده‌ی عدد صحیح است: افزودن مدت آن را جابه‌جا می‌کند و اختلاف ثانیه فاصله‌ی دو لحظه را می‌دهد.

time-guide-expiry.salam
واردسازی زمان
واردسازی رشته

تابع روزهای باقی‌مانده(انقضا: صحیح۶۴، امروز: صحیح۶۴): صحیح۶۴:
    برگشت زمان.اختلاف ثانیه(انقضا، امروز) / زمان.ثانیه در روز
پایان

تابع ریشه:
    امروز := زمان.از اجزای جهانی(۲۰۲۶، ۳، ۱۰، ۹، ۰، ۰)
    ثبت‌نام‌ها := ["2026-01-15T08:30:00Z"، "2026-02-20T18:45:00Z"، "2026-03-09T23:10:00Z"، "تاریخ نیست"]
    هر ث در ثبت‌نام‌ها:
        ناپایا ت := ۰ برگردان صحیح۶۴
        تلاش:
            ت = زمان.تجزیه ایزو(ث)
        گرفتن خطا خ:
            سرچاپ "رد کردن \"" + ث + "\":"، خ.پیام
            گذر
        پایان
        انقضا := زمان.افزودن مدت(ت، زمان.روزها(۳۰))
        مانده := روزهای باقی‌مانده(انقضا، امروز)
        اگر مانده < ۰:
            سرچاپ زمان.قالب ایزو جهانی(ت)، "منقضی شده،"، -مانده، "روز پیش"
        وگرنه:
            سرچاپ زمان.قالب ایزو جهانی(ت)، "پایان در"، زمان.قالب ایزو جهانی(انقضا)، "(" + رشته.از عدد(مانده) + " روز مانده)"
        پایان
    پایان
پایان
خروجی2026-01-15T08:30:00Z منقضی شده، 24 روز پیش 2026-02-20T18:45:00Z پایان در 2026-03-22T18:45:00Z (12 روز مانده) 2026-03-09T23:10:00Z پایان در 2026-04-08T23:10:00Z (29 روز مانده) رد کردن "تاریخ نیست": expected a digit in the year, found 'ت'

این نمونه «امروز» را با از اجزای جهانی ثابت می‌کند تا خروجی‌اش هرگز عوض نشود؛ برنامه‌ی واقعی از اکنون() استفاده می‌کند. افزودن روزها(۳۰) دقیقاً ۳۰ بار ۲۴ ساعت می‌افزاید. در UTC این همیشه ۳۰ روز تقویمی است، اما در منطقه‌ای با ساعت تابستانی ساعت محلی ممکن است یک ساعت جابه‌جا شود؛ پس لحظه‌های ذخیره‌شده را به UTC نگه دارید و فقط برای نمایش تبدیل کنید.

مهلت‌ها از تنظیمات

تنظیمی مثل timeout = 1m30s از یک عدد میلی‌ثانیه خواناتر است. تجزیه مدت واحدهای h، m، s، ms، us و ns را با هر ترکیبی و با کسر می‌فهمد. برای متنی که نمی‌تواند بخواند خطا پرتاب می‌کند و پیام خطا دلیلش را می‌گوید. مقدار را با مرزهای معقول هم بسنجید: تجزیه‌ای که موفق شده هنوز مقداری نیست که معنا داشته باشد.

time-guide-timeouts.salam
واردسازی زمان

تابع خواندن مهلت(نام: رشته، متن: رشته، پیش‌فرض: زمان.مدت): زمان.مدت:
    ناپایا ت := پیش‌فرض
    تلاش:
        ت = زمان.تجزیه مدت(متن)
    گرفتن خطا خ:
        سرچاپ نام + ": خوانده نشد"، "\"" + متن + "\" (" + خ.پیام + ")، به‌جای آن"، پیش‌فرض.به رشته()
        برگشت پیش‌فرض
    پایان
    اگر ت.کمتر(زمان.میلی‌ثانیه‌ها(۱۰۰)) یا زمان.دقیقه‌ها(۱۰).کمتر(ت):
        سرچاپ نام + ":"، ت.به رشته()، "بیرون از بازه است، به‌جای آن"، پیش‌فرض.به رشته()
        برگشت پیش‌فرض
    پایان
    سرچاپ نام + ":"، ت.به رشته()
    برگشت ت
پایان

تابع ریشه:
    اتصال := خواندن مهلت("اتصال"، "2.5s"، زمان.ثانیه‌ها(۵))
    درخواست := خواندن مهلت("درخواست"، "1m30s"، زمان.ثانیه‌ها(۳۰))
    کوشش دوباره := خواندن مهلت("تلاش دوباره"، "به‌زودی"، زمان.ثانیه‌ها(۱))
    بیکاری := خواندن مهلت("بیکاری"، "2h"، زمان.دقیقه‌ها(۵))
    بدترین := اتصال.جمع(درخواست.ضرب(۳)).جمع(کوشش دوباره.ضرب(۲))
    سرچاپ "بدترین حالت برای سه تلاش:"، بدترین.به رشته()
    سرچاپ "بیکاری به میلی‌ثانیه:"، بیکاری.میلی‌ثانیه()
پایان
خروجیاتصال: 2.5s درخواست: 1m30s تلاش دوباره: خوانده نشد "به‌زودی" (expected a number, found 'ب')، به‌جای آن 1s بیکاری: 2h0m0s بیرون از بازه است، به‌جای آن 5m0s بدترین حالت برای سه تلاش: 4m34.5s بیکاری به میلی‌ثانیه: 300000

مدت‌ها بی هیچ تبدیل واحدی جمع، تفریق، ضرب و مقایسه می‌شوند و به رشته آن‌ها را به همان شکل کوتاهی چاپ می‌کند که تجزیه مدت می‌خواند. وقتی یک پیش‌فرض سریع کافی است، تجزیه مدت با پیش فرض تجزیه و جایگزین را در یک فراخوانی انجام می‌دهد.

وقتی متن تاریخ نیست

تجزیه ایزو، تجزیه ایزو نانوثانیه، تجزیه ایزو در، تجزیه تاریخ اچ‌تی‌تی‌پی، تجزیه با قالب و تجزیه مدت یا مقداری برمی‌گردانند یا یک خطا پرتاب می‌کنند؛ هیچ چیز نیمه‌خوانده‌ای برنمی‌گردد. خ.نوع حالت‌ها را از هم جدا می‌کند: نحو برای نویسه‌ای که جور نیست، مثل خط مورب به‌جای خط تیره یا حرف در جای سال، اتمام ناگهانی برای متنی که زود تمام می‌شود، و خارج از بازه برای بخشی که بیش از اندازه است، مثل ماه ۱۳، ساعت ۲۵، ۳۰ فوریه یا مدتی بلندتر از حدود ۲۹۲ سال. خ.جایگاه و خ.ستون جای مشکل را نشان می‌دهند و خ.کد یکی از time.syntax، time.unexpected_end، time.empty، time.trailing، time.bad_month، time.bad_day، time.bad_hour، time.bad_minute، time.bad_second، time.bad_offset، time.bad_month_name، time.layout_mismatch، time.bad_unit، time.missing_unit یا time.overflow است. الگویی که تجزیه با قالب نمی‌فهمد اشتباه فراخواننده است و آرگومان نامعتبر با کد time.bad_layout پرتاب می‌کند. وقتی یک پیش‌فرض کافی است، تجزیه ایزو با پیش فرض و تجزیه مدت با پیش فرض هرگز خطا پرتاب نمی‌کنند؛ برای بقیه خطا را بگیرید و پیش‌فرض خودتان را به کار ببرید.

اجرای بعدی یک کار روزانه

لحظه تعداد ثانیه‌ها از ۱۹۷۰ به UTC است، پس آغاز روز UTC آن t - t % ثانیه در روز است و بقیه‌اش ساعت روز. همین برای این‌که بفهمید کاری که هر شب ساعت ۰۲:۳۰ به UTC اجرا می‌شود دفعه‌ی بعد کی اجرا شود کافی است.

time-guide-schedule.salam
واردسازی زمان

تابع نام روز هفته(لحظه: صحیح۶۴): رشته:
    نام‌ها := ["پنجشنبه"، "جمعه"، "شنبه"، "یکشنبه"، "دوشنبه"، "سه‌شنبه"، "چهارشنبه"]
    برگشت نام‌ها[(لحظه / زمان.ثانیه در روز) % ۷]
پایان

تابع اجرای بعدی(پس از: صحیح۶۴، ساعت: صحیح، دقیقه: صحیح): صحیح۶۴:
    آغاز روز := پس از - پس از % زمان.ثانیه در روز
    ناپایا اجرا := آغاز روز + (ساعت برگردان صحیح۶۴) * زمان.ثانیه در ساعت + (دقیقه برگردان صحیح۶۴) * زمان.ثانیه در دقیقه
    اگر اجرا <= پس از:
        اجرا += زمان.ثانیه در روز
    پایان
    برگشت اجرا
پایان

تابع ریشه:
    ناپایا ز := زمان.از اجزای جهانی(۲۰۲۶، ۱۰، ۱۶، ۱۴، ۲۰، ۰)
    سرچاپ "اکنون:"، نام روز هفته(ز)، زمان.قالب ایزو جهانی(ز)
    تکرار ۳:
        ز = اجرای بعدی(ز، ۲، ۳۰)
        سرچاپ "پشتیبان‌گیری:"، نام روز هفته(ز)، زمان.قالب ایزو جهانی(ز)
    پایان
    سرچاپ "شکل HTTP:"، زمان.قالب تاریخ اچ‌تی‌تی‌پی(ز)
پایان
خروجیاکنون: جمعه 2026-10-16T14:20:00Z پشتیبان‌گیری: شنبه 2026-10-17T02:30:00Z پشتیبان‌گیری: یکشنبه 2026-10-18T02:30:00Z پشتیبان‌گیری: دوشنبه 2026-10-19T02:30:00Z شکل HTTP: Mon, 19 Oct 2026 02:30:00 GMT

اول ژانویه‌ی ۱۹۷۰ پنجشنبه بود، برای همین جدول روزهای هفته از پنجشنبه شروع می‌شود. روز هفته همین پاسخ را برای ساعت محلی دستگاه می‌دهد. قالب تاریخ اچ‌تی‌تی‌پی شکلی است که سرآیندهای HTTP مثل Last-Modified و Expires لازم دارند.

ضربان، مهلت و صبر برای یک شرط

تیک‌زن در فاصله‌های ثابت تیک می‌زند: انتظار تا تیک بعدی می‌خوابد، و اگر برنامه دیر برگردد، تیک‌های جاافتاده را یک‌جا نمی‌زند بلکه از رویشان می‌گذرد و در dropped می‌شماردشان. زمان‌سنج یک مهلت تکی است که با منقضی شده بررسی‌اش می‌کنید؛ این‌جا سقفی برای کل حلقه است. صبر برای شرطی را هر poll یک بار بررسی می‌کند تا درست شود یا limit تمام شود؛ این راه معمول صبر کردن برای بالا آمدن یک سرور یا پیدا شدن یک پرونده است.

time-guide-ticker.salam
واردسازی زمان

تابع ریشه:
    ناپایا تیک‌زن := زمان.تیک‌زن جدید(زمان.میلی‌ثانیه‌ها(۲۰))
    ناپایا مهلت := زمان.زمان‌سنج جدید(زمان.میلی‌ثانیه‌ها(۵۰۰))
    ناپایا ضربان‌ها := ۰
    تا ضربان‌ها < ۵ و وارونه مهلت.منقضی شده():
        تیک‌زن.انتظار()
        ضربان‌ها++
        سرچاپ "ضربان"، ضربان‌ها
    پایان
    تیک‌زن.توقف()
    سرچاپ "مهلت گذشت:"، مهلت.منقضی شده()
    شروع := زمان.نانوثانیه یکنواخت()
    آماده := زمان.صبر برای(():
        برگشت زمان.مدت از(شروع).میلی‌ثانیه() >= ۳۰
    پایان، زمان.میلی‌ثانیه‌ها(۵)، زمان.ثانیه‌ها(۱))
    سرچاپ "حافظه‌ی نهان گرم شد:"، آماده
    بالا آمد := زمان.صبر برای((): برگشت نادرست پایان، زمان.میلی‌ثانیه‌ها(۵)، زمان.میلی‌ثانیه‌ها(۲۰))
    سرچاپ "سرور بالا آمد:"، بالا آمد
پایان
خروجیضربان 1 ضربان 2 ضربان 3 ضربان 4 ضربان 5 مهلت گذشت: false حافظه‌ی نهان گرم شد: true سرور بالا آمد: false

همه‌ی این‌ها روی نخ فراخواننده اجرا می‌شوند و آن را نگه می‌دارند. برای انجام کارهای دیگر میان تیک‌ها، به‌جای انتظار در حلقه‌تان رخ داده را صدا بزنید؛ برای اجرای واقعی در پس‌زمینه، یک نخ راه بیندازید.

اندازه‌گیری زمان اجرای کد

پیش از کار نانوثانیه یکنواخت را بگیرید و پس از آن به مدت از بدهید. ساعت یکنواخت فقط جلو می‌رود، پس حتی اگر ساعت سیستم وسط اجرا عوض شود نتیجه درست است؛ اکنون برای تاریخ است، نه زمان‌سنجی.

time-guide-measure.salam
واردسازی زمان

تابع فیبوناچی(ع: صحیح): صحیح۶۴:
    اگر ع < ۲:
        برگشت ع
    پایان
    برگشت فیبوناچی(ع - ۱) + فیبوناچی(ع - ۲)
پایان

تابع ریشه:
    آغاز := زمان.نانوثانیه یکنواخت()
    نتیجه := فیبوناچی(۲۷)
    مدت := زمان.مدت از(آغاز)
    سرچاپ "فیبوناچی(۲۷) ="، نتیجه
    سرچاپ "چیزی اندازه گرفته شد:"، وارونه مدت.منفی است()
    سرچاپ "کمتر از ده ثانیه:"، مدت.کمتر(زمان.ثانیه‌ها(۱۰))
    بودجه := زمان.ثانیه‌ها(۵)
    اگر بودجه.کمتر(مدت):
        سرچاپ "کندتر از بودجه‌ی"، بودجه.به رشته()
    وگرنه:
        سرچاپ "در بودجه‌ی"، بودجه.به رشته()
    پایان
پایان
خروجیفیبوناچی(۲۷) = 196418 چیزی اندازه گرفته شد: true کمتر از ده ثانیه: true در بودجه‌ی 5s

این نمونه فقط مقایسه‌ها را چاپ می‌کند، چون زمان اندازه‌گیری‌شده در هر اجرا فرق دارد. برای پیدا کردن بخش کند یک برنامه‌ی بزرگ‌تر، بسته‌ی اشکال زدایی زمان‌سنج‌های نام‌داری دارد که روی همین ساعت ساخته شده‌اند.

کدام تابع برای کدام کار

کاراز این استفاده کنید
لحظه‌ی کنونیاکنون
لحظه از روی اجزااز اجزای جهانی، یا از اجزای محلی برای ساعت محلی
خواندن تاریخ از متنتجزیه ایزو، تجزیه تاریخ اچ‌تی‌تی‌پی، تجزیه با قالب
نوشتن تاریخ برای ماشینقالب ایزو جهانی، قالب آر‌اف‌سی۳۳۳۹، قالب تاریخ اچ‌تی‌تی‌پی
نوشتن تاریخ برای آدم‌هاقالب تاریخ، قالب ساعت، قالب بندی
جابه‌جا کردن لحظه یا سنجیدن فاصلهافزودن مدت، اختلاف ثانیه، مدت بین
زمان‌سنجی یک تکه کدنانوثانیه یکنواخت با مدت از
صبر کردن یا تکرارخواب، خواب به مدت، زمان‌سنج جدید، تیک‌زن جدید، تکرار با فاصله، صبر برای
تاریخ جلالی یا قمری، منطقه‌ی زمانیتقویم

گونه‌ها

زمان‌سنج Timer

ساختار زمان‌سنج
زمان‌سنج یک‌باره: می‌گوید مدتی که تعیین کرده‌اید گذشته یا نه.
نامانگلیسیگونهتوضیح
مهلتdeadline_nsصحیح۶۴ = 0لحظه‌ی پایان روی ساعت یکنواخت، بر حسب نانوثانیه.
فعالactiveمنطقی = نادرستآیا زمان‌سنج فعال است.
time-Timer.salam
واردسازی زمان

ناپایا شمار := ۰

تابع ریشه:
    ناپایا ز := زمان.زمان‌سنج جدید(زمان.میلی‌ثانیه‌ها(۱۰۰))
    سرچاپ ز.منقضی شده()، ز.باقی‌مانده().میلی‌ثانیه() > ۰
    ز.انتظار()
    سرچاپ ز.منقضی شده()، ز.باقی‌مانده().صفر است()
    ز.بازنشانی(زمان.ثانیه‌ها(۱۰))
    ز.توقف()
    سرچاپ ز.منقضی شده()، ز.فعال
    ناپایا ت := زمان.تیک‌زن جدید(زمان.میلی‌ثانیه‌ها(۵۰))
    سرچاپ ت.رخ داده()
    ت.انتظار()
    زمان.خواب(۱۲۰)
    سرچاپ ت.رخ داده()، ت.از دست رفته >= ۱
    ت.پیشروی()
    سرچاپ ت.باقی‌مانده().میلی‌ثانیه() <= ۱۰۰
    ت.بازنشانی(زمان.میلی‌ثانیه‌ها(۵))
    ت.توقف()
    سرچاپ ت.رخ داده()
    زمان.پس از(زمان.میلی‌ثانیه‌ها(۱۰)، (): سرچاپ "پس از ۱۰ میلی‌ثانیه" پایان)
    زمان.تکرار با فاصله(زمان.میلی‌ثانیه‌ها(۵)، ۲، (): سرچاپ "تیک" پایان)
    سرچاپ زمان.هر(زمان.میلی‌ثانیه‌ها(۵)، (): شمار++ برگشت شمار < ۳ پایان)
    شمار = ۰
    سرچاپ زمان.صبر برای((): شمار++ برگشت شمار >= ۳ پایان، زمان.میلی‌ثانیه‌ها(۵)، زمان.ثانیه‌ها(۵))
    سرچاپ زمان.صبر برای((): برگشت نادرست پایان، زمان.میلی‌ثانیه‌ها(۵)، زمان.میلی‌ثانیه‌ها(۲۰))
پایان
خروجیfalse true true true false false false true true true false پس از ۱۰ میلی‌ثانیه تیک تیک 3 true false

منقضی شده Expired

تابع منقضی شده(): منطقی

منقضی شده expired

تابع منقضی شده(): منطقی
اگر زمان‌سنج فعال باشد و مدتش گذشته باشد، درست برمی‌گرداند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: time-Timer.salam

باقی‌مانده Remaining

تابع باقی‌مانده(): مدت

باقی‌مانده remaining

تابع باقی‌مانده(): مدت
زمان باقیمانده؛ اگر گذشته یا متوقف شده باشد، صفر.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: time-Timer.salam

انتظار Wait

تابع انتظار()

انتظار wait

تابع انتظار()
تا پایان مدت می‌خوابد.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: time-Timer.salam

بازنشانی Reset

تابع بازنشانی(d: مدت)

بازنشانی reset

تابع بازنشانی(d: مدت)
زمان‌سنج را از همین لحظه برای مدت تازه فعال می‌کند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: time-Timer.salam

توقف Stop

تابع توقف()

توقف stop

تابع توقف()
زمان‌سنج را متوقف می‌کند؛ از این پس هیچ‌وقت منقضی نمی‌شود.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: time-Timer.salam

تیک‌زن Ticker

ساختار تیک‌زن
تیک‌زن: در فاصله‌های مساوی «تیک» می‌زند.
نامانگلیسیگونهتوضیح
بازهinterval_nsصحیح۶۴ = 0فاصله‌ی تیک‌ها بر حسب نانوثانیه.
بعدیnext_nsصحیح۶۴ = 0لحظه‌ی تیک بعدی.
فعالactiveمنطقی = نادرستآیا تیک‌زن فعال است.
از دست رفتهdroppedصحیح۶۴ = 0تعداد تیک‌هایی که از دست رفته‌اند، چون برنامه دیرتر از موعد سراغ تیک‌زن آمده.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: time-Timer.salam

رخ داده Fired

تابع رخ داده(): منطقی

رخ داده fired

تابع رخ داده(): منطقی
اگر موعد تیک رسیده باشد، درست برمی‌گرداند و به تیک بعد می‌رود؛ منتظر نمی‌ماند. برای حلقه‌هایی که کار دیگری هم دارند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: time-Timer.salam

انتظار Wait

تابع انتظار()

انتظار wait

تابع انتظار()
تا تیک بعدی می‌خوابد.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: time-Timer.salam

پیشروی Advance

تابع پیشروی()

پیشروی advance

تابع پیشروی()
موعد را یک تیک جلو می‌برد؛ تیک‌های از دست رفته را می‌شمارد و رد می‌کند تا تیک‌زن عقب نماند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: time-Timer.salam

باقی‌مانده Remaining

تابع باقی‌مانده(): مدت

باقی‌مانده remaining

تابع باقی‌مانده(): مدت
زمان مانده تا تیک بعدی.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: time-Timer.salam

بازنشانی Reset

تابع بازنشانی(d: مدت)

بازنشانی reset

تابع بازنشانی(d: مدت)
فاصله را عوض می‌کند و از همین لحظه دوباره شروع می‌کند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: time-Timer.salam

توقف Stop

تابع توقف()

توقف stop

تابع توقف()
تیک‌زن را متوقف می‌کند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: time-Timer.salam

تاریخ زمان DateTime

ساختار تاریخ زمان
یک لحظه به صورت ثانیه‌های گذشته از مبدأ یونیکس (آغاز ۱ ژانویه‌ی ۱۹۷۰ به وقت جهانی).
نامانگلیسیگونهتوضیح
ثانیه مبداepochصحیح۶۴ = 0ثانیه‌های گذشته از مبدأ یونیکس.
time-Local.salam
واردسازی زمان
واردسازی رشته

تابع ریشه:
    ت := زمان.از اجزای محلی(۲۰۲۴، ۳، ۲۰، ۹، ۳۰، ۰)
    سرچاپ زمان.سال(ت)، زمان.ماه(ت)، زمان.روز(ت)، زمان.ساعت(ت)، زمان.دقیقه(ت)، زمان.ثانیه(ت)
    سرچاپ زمان.روز هفته(ت)، زمان.روز سال(ت)
    سرچاپ زمان.قالب تاریخ(ت)، زمان.قالب ساعت(ت)
    سرچاپ زمان.قالب بندی(ت)
    سرچاپ زمان.قالب ایزو(ت)
    ر := زمان.قالب آر‌اف‌سی۳۳۳۹(ت)
    اختلاف := زمان.اختلاف محلی در(ت)
    سرچاپ رشته.شروع با(ر، "2024-03-20T09:30:00")، (اختلاف == ۰) == رشته.پایان با(ر، "Z")
    ز := زمان.از مبدا(ت)
    سرچاپ زمان.مبدا(ز) == ت، ز.ثانیه مبدا == ت
    سرچاپ زمان.مبدا(زمان.تاریخ زمان اکنون()) >= ت
پایان
خروجی2024 3 20 9 30 0 3 80 2024-03-20 09:30:00 2024-03-20 09:30:00 2024-03-20T09:30:00 true true true true true

مدت Duration

ساختار مدت
یک مدت زمان با دقت نانوثانیه؛ می‌تواند منفی باشد.
نامانگلیسیگونهتوضیح
نانوثانیه خامnsصحیح۶۴ = 0مدت بر حسب نانوثانیه.
time-Duration.salam
واردسازی زمان

تابع ریشه خطادار:
    د := زمان.ساعت‌ها(۱).جمع(زمان.دقیقه‌ها(۳۰))
    سرچاپ د.به رشته()، د.دقیقه()، د.ثانیه‌های کامل()
    سرچاپ زمان.قالب مدت(زمان.میلی‌ثانیه‌ها(۱۵۰۰))، زمان.قالب مدت(زمان.میکروثانیه‌ها(۲۵۰))، زمان.قالب مدت(زمان.نانوثانیه‌ها(۴۲))
    سرچاپ زمان.ثانیه‌ها(۹۰).به رشته()، زمان.روزها(۲).ساعت()، زمان.ثانیه اعشاری(۰.۲۵).میلی‌ثانیه()
    ن := تلاش زمان.تجزیه مدت("1h15m30.5s")
    سرچاپ ن.به رشته()، ن.ثانیه()
    تلاش:
        سرچاپ زمان.تجزیه مدت("ده دقیقه").به رشته()
    گرفتن خطا خ:
        سرچاپ خ.نام نوع()، خ.کد، خ.جایگاه
    پایان
    سرچاپ زمان.تجزیه مدت با پیش فرض("?"، زمان.ثانیه‌ها(۵)).به رشته()
    ک := زمان.دقیقه‌ها(۷)
    سرچاپ ک.تفریق(زمان.دقیقه‌ها(۱۰)).به رشته()، ک.منفی().قدرمطلق().به رشته()، ک.منفی().منفی است()
    سرچاپ ک.ضرب(۳).به رشته()، ک.تقسیم(۲).به رشته()، زمان.ساعت‌ها(۱).نسبت(ک)
    سرچاپ ک.مقایسه(زمان.ثانیه‌ها(۴۲۰))، ک.کمتر(زمان.ساعت‌ها(۱))، ک.یکسان(زمان.ثانیه‌ها(۴۲۰))
    ت := زمان.میلی‌ثانیه‌ها(۱۷۵۰)
    سرچاپ ت.برش(زمان.ثانیه‌ها(۱)).به رشته()، ت.گرد کردن(زمان.ثانیه‌ها(۱)).به رشته()
    سرچاپ ت.نانوثانیه()، ت.میکروثانیه()، ت.میلی‌ثانیه()، زمان.مدت صفر().صفر است()، ت.روز() < ۰.۰۰۱
پایان
خروجی1h30m0s 90 5400 1.5s 250us 42ns 1m30s 48 250 1h15m30.5s 4530.5 syntax error time.syntax 0 5s -3m0s 7m0s true 21m0s 3m30s 8 0 true true 1s 2s 1750000000 1750000 1750 true true

نانوثانیه Nanos

تابع نانوثانیه(): صحیح۶۴

نانوثانیه nanos

تابع نانوثانیه(): صحیح۶۴
مدت بر حسب نانوثانیه.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: time-Duration.salam

میکروثانیه Micros

تابع میکروثانیه(): صحیح۶۴

میکروثانیه micros

تابع میکروثانیه(): صحیح۶۴
مدت بر حسب میکروثانیه، بدون بخش اعشاری.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: time-Duration.salam

میلی‌ثانیه Millis

تابع میلی‌ثانیه(): صحیح۶۴

میلی‌ثانیه millis

تابع میلی‌ثانیه(): صحیح۶۴
مدت بر حسب میلی‌ثانیه، بدون بخش اعشاری.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: time-Duration.salam

ثانیه‌های کامل Secs

تابع ثانیه‌های کامل(): صحیح۶۴

ثانیه‌های کامل secs

تابع ثانیه‌های کامل(): صحیح۶۴
ثانیه‌های کامل، بدون بخش اعشاری.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: time-Duration.salam

ثانیه Seconds

تابع ثانیه(): اعشار۶۴

ثانیه seconds

تابع ثانیه(): اعشار۶۴
مدت بر حسب ثانیه، با اعشار.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: time-Duration.salam

دقیقه Minutes

تابع دقیقه(): اعشار۶۴

دقیقه minutes

تابع دقیقه(): اعشار۶۴
مدت بر حسب دقیقه، با اعشار.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: time-Duration.salam

ساعت Hours

تابع ساعت(): اعشار۶۴

ساعت hours

تابع ساعت(): اعشار۶۴
مدت بر حسب ساعت، با اعشار.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: time-Duration.salam

روز Days

تابع روز(): اعشار۶۴

روز days

تابع روز(): اعشار۶۴
مدت بر حسب روز، با اعشار.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: time-Duration.salam

جمع Add

تابع جمع(o: مدت): مدت

جمع add

تابع جمع(o: مدت): مدت
جمع دو مدت.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: time-Duration.salam

تفریق Sub

تابع تفریق(o: مدت): مدت

تفریق sub

تابع تفریق(o: مدت): مدت
تفاضل دو مدت.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: time-Duration.salam

ضرب Mul

تابع ضرب(k: صحیح۶۴): مدت

ضرب mul

تابع ضرب(k: صحیح۶۴): مدت
مدت را در عدد ضرب می‌کند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: time-Duration.salam

تقسیم Div

تابع تقسیم(k: صحیح۶۴): مدت

تقسیم div

تابع تقسیم(k: صحیح۶۴): مدت
مدت را بر عدد تقسیم می‌کند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: time-Duration.salam

نسبت Ratio

تابع نسبت(o: مدت): صحیح۶۴

نسبت ratio

تابع نسبت(o: مدت): صحیح۶۴
این مدت چند برابرِ کاملِ مدت دیگر است؛ اگر آن صفر باشد، صفر.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: time-Duration.salam

منفی Neg

تابع منفی(): مدت

منفی neg

تابع منفی(): مدت
قرینه‌ی مدت.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: time-Duration.salam

قدرمطلق Abs

تابع قدرمطلق(): مدت

قدرمطلق abs

تابع قدرمطلق(): مدت
قدر مطلق مدت.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: time-Duration.salam

صفر است IsZero

تابع صفر است(): منطقی

صفر است is_zero

تابع صفر است(): منطقی
اگر مدت صفر باشد، درست برمی‌گرداند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: time-Duration.salam

منفی است IsNegative

تابع منفی است(): منطقی

منفی است is_negative

تابع منفی است(): منطقی
اگر مدت منفی باشد، درست برمی‌گرداند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: time-Duration.salam

مقایسه Cmp

تابع مقایسه(o: مدت): صحیح

مقایسه cmp

تابع مقایسه(o: مدت): صحیح
مقایسه با مدت دیگر: ‎-1 اگر کوتاه‌تر باشد، صفر اگر برابر، ۱ اگر بلندتر.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: time-Duration.salam

کمتر Less

تابع کمتر(o: مدت): منطقی

کمتر less

تابع کمتر(o: مدت): منطقی
اگر از مدت دیگر کوتاه‌تر باشد، درست برمی‌گرداند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: time-Duration.salam

یکسان Equals

تابع یکسان(o: مدت): منطقی

یکسان equals

تابع یکسان(o: مدت): منطقی
اگر با مدت دیگر برابر باشد، درست برمی‌گرداند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: time-Duration.salam

برش Truncate

تابع برش(m: مدت): مدت

برش truncate

تابع برش(m: مدت): مدت
مدت را به پایین، تا مضربی از m، گرد می‌کند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: time-Duration.salam

گرد کردن Round

تابع گرد کردن(m: مدت): مدت

گرد کردن round

تابع گرد کردن(m: مدت): مدت
مدت را به نزدیک‌ترین مضرب m گرد می‌کند؛ نیمه‌ها از صفر دور می‌شوند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: time-Duration.salam

به رشته ToStr

تابع به رشته(): رشته

به رشته to_str

تابع به رشته(): رشته
مدت را مثل 1h30m0s می‌نویسد؛ همان قالب مدت.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: time-Duration.salam

پایاها و متغیرها

ثانیه در دقیقه SecondsPerMinute

پایا ثانیه در دقیقه: صحیح۳۲ = 60
تعداد ثانیه‌های یک دقیقه.
time-UTC.salam
واردسازی زمان

تابع ریشه خطادار:
    ت := زمان.از اجزای جهانی(۲۰۲۴، ۳، ۲۰، ۱۴، ۵، ۹)
    سرچاپ ت، زمان.قالب ایزو جهانی(ت)
    سرچاپ زمان.سال جهانی(ت)، زمان.ماه جهانی(ت)، زمان.روز جهانی(ت)، زمان.ساعت جهانی(ت)، زمان.دقیقه جهانی(ت)، زمان.ثانیه جهانی(ت)
    سرچاپ زمان.قالب تاریخ اچ‌تی‌تی‌پی(ت)
    سرچاپ تلاش زمان.تجزیه تاریخ اچ‌تی‌تی‌پی("Wed, 20 Mar 2024 14:05:09 GMT") == ت
    سرچاپ تلاش زمان.تجزیه ایزو("2024-03-20T17:35:09+03:30") == ت
    سرچاپ تلاش زمان.تجزیه ایزو در("2024-03-20 17:35:09.25"، ۲۱۰) == ت، تلاش زمان.تجزیه ایزو نانوثانیه("2024-03-20T14:05:09.25Z")
    ق := تلاش زمان.تجزیه با قالب("%d/%m/%Y %H:%M %z"، "20/03/2024 14:05 +0000")
    سرچاپ زمان.قالب ایزو جهانی(ق)
    تلاش:
        سرچاپ زمان.تجزیه ایزو("2024-02-30")
    گرفتن خطا خ:
        سرچاپ خ.نام نوع()، خ.کد، خ.ستون، خ.پیام
    پایان
    سرچاپ زمان.تجزیه ایزو با پیش فرض("فردا"، ۰)
    ب := زمان.افزودن مدت(ت، زمان.روزها(۱۰))
    سرچاپ زمان.قالب ایزو جهانی(ب)، زمان.اختلاف ثانیه(ب، ت)، زمان.مدت بین(ب، ت).به رشته()
    سرچاپ زمان.ثانیه در دقیقه، زمان.ثانیه در ساعت، زمان.ثانیه در روز
پایان
خروجی1710943509 2024-03-20T14:05:09Z 2024 3 20 14 5 9 Wed, 20 Mar 2024 14:05:09 GMT true true true 1710943509250000000 2024-03-20T14:05:00Z out of range time.bad_day 9 day 30 is out of range for month 2 of 2024 (1 to 29) 0 2024-03-30T14:05:09Z 864000 240h0m0s 60 3600 86400

ثانیه در ساعت SecondsPerHour

پایا ثانیه در ساعت: صحیح۳۲ = 3600
تعداد ثانیه‌های یک ساعت.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: time-UTC.salam

ثانیه در روز SecondsPerDay

پایا ثانیه در روز: صحیح۳۲ = 86400
تعداد ثانیه‌های یک روز.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: time-UTC.salam

تابع‌ها

زمان‌سنج جدید NewTimer

تابع زمان‌سنج جدید(d: مدت): زمان‌سنج
زمان‌سنجی که پس از مدت داده‌شده منقضی می‌شود.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: time-Timer.salam

تیک‌زن جدید NewTicker

تابع تیک‌زن جدید(d: مدت): تیک‌زن
تیک‌زن با فاصله‌ی داده‌شده؛ فاصله‌ی صفر یا منفی تیک‌زن غیرفعال می‌سازد.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: time-Timer.salam

پس از AfterFunc

تابع پس از(d: مدت، fn: تابع())
مدت داده‌شده صبر می‌کند و سپس تابع را اجرا می‌کند. این کار در همان نخ انجام می‌شود و تا پایان تابع برنمی‌گردد؛ پس یک خواب و سپس یک فراخوانی است، نه زمان‌سنجی در پس‌زمینه.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: time-Timer.salam

هر Every

تابع هر(d: مدت، fn: تابع(): منطقی): صحیح۶۴
تابع را در فاصله‌های مساوی اجرا می‌کند تا وقتی نادرست برگرداند؛ تعداد اجراها را برمی‌گرداند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: time-Timer.salam

تکرار با فاصله RepeatEvery

تابع تکرار با فاصله(d: مدت، count: صحیح، fn: تابع())
تابع را count بار با فاصله‌ی داده‌شده اجرا می‌کند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: time-Timer.salam

صبر برای WaitUntil

تابع صبر برای(fn: تابع(): منطقی، poll: مدت، limit: مدت): منطقی
شرط را هر poll یک بار بررسی می‌کند تا درست شود یا limit بگذرد؛ می‌گوید شرط برقرار شد یا نه.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: time-Timer.salam

اکنون Now

تابع اکنون(): صحیح۶۴
لحظه‌ی فعلی بر حسب ثانیه از مبدأ یونیکس.
time-Now.salam
واردسازی زمان

تابع ریشه:
    آغاز := زمان.اکنون()
    آ := زمان.نانوثانیه یکنواخت()
    زمان.خواب(۲۰)
    زمان.خواب به مدت(زمان.میلی‌ثانیه‌ها(۱۰))
    ب := زمان.نانوثانیه یکنواخت()
    سرچاپ زمان.سپری میلی ثانیه(آ، ب) >= ۳۰.۰، زمان.سپری میکروثانیه(آ، ب) >= ۳۰۰۰۰.۰، زمان.سپری ثانیه(آ، ب) < ۵.۰
    سرچاپ زمان.از نانوثانیه(آ) >= ۳۰۰۰۰۰۰۰، زمان.از میلی ثانیه(آ) >= ۳۰.۰، زمان.از میکروثانیه(آ) >= ۳۰۰۰۰.۰، زمان.از ثانیه(آ) < ۵.۰
    سرچاپ زمان.مدت از(آ).میلی‌ثانیه() >= ۳۰
    سرچاپ زمان.میلی‌ثانیه یکنواخت() > ۰، زمان.میکروثانیه یکنواخت() > ۰
    سرچاپ زمان.اکنون() >= آغاز، زمان.از زمان(آغاز) >= ۰، زمان.تا زمان(آغاز + ۶۰) <= ۶۰
    سرچاپ زمان.اکنون میلی ثانیه() / ۱۰۰۰ >= آغاز، زمان.اکنون میکروثانیه() / ۱۰۰۰۰۰۰ >= آغاز، زمان.اکنون نانوثانیه() / ۱۰۰۰۰۰۰۰۰۰ >= آغاز
پایان
خروجیtrue true true true true true true true true true true true true true true true

تاریخ زمان اکنون NowDateTime

تابع تاریخ زمان اکنون(): تاریخ زمان
لحظه‌ی فعلی به صورت تاریخ زمان.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: time-Local.salam

از مبدا FromEpoch

تابع از مبدا(seconds: صحیح۶۴): تاریخ زمان
تاریخ زمان از ثانیه‌های مبدأ.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: time-Local.salam

مبدا Epoch

تابع مبدا(dt: تاریخ زمان): صحیح۶۴
ثانیه‌های مبدأ یک تاریخ زمان.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: time-Local.salam

سال Year

تابع سال(epoch: صحیح۶۴): صحیح
سال این لحظه، به وقت محلی رایانه.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: time-Local.salam

ماه Month

تابع ماه(epoch: صحیح۶۴): صحیح
ماه (۱ تا ۱۲) این لحظه، به وقت محلی رایانه.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: time-Local.salam

روز Day

تابع روز(epoch: صحیح۶۴): صحیح
روز ماه این لحظه، به وقت محلی رایانه.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: time-Local.salam

ساعت Hour

تابع ساعت(epoch: صحیح۶۴): صحیح
ساعت (۰ تا ۲۳) این لحظه، به وقت محلی رایانه.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: time-Local.salam

دقیقه Minute

تابع دقیقه(epoch: صحیح۶۴): صحیح
دقیقه این لحظه، به وقت محلی رایانه.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: time-Local.salam

ثانیه Second

تابع ثانیه(epoch: صحیح۶۴): صحیح
ثانیه این لحظه، به وقت محلی رایانه.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: time-Local.salam

سال جهانی YearUTC

تابع سال جهانی(epoch: صحیح۶۴): صحیح
سال این لحظه، به وقت جهانی (UTC).

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: time-UTC.salam

ماه جهانی MonthUTC

تابع ماه جهانی(epoch: صحیح۶۴): صحیح
ماه (۱ تا ۱۲) این لحظه، به وقت جهانی (UTC).

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: time-UTC.salam

روز جهانی DayUTC

تابع روز جهانی(epoch: صحیح۶۴): صحیح
روز ماه این لحظه، به وقت جهانی (UTC).

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: time-UTC.salam

ساعت جهانی HourUTC

تابع ساعت جهانی(epoch: صحیح۶۴): صحیح
ساعت (۰ تا ۲۳) این لحظه، به وقت جهانی (UTC).

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: time-UTC.salam

دقیقه جهانی MinuteUTC

تابع دقیقه جهانی(epoch: صحیح۶۴): صحیح
دقیقه این لحظه، به وقت جهانی (UTC).

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: time-UTC.salam

ثانیه جهانی SecondUTC

تابع ثانیه جهانی(epoch: صحیح۶۴): صحیح
ثانیه این لحظه، به وقت جهانی (UTC).

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: time-UTC.salam

روز هفته Weekday

تابع روز هفته(epoch: صحیح۶۴): صحیح
روز هفته به وقت محلی: صفر یکشنبه، ۱ دوشنبه و تا ۶ شنبه.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: time-Local.salam

روز سال YearDay

تابع روز سال(epoch: صحیح۶۴): صحیح
چندمین روز سال، از ۱، به وقت محلی.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: time-Local.salam

قالب تاریخ FormatDate

تابع قالب تاریخ(epoch: صحیح۶۴): رشته
تاریخ محلی به شکل 2024-03-20.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: time-Local.salam

قالب ساعت FormatTime

تابع قالب ساعت(epoch: صحیح۶۴): رشته
ساعت محلی به شکل 09:30:00.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: time-Local.salam

قالب بندی Format

تابع قالب بندی(epoch: صحیح۶۴): رشته
تاریخ و ساعت محلی با یک فاصله بینشان.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: time-Local.salam

قالب ایزو FormatISO

تابع قالب ایزو(epoch: صحیح۶۴): رشته
تاریخ و ساعت محلی به شکل ISO 8601 بدون اختلاف منطقه، مثل 2024-03-20T09:30:00.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: time-Local.salam

قالب تاریخ اچ‌تی‌تی‌پی FormatHTTPDate

تابع قالب تاریخ اچ‌تی‌تی‌پی(epoch: صحیح۶۴): رشته
قالب تاریخ سرصفحه‌های HTTP، همیشه به وقت جهانی: Wed, 20 Mar 2024 14:05:09 GMT.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: time-UTC.salam

خواب Sleep

تابع خواب(ms: صحیح)
نخ فراخواننده را چند میلی‌ثانیه نگه می‌دارد.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: time-Now.salam

اختلاف ثانیه DiffSeconds

تابع اختلاف ثانیه(later: صحیح۶۴، earlier: صحیح۶۴): صحیح۶۴
چند ثانیه از earlier تا later فاصله است.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: time-UTC.salam

از زمان Since

تابع از زمان(t: صحیح۶۴): صحیح۶۴
چند ثانیه از آن لحظه گذشته.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: time-Now.salam

تا زمان Until

تابع تا زمان(t: صحیح۶۴): صحیح۶۴
چند ثانیه تا آن لحظه مانده؛ اگر گذشته باشد، منفی.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: time-Now.salam

نانوثانیه‌ها Nanoseconds

تابع نانوثانیه‌ها(n: صحیح۶۴): مدت
مدتی برابر n نانوثانیه.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: time-Duration.salam

میکروثانیه‌ها Microseconds

تابع میکروثانیه‌ها(n: صحیح۶۴): مدت
مدتی برابر n میکروثانیه.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: time-Duration.salam

میلی‌ثانیه‌ها Milliseconds

تابع میلی‌ثانیه‌ها(n: صحیح۶۴): مدت
مدتی برابر n میلی‌ثانیه.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: time-Duration.salam

ثانیه‌ها Seconds

تابع ثانیه‌ها(n: صحیح۶۴): مدت
مدتی برابر n ثانیه.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: time-Duration.salam

دقیقه‌ها Minutes

تابع دقیقه‌ها(n: صحیح۶۴): مدت
مدتی برابر n دقیقه.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: time-Duration.salam

ساعت‌ها Hours

تابع ساعت‌ها(n: صحیح۶۴): مدت
مدتی برابر n ساعت.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: time-Duration.salam

روزها Days

تابع روزها(n: صحیح۶۴): مدت
مدتی برابر n روز.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: time-Duration.salam

ثانیه اعشاری SecondsF

تابع ثانیه اعشاری(x: اعشار۶۴): مدت
مدتی برابر عدد اعشاری ثانیه، مثل ۰.۲۵ برای ربع ثانیه.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: time-Duration.salam

مدت صفر ZeroDuration

تابع مدت صفر(): مدت
مدت صفر.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: time-Duration.salam

قالب مدت FormatDuration

تابع قالب مدت(d: مدت): رشته
مدت را کوتاه و خوانا می‌نویسد: 42ns، 250us، 1.5s، 1m30s یا 1h15m30.5s.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: time-Duration.salam

تجزیه مدت ParseDuration

تابع تجزیه مدت(s: رشته): Throws<مدت>
متنی مثل 1h15m30.5s یا -250ms را می‌خواند. واحدها: ns، us، ms، s، m، h و d برای روز، و هر عدد یکی از آن‌ها را لازم دارد. برای نویسه یا یکای ناشناخته نحو، برای متن خالی یا عدد بی‌یکا اتمام ناگهانی، و برای مدتی که در ۶۴ بیت نانوثانیه جا نمی‌شود خارج از بازه پرتاب می‌کند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: time-Duration.salam

تجزیه مدت با پیش فرض ParseDurationOr

تابع تجزیه مدت با پیش فرض(s: رشته، fallback: مدت): مدت
مثل تجزیه مدت، ولی اگر متن نادرست باشد به‌جای پرتاب خطا مقدار پیش‌فرض را برمی‌گرداند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: time-Duration.salam

خواب به مدت SleepFor

تابع خواب به مدت(d: مدت)
به اندازه‌ی مدت داده‌شده می‌خوابد.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: time-Now.salam

مدت از SinceDuration

تابع مدت از(start_ns: صحیح۶۴): مدت
مدت گذشته از لحظه‌ای که با نانوثانیه یکنواخت گرفته‌اید.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: time-Now.salam

مدت بین DurationBetween

تابع مدت بین(later: صحیح۶۴، earlier: صحیح۶۴): مدت
فاصله‌ی دو لحظه‌ی مبدأ یونیکس، به صورت مدت.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: time-UTC.salam

افزودن مدت AddDuration

تابع افزودن مدت(epoch: صحیح۶۴، d: مدت): صحیح۶۴
مدت را به لحظه‌ی داده‌شده اضافه می‌کند؛ کسر ثانیه دور ریخته می‌شود.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: time-UTC.salam

تجزیه ایزو ParseISO

تابع تجزیه ایزو(s: رشته): Throws<صحیح۶۴>
تاریخ و ساعت ISO 8601 را می‌خواند، مثل 2024-03-20T17:35:09+03:30 یا 2024-03-20، و لحظه را بر حسب ثانیه‌ی کامل برمی‌گرداند؛ کسر ثانیه بررسی و کنار گذاشته می‌شود. اگر اختلاف منطقه نیامده باشد، وقت محلی فرض می‌شود. برای متنی با شکل دیگر نحو یا اتمام ناگهانی و برای بخشی که وجود ندارد، مثل ماه ۱۳ یا ۳۰ فوریه، خارج از بازه پرتاب می‌کند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: time-UTC.salam

تجزیه ایزو نانوثانیه ParseISONanos

تابع تجزیه ایزو نانوثانیه(s: رشته): Throws<صحیح۶۴>
مثل تجزیه ایزو، ولی کسر ثانیه را نگه می‌دارد: نانوثانیه از مبدأ یونیکس را برمی‌گرداند. برای تاریخ پیش از ۱۶۷۷ یا پس از ۲۲۶۲ که جا نمی‌شود هم خارج از بازه پرتاب می‌کند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: time-UTC.salam

تجزیه ایزو در ParseISOIn

تابع تجزیه ایزو در(s: رشته، offsetMinutes: صحیح): Throws<صحیح۶۴>
مثل تجزیه ایزو، ولی اگر اختلاف منطقه نیامده باشد، offsetMinutes دقیقه فرض می‌شود. همان خطاها را پرتاب می‌کند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: time-UTC.salam

تجزیه تاریخ اچ‌تی‌تی‌پی ParseHTTPDate

تابع تجزیه تاریخ اچ‌تی‌تی‌پی(s: رشته): Throws<صحیح۶۴>
تاریخ سرصفحه‌های HTTP را می‌خواند، مثل Wed, 09 Jun 2021 10:18:14 GMT، و دو شکل قدیمی‌تری که HTTP هنوز می‌پذیرد. منطقه باید GMT، UTC یا یک اختلاف عددی باشد. مثل تجزیه ایزو خطا پرتاب می‌کند، و برای نام ماه ناشناخته نحو.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: time-UTC.salam

تجزیه با قالب ParseFormat

تابع تجزیه با قالب(pattern: رشته، s: رشته): Throws<صحیح۶۴>
متن را با الگو می‌خواند. %Y سال چهاررقمی، %y سال دورقمی، %m ماه، %d روز، %H ساعت، %M دقیقه، %S ثانیه، %f کسر ثانیه، %b نام ماه انگلیسی، %a نام روز (نادیده گرفته می‌شود)، %z اختلاف مثل +0330 و %Z نام منطقه مثل UTC. هر فاصله در الگو هر تعداد فاصله در متن را می‌پذیرد. اگر متن با الگو جور نباشد مثل تجزیه ایزو خطا پرتاب می‌کند، و برای دستوری که نمی‌شناسد آرگومان نامعتبر.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: time-UTC.salam

تجزیه ایزو با پیش فرض ParseISOOr

تابع تجزیه ایزو با پیش فرض(s: رشته، fallback: صحیح۶۴): صحیح۶۴
مثل تجزیه ایزو، ولی اگر متن نادرست باشد به‌جای پرتاب خطا مقدار پیش‌فرض را برمی‌گرداند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: time-UTC.salam

قالب ایزو جهانی FormatISOUTC

تابع قالب ایزو جهانی(epoch: صحیح۶۴): رشته
لحظه را به وقت جهانی و به شکل ISO 8601 می‌نویسد، مثل 2024-03-20T14:05:09Z.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: time-UTC.salam

قالب آر‌اف‌سی۳۳۳۹ FormatRFC3339

تابع قالب آر‌اف‌سی۳۳۳۹(epoch: صحیح۶۴): رشته
لحظه را به وقت محلی با اختلاف منطقه می‌نویسد، مثل 2024-03-20T17:35:09+03:30؛ اگر اختلاف صفر باشد، Z.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: time-Local.salam

اختلاف محلی در LocalOffsetMinutesAt

تابع اختلاف محلی در(epoch: صحیح۶۴): صحیح
اختلاف وقت محلی با وقت جهانی در آن لحظه، بر حسب دقیقه. با ساعت تابستانی ممکن است در طول سال عوض شود.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: time-Local.salam

از اجزای محلی FromLocalParts

تابع از اجزای محلی(year: صحیح، month: صحیح، day: صحیح، hour: صحیح، minute: صحیح، second: صحیح): صحیح۶۴
از سال، ماه، روز، ساعت، دقیقه و ثانیه‌ی وقت محلی، لحظه را می‌سازد. مقدارهای بیرون از بازه به ماه یا سال بعد سرریز می‌شوند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: time-Local.salam

از اجزای جهانی FromUTCParts

تابع از اجزای جهانی(year: صحیح، month: صحیح، day: صحیح، hour: صحیح، minute: صحیح، second: صحیح): صحیح۶۴
از اجزای وقت جهانی، لحظه را می‌سازد. مقدارهای بیرون از بازه سرریز می‌شوند، پس ماه ۱۳ ژانویه‌ی سال بعد است.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: time-UTC.salam

اکنون نانوثانیه NowNanos

تابع اکنون نانوثانیه(): صحیح۶۴
لحظه‌ی فعلی بر حسب نانوثانیه از مبدأ یونیکس.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: time-Now.salam

اکنون میکروثانیه NowMicros

تابع اکنون میکروثانیه(): صحیح۶۴
لحظه‌ی فعلی بر حسب میکروثانیه از مبدأ یونیکس.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: time-Now.salam

اکنون میلی ثانیه NowMillis

تابع اکنون میلی ثانیه(): صحیح۶۴
لحظه‌ی فعلی بر حسب میلی‌ثانیه از مبدأ یونیکس.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: time-Now.salam

سپری میلی ثانیه ElapsedMs

تابع سپری میلی ثانیه(start_ns: صحیح۶۴، end_ns: صحیح۶۴): اعشار۶۴
فاصله‌ی دو خوانش ساعت نانوثانیه، بر حسب میلی‌ثانیه.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: time-Now.salam

سپری میکروثانیه ElapsedUs

تابع سپری میکروثانیه(start_ns: صحیح۶۴، end_ns: صحیح۶۴): اعشار۶۴
فاصله‌ی دو خوانش ساعت نانوثانیه، بر حسب میکروثانیه.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: time-Now.salam

سپری ثانیه ElapsedSec

تابع سپری ثانیه(start_ns: صحیح۶۴، end_ns: صحیح۶۴): اعشار۶۴
فاصله‌ی دو خوانش ساعت نانوثانیه، بر حسب ثانیه.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: time-Now.salam

نانوثانیه یکنواخت MonoNanos

تابع نانوثانیه یکنواخت(): صحیح۶۴
ساعت یکنواخت بر حسب نانوثانیه. این ساعت هیچ‌وقت عقب نمی‌رود، حتی اگر ساعت سیستم را عوض کنند؛ برای اندازه‌گیری مدت از همین استفاده کنید. مقدارش به تنهایی معنای تاریخ ندارد.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: time-Now.salam

میکروثانیه یکنواخت MonoMicros

تابع میکروثانیه یکنواخت(): صحیح۶۴
ساعت یکنواخت بر حسب میکروثانیه.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: time-Now.salam

میلی‌ثانیه یکنواخت MonoMillis

تابع میلی‌ثانیه یکنواخت(): صحیح۶۴
ساعت یکنواخت بر حسب میلی‌ثانیه.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: time-Now.salam

از نانوثانیه SinceNanos

تابع از نانوثانیه(start_ns: صحیح۶۴): صحیح۶۴
نانوثانیه‌های گذشته از یک خوانش ساعت یکنواخت.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: time-Now.salam

از میلی ثانیه SinceMs

تابع از میلی ثانیه(start_ns: صحیح۶۴): اعشار۶۴
میلی‌ثانیه‌های گذشته از یک خوانش ساعت یکنواخت، با اعشار.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: time-Now.salam

از میکروثانیه SinceUs

تابع از میکروثانیه(start_ns: صحیح۶۴): اعشار۶۴
میکروثانیه‌های گذشته از یک خوانش ساعت یکنواخت، با اعشار.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: time-Now.salam

از ثانیه SinceSec

تابع از ثانیه(start_ns: صحیح۶۴): اعشار۶۴
ثانیه‌های گذشته از یک خوانش ساعت یکنواخت، با اعشار.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: time-Now.salam