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

زمان `time`

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

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

در این صفحه

گونه‌ها
پایاها و متغیرها
روال‌ها

در این بسته دو جور «زمان» هست. لحظه عددی است از ثانیه‌های گذشته از آغاز ۱۹۷۰ به وقت جهانی (مبدأ یونیکس) و برای تاریخ و ساعت به کار می‌رود. مدت فاصله‌ای است با دقت نانوثانیه، مثل «۱ ساعت و ۳۰ دقیقه»، که می‌شود جمع و مقایسه‌اش کرد.

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

برای تاریخ شمسی و قمری و منطقه‌های زمانی، بسته‌ی تقویم را ببینید.

گونه‌ها

تاریخ زمان `DateTime`

ساختار تاریخ زمان

یک لحظه به صورت ثانیه‌های گذشته از مبدأ یونیکس (آغاز ۱ ژانویه‌ی ۱۹۷۰ به وقت جهانی).

نام	انگلیسی	گونه	توضیح
epoch	`epoch`	`صحیح۶۴ = 0`	ثانیه‌های گذشته از مبدأ یونیکس.

time-Local.salam

واردسازی زمان
واردسازی رشته

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

خروجی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	`ns`	`صحیح۶۴ = 0`	مدت بر حسب نانوثانیه.

time-Duration.salam

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

روال ریشه:
    د := زمان.ساعت‌ها(۱).جمع(زمان.دقیقه‌ها(۳۰))
    سرچاپ د.به رشته()، د.دقیقه()، د.ثانیه‌های کامل()
    سرچاپ زمان.قالب مدت(زمان.میلی‌ثانیه‌ها(۱۵۰۰))، زمان.قالب مدت(زمان.میکروثانیه‌ها(۲۵۰))، زمان.قالب مدت(زمان.نانوثانیه‌ها(۴۲))
    سرچاپ زمان.ثانیه‌ها(۹۰).به رشته()، زمان.روزها(۲).ساعت()، زمان.ثانیه اعشاری(۰.۲۵).میلی‌ثانیه()
    ن := زمان.تجزیه مدت("1h15m30.5s")
    سرچاپ ن.ok، ن.value.به رشته()، ن.value.ثانیه()
    سرچاپ زمان.تجزیه مدت("ده دقیقه").ok، زمان.تجزیه مدت با پیش فرض("?"، زمان.ثانیه‌ها(۵)).به رشته()
    ک := زمان.دقیقه‌ها(۷)
    سرچاپ ک.تفریق(زمان.دقیقه‌ها(۱۰)).به رشته()، ک.منفی().قدرمطلق().به رشته()، ک.منفی().منفی است()
    سرچاپ ک.ضرب(۳).به رشته()، ک.تقسیم(۲).به رشته()، زمان.ساعت‌ها(۱).نسبت(ک)
    سرچاپ ک.مقایسه(زمان.ثانیه‌ها(۴۲۰))، ک.کمتر(زمان.ساعت‌ها(۱))، ک.یکسان(زمان.ثانیه‌ها(۴۲۰))
    ت := زمان.میلی‌ثانیه‌ها(۱۷۵۰)
    سرچاپ ت.برش(زمان.ثانیه‌ها(۱)).به رشته()، ت.گرد کردن(زمان.ثانیه‌ها(۱)).به رشته()
    سرچاپ ت.نانوثانیه()، ت.میکروثانیه()، ت.میلی‌ثانیه()، زمان.مدت صفر().صفر است()، ت.روز() < ۰.۰۰۱
پایان

خروجی1h30m0s 90 5400 1.5s 250us 42ns 1m30s 48 250 true 1h15m30.5s 4530.5 false 5s -3m0s 7m0s true 21m0s 3m30s 8 0 true true 1s 2s 1750000000 1750000 1750 true true

نانوثانیه `nanos`

روال نانوثانیه(): صحیح۶۴

مدت بر حسب نانوثانیه.

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

میکروثانیه `micros`

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

مدت بر حسب میکروثانیه، بدون بخش اعشاری.

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

میلی‌ثانیه `millis`

روال میلی‌ثانیه(): صحیح۶۴

مدت بر حسب میلی‌ثانیه، بدون بخش اعشاری.

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

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

روال ثانیه‌های کامل(): صحیح۶۴

ثانیه‌های کامل، بدون بخش اعشاری.

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

ثانیه `seconds`

روال ثانیه(): اعشار۶۴

مدت بر حسب ثانیه، با اعشار.

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

دقیقه `minutes`

روال دقیقه(): اعشار۶۴

مدت بر حسب دقیقه، با اعشار.

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

ساعت `hours`

روال ساعت(): اعشار۶۴

مدت بر حسب ساعت، با اعشار.

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

روز `days`

روال روز(): اعشار۶۴

مدت بر حسب روز، با اعشار.

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

جمع `add`

روال جمع(o: مدت): مدت

جمع دو مدت.

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

تفریق `sub`

روال تفریق(o: مدت): مدت

تفاضل دو مدت.

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

ضرب `mul`

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

مدت را در عدد ضرب می‌کند.

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

تقسیم `div`

روال تقسیم(k: صحیح۶۴): مدت

مدت را بر عدد تقسیم می‌کند.

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

نسبت `ratio`

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

این مدت چند برابرِ کاملِ مدت دیگر است؛ اگر آن صفر باشد، صفر.

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

منفی `neg`

روال منفی(): مدت

قرینه‌ی مدت.

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

قدرمطلق `abs`

روال قدرمطلق(): مدت

قدر مطلق مدت.

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

صفر است `is_zero`

روال صفر است(): منطقی

اگر مدت صفر باشد، درست برمی‌گرداند.

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

منفی است `is_negative`

روال منفی است(): منطقی

اگر مدت منفی باشد، درست برمی‌گرداند.

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

مقایسه `cmp`

روال مقایسه(o: مدت): صحیح

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

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

کمتر `less`

روال کمتر(o: مدت): منطقی

اگر از مدت دیگر کوتاه‌تر باشد، درست برمی‌گرداند.

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

یکسان `equals`

روال یکسان(o: مدت): منطقی

اگر با مدت دیگر برابر باشد، درست برمی‌گرداند.

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

برش `truncate`

روال برش(m: مدت): مدت

مدت را به پایین، تا مضربی از m، گرد می‌کند.

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

گرد کردن `round`

روال گرد کردن(m: مدت): مدت

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

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

به رشته `to_str`

روال به رشته(): رشته

مدت را مثل 1h30m0s می‌نویسد؛ همان قالب مدت.

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

نتیجه مدت `DurationResult`

ساختار نتیجه مدت

نتیجه‌ی تجزیه‌ی مدت.

نام	انگلیسی	گونه	توضیح
ok	`ok`	`منطقی = نادرست`	آیا متن درست خوانده شد.
value	`value`	`مدت`	مدت خوانده‌شده.

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

نتیجه زمان `TimeResult`

ساختار نتیجه زمان

نتیجه‌ی تجزیه‌ی تاریخ و ساعت.

نام	انگلیسی	گونه	توضیح
ok	`ok`	`منطقی = نادرست`	آیا متن درست خوانده شد.
epoch	`epoch`	`صحیح۶۴ = 0`	لحظه‌ی خوانده‌شده، بر حسب ثانیه از مبدأ یونیکس.
nanos	`nanos`	`صحیح = 0`	کسر ثانیه، بر حسب نانوثانیه.

time-UTC.salam

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

روال ریشه:
    ت := زمان.از اجزای جهانی(۲۰۲۴، ۳، ۲۰، ۱۴، ۵، ۹)
    سرچاپ ت، زمان.قالب ایزو جهانی(ت)
    سرچاپ زمان.سال جهانی(ت)، زمان.ماه جهانی(ت)، زمان.روز جهانی(ت)، زمان.ساعت جهانی(ت)، زمان.دقیقه جهانی(ت)، زمان.ثانیه جهانی(ت)
    سرچاپ زمان.قالب تاریخ اچ‌تی‌تی‌پی(ت)
    سرچاپ زمان.تجزیه تاریخ اچ‌تی‌تی‌پی("Wed, 20 Mar 2024 14:05:09 GMT").epoch == ت
    ن := زمان.تجزیه ایزو("2024-03-20T17:35:09+03:30")
    سرچاپ ن.ok، ن.epoch == ت، ن.nanos
    سرچاپ زمان.تجزیه ایزو در("2024-03-20 17:35:09.25"، ۲۱۰).epoch == ت، زمان.تجزیه ایزو در("2024-03-20 17:35:09.25"، ۲۱۰).nanos
    ق := زمان.تجزیه با قالب("%d/%m/%Y %H:%M %z"، "20/03/2024 14:05 +0000")
    سرچاپ ق.ok، زمان.قالب ایزو جهانی(ق.epoch)
    سرچاپ زمان.تجزیه ایزو("فردا").ok، زمان.تجزیه ایزو با پیش فرض("فردا"، ۰)
    ب := زمان.افزودن مدت(ت، زمان.روزها(۱۰))
    سرچاپ زمان.قالب ایزو جهانی(ب)، زمان.اختلاف ثانیه(ب، ت)، زمان.مدت بین(ب، ت).به رشته()
    سرچاپ زمان.ثانیه در دقیقه، زمان.ثانیه در ساعت، زمان.ثانیه در روز
پایان

خروجی1710943509 2024-03-20T14:05:09Z 2024 3 20 14 5 9 Wed, 20 Mar 2024 14:05:09 GMT true true true 0 true 250000000 true 2024-03-20T14:05:00Z false 0 2024-03-30T14:05:09Z 864000 240h0m0s 60 3600 86400

زمان‌سنج `Timer`

ساختار زمان‌سنج

زمان‌سنج یک‌باره: می‌گوید مدتی که تعیین کرده‌اید گذشته یا نه.

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

time-Timer.salam

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

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

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

خروجیfalse true true true false false false true true true false پس از ۱۰ میلی‌ثانیه تیک تیک 3 true false

منقضی شده `expired`

روال منقضی شده(): منطقی

اگر زمان‌سنج فعال باشد و مدتش گذشته باشد، درست برمی‌گرداند.

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

باقی‌مانده `remaining`

روال باقی‌مانده(): مدت

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

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

انتظار `wait`

روال انتظار()

تا پایان مدت می‌خوابد.

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

بازنشانی `reset`

روال بازنشانی(d: مدت)

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

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

توقف `stop`

روال توقف()

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

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

تیک‌زن `Ticker`

ساختار تیک‌زن

تیک‌زن: در فاصله‌های مساوی «تیک» می‌زند.

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

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

رخ داده `fired`

روال رخ داده(): منطقی

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

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

انتظار `wait`

روال انتظار()

تا تیک بعدی می‌خوابد.

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

پیشروی `advance`

روال پیشروی()

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

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

باقی‌مانده `remaining`

روال باقی‌مانده(): مدت

زمان مانده تا تیک بعدی.

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

بازنشانی `reset`

روال بازنشانی(d: مدت)

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

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

توقف `stop`

روال توقف()

تیک‌زن را متوقف می‌کند.

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

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

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

پایا ثانیه در دقیقه: صحیح۳۲ = 60

تعداد ثانیه‌های یک دقیقه.

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

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

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

تعداد ثانیه‌های یک ساعت.

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

ثانیه در روز `SecondsPerDay`

پایا ثانیه در روز: صحیح۳۲ = 86400

تعداد ثانیه‌های یک روز.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: time-UTC.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: رشته): نتیجه مدت

متنی مثل 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

اکنون نانوثانیه `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

تجزیه ایزو `ParseISO`

روال تجزیه ایزو(s: رشته): نتیجه زمان

تاریخ و ساعت ISO 8601 را می‌خواند، مثل 2024-03-20T17:35:09+03:30. اگر اختلاف منطقه نیامده باشد، وقت محلی فرض می‌شود.

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

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

روال تجزیه ایزو در(s: رشته، offsetMinutes: صحیح): نتیجه زمان

مثل تجزیه ایزو، ولی اگر اختلاف منطقه نیامده باشد، offsetMinutes دقیقه فرض می‌شود.

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

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

روال تجزیه تاریخ اچ‌تی‌تی‌پی(s: رشته): نتیجه زمان

تاریخ سرصفحه‌های HTTP را می‌خواند.

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

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

روال تجزیه با قالب(pattern: رشته، s: رشته): نتیجه زمان

متن را با الگو می‌خواند. %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

زمان‌سنج جدید `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

زمان time

گونه‌ها

تاریخ زمان DateTime

مدت Duration

نانوثانیه nanos

میکروثانیه micros

میلی‌ثانیه millis

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

ثانیه seconds

دقیقه minutes

ساعت hours

روز days

جمع add

تفریق sub

ضرب mul

تقسیم div

نسبت ratio

منفی neg

قدرمطلق abs

صفر است is_zero

منفی است is_negative

مقایسه cmp

کمتر less

یکسان equals

برش truncate

گرد کردن round

به رشته to_str

نتیجه مدت DurationResult

نتیجه زمان TimeResult

زمان‌سنج Timer

منقضی شده expired

باقی‌مانده remaining

انتظار wait

بازنشانی reset

توقف stop

تیک‌زن Ticker

رخ داده fired

انتظار wait

پیشروی advance

باقی‌مانده remaining

بازنشانی reset

توقف stop

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

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

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

ثانیه در روز SecondsPerDay

روال‌ها

اکنون Now

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

از مبدا FromEpoch

مبدا Epoch

سال Year

ماه Month

روز Day

ساعت Hour

دقیقه Minute

ثانیه Second

سال جهانی YearUTC

ماه جهانی MonthUTC

روز جهانی DayUTC

ساعت جهانی HourUTC

دقیقه جهانی MinuteUTC

ثانیه جهانی SecondUTC

روز هفته Weekday

روز سال YearDay

قالب تاریخ FormatDate

قالب ساعت FormatTime

قالب بندی Format

قالب ایزو FormatISO

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

خواب Sleep

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

از زمان Since

تا زمان Until

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

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

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

ثانیه‌ها Seconds

دقیقه‌ها Minutes

ساعت‌ها Hours

زمان `time`

تاریخ زمان `DateTime`

مدت `Duration`

نانوثانیه `nanos`

میکروثانیه `micros`

میلی‌ثانیه `millis`

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

ثانیه `seconds`

دقیقه `minutes`

ساعت `hours`

روز `days`

جمع `add`

تفریق `sub`

ضرب `mul`

تقسیم `div`

نسبت `ratio`

منفی `neg`

قدرمطلق `abs`

صفر است `is_zero`

منفی است `is_negative`

مقایسه `cmp`

کمتر `less`

یکسان `equals`

برش `truncate`

گرد کردن `round`

به رشته `to_str`

نتیجه مدت `DurationResult`

نتیجه زمان `TimeResult`

زمان‌سنج `Timer`

منقضی شده `expired`

باقی‌مانده `remaining`

انتظار `wait`

بازنشانی `reset`

توقف `stop`

تیک‌زن `Ticker`

رخ داده `fired`

انتظار `wait`

پیشروی `advance`

باقی‌مانده `remaining`

بازنشانی `reset`

توقف `stop`

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

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

ثانیه در روز `SecondsPerDay`

اکنون `Now`

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

از مبدا `FromEpoch`

مبدا `Epoch`

سال `Year`

ماه `Month`

روز `Day`

ساعت `Hour`

دقیقه `Minute`

ثانیه `Second`

سال جهانی `YearUTC`

ماه جهانی `MonthUTC`

روز جهانی `DayUTC`

ساعت جهانی `HourUTC`

دقیقه جهانی `MinuteUTC`

ثانیه جهانی `SecondUTC`

روز هفته `Weekday`

روز سال `YearDay`

قالب تاریخ `FormatDate`

قالب ساعت `FormatTime`

قالب بندی `Format`

قالب ایزو `FormatISO`

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

خواب `Sleep`

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

از زمان `Since`

تا زمان `Until`

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

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

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

ثانیه‌ها `Seconds`

دقیقه‌ها `Minutes`

ساعت‌ها `Hours`

روزها `Days`

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

مدت صفر `ZeroDuration`