ForHosting KIT · التواريخ والوقت

اقتطاع التاريخ والوقت لوحدة

اقتطع التاريخ والوقت إلى بداية السنة أو الشهر أو اليوم أو الساعة أو الدقيقة بتوقيت UTC: القيمة 2024-06-15T14:37:52Z مقتطعة إلى اليوم تصبح 2024-06-15T00:00:00Z. مفيد للتقارير اليومية والرسوم البيانية بالساعة. مجاني في متصفحك.

مجاني
يعمل في متصفحك
دون تسجيل
بياناتك لا تغادر جهازك

شغّل الأداة مجانًا اطّلع على الـAPI

استخدمها من الويبAPIالبريدTelegramالتطبيق قريبًا

مثال محلول

إذا أدخلت

التاريخ والوقت: 2024-06-15T14:37:52Z day

تحصل على

النتيجة: 2024-06-15T00:00:00Z day
السنة: 2,024
الشهر: 6
اليوم: 15

اقتطاع طابع زمني إلى وحدة أخشن هو أساس المجموعات اليومية والتقارير الشهرية والمخططات الساعية ومفاتيح التخزين المؤقت التي يجب أن تتوافق عبر اللغات والمضيفين. تجعل مناطق المضيف وجداول التوقيت الصيفي عملية أرضية ساذجة تتباعد بين المتصفحات والخوادم وعمال الحافة. تقبل أداة اقتطاع التاريخ والوقت إلى وحدة تاريخًا ووقتًا صريحين بصيغة ISO-8601 — وقت كامل مع Z أو إزاحة رقمية، أو سلسلة تاريخ فقط تُعامل كمنتصف ليل UTC — بالإضافة إلى وحدة سنة أو شهر أو يوم أو ساعة أو دقيقة. تُطبّع الإدخال إلى التوقيت العالمي المنسق بحساب تقويمي غريغوري خالص، ثم تصفّر كل حقل أدق من الوحدة المختارة ليكون الناتج لحظة أرضية UTC مستقرة مكتوبة سنة-شهر-يوم T ساعة-دقيقة-ثانية Z. تفشل الأيام التقويمية المستحيلة والوحدات المجهولة بخطأ تحقق واضح بدل اختراع ترحيل.

كيف يعمل الاقتطاع بتوقيت UTC دون ساعة النظام

ابدأ من تاريخ ووقت أساسيين صريحين مكتوبين بالصيغة الدولية ISO حتى يتفق كل عميل على نفس السنة والشهر واليوم وحقول الساعة الاختيارية. عند تقديم تاريخ تقويمي فقط، عامله كمنتصف ليل بالتوقيت العالمي المنسق. عند وجود وقت، اقبل كسور ثوانٍ اختيارية تُقتطع إلى ثوانٍ كاملة وعلامة Z نهائية لـ UTC أو إزاحة رقمية بالساعات والدقائق بعلامة زائد أو ناقص تُطرح عند التحويل إلى زمن مطلق.

تحقق من أن اليوم المدني موجود وفق قواعد الغريغوري للكبيسة — التاسع والعشرون من فبراير قانوني فقط عندما تكون السنة قابلة للقسمة على أربعة، باستثناء أن سنوات القرن يجب أن تكون أيضًا قابلة للقسمة على أربعمئة — وأن الساعة والدقيقة والثانية ضمن نطاقاتها المعتادة. حوّل الثلاثي المدني إلى مسلسل يوم بخوارزمية days-from-civil لهوارد هينانت، واضرب بأربعة وثمانين ألفًا وستمئة ثانية، وأضف وقت اليوم المحلي، واطرح دقائق الإزاحة مضروبة في ستين للحصول على ثواني حقبة UTC. أعد بناء السنة والشهر واليوم والساعة والدقيقة والثانية بتوقيت UTC عبر civil-from-days.

ثم طبّق أرضية خالصة حسب الوحدة: year تعيد الشهر إلى واحد واليوم إلى واحد مع الساعة صفر؛ month تحفظ السنة والشهر وتضبط اليوم إلى واحد والساعة إلى صفر؛ day تحفظ التاريخ التقويمي وتصفّر الساعة؛ hour تصفّر الدقيقة والثانية؛ minute تصفّر الثانية فقط. نسّق الحقول المدنية المقتطعة كسلسلة أربعة-اثنان-اثنان T اثنان-اثنان-اثنان Z.

أين تفيد حاسبات اقتطاع التاريخ والوقت إلى وحدة

تُجسّد مسارات التحليل مفاتيح أحداث يومية وساعية بخفض طوابع الاستيعاب إلى الأرضية، فيشارك كل لغة ومنطقة نفس مجموعة UTC دون اختراع مكتبة تقويم. تجمع فرق المالية والعمليات بنود دفتر أو تذاكر الدعم في فترات شهر أو يوم لملخصات حتمية تطابق تدقيقات دون اتصال. ترسم لوحات المنتج والنمو النشاط بالساعة أو اليوم بأرضية مستقرة حتى لا تختلف معاينات المتصفح وتجميعات الخلفية بساعة عند انتقالات التوقيت الصيفي.

إذا احتجتم لاحقًا إلى إضافة ساعات أو أيام إلى طابع، أو عد الأيام بين تاريخين، أو حساب بداية الشهر ونهايته، أو تحويل وحدات زمن خالصة بين ساعات ودقائق، فاعاملوا ذلك كنوايا بحث وصفحات هبوط منفصلة بدل إثقال صفحة اقتطاع التاريخ والوقت إلى وحدة هذه — فهي تحل استعلامات مختلفة حتى إن تشابه بعض الحساب تحت السطح.

حالات الاستخدام

مجموعات تحليل يومية وساعية

اخفضوا طوابع أحداث ISO إلى يوم أو ساعة بتوقيت UTC حتى يُجسّد كل لغة في المسار نفس مفتاح التجميع للمخططات والـ rollups.

فترات تقارير شهرية وسنوية

اقتطعوا تواريخ وأوقات الدفتر أو التذاكر إلى شهر أو سنة لبناء بدايات فترة حتمية للتصدير والتدقيق والملخصات المالية.

الأسئلة الشائعة

ما الوحدات المدعومة؟

خمسة رموز فقط دون تمييز لحالة الأحرف: year وmonth وday وhour وminute.

هل يستخدم الاقتطاع منطقتي الزمنية المحلية؟

لا. تُحسب الأرضية دائمًا بتوقيت UTC من سلسلة الإدخال الصريحة. تُحوَّل الإزاحات في السلسلة إلى UTC أولًا؛ ولا تُقرأ ساعة المضيف أبدًا.

ماذا يحدث مع يوم تقويمي غير صالح؟

لا تنتقل المهمة إلى مارس ولا تخترع يوم كبيسة.

ماذا أحصل عند الاقتطاع إلى الشهر أو السنة؟

عند الاقتطاع إلى الشهر تحصل على اليوم الأول من ذلك الشهر عند منتصف الليل بتوقيت UTC. وعند الاقتطاع إلى السنة تحصل على 1 يناير من تلك السنة، وتصبح كل الأجزاء الأصغر صفرًا.

ماذا يحدث لوقت مكتوب مع فرق توقيت؟

يُحوَّل أولًا إلى UTC ثم يُقتطع. لذلك قد يقع الوقت ذو الفرق الموجب في ساعة أخرى، بل في يوم آخر، غير الظاهر في النص الأصلي.

أدوات ذات صلة

للمطوّرين — الوصول عبر API

كل ما في هذه الصفحة متاح برمجيًا. هذا القسم موجّه للفرق التقنية التي تريد ربط الأداة بأنظمتها الخاصة؛ بقية المستخدمين يمكنهم استخدام الأداة أعلاه مباشرة دون الحاجة لقراءة ما يلي.

الـEndpoint

POSThttps://api.kit.forhosting.com/date/truncate-to-unit

صادِق على طلبك بترويسة Bearer، وأرسل طلب POST واحدًا لتدخل مهمتك قائمة التنفيذ فورًا؛ ثم تستلم النتيجة عبر webhook أو رابط موقّع.

استدعِ الخدمة من بيئتك

curl -X POST https://api.kit.forhosting.com/date/truncate-to-unit \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"datetime":"2024-06-15T14:37:52Z","unit":"day"}'

const res = await fetch("https://api.kit.forhosting.com/date/truncate-to-unit", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "datetime": "2024-06-15T14:37:52Z",
    "unit": "day"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/date/truncate-to-unit",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "datetime": "2024-06-15T14:37:52Z",
    "unit": "day"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/date/truncate-to-unit", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"datetime":"2024-06-15T14:37:52Z","unit":"day"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"datetime":"2024-06-15T14:37:52Z","unit":"day"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/date/truncate-to-unit", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

مثال على الطلب

{
  "datetime": "2024-06-15T14:37:52Z",
  "unit": "day"
}

مثال على الاستجابة

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "date.truncate_to_unit",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

الواجهة غير متزامنة: تستلم task_id فور الإرسال، ويمكنك الاستعلام عن الحالة بمعدل طلب واحد في الثانية.

الأسعار

لكل طلب$0.002

السعر معلن كما تراه: لا tokens ولا نظام نقاط؛ وإن فشلت المهمة فلن تُحاسَب عليها.

الأخطاء

HTTP	الرمز	المعنى
`401`	`unauthorized`	مفتاح الوصول مفقود أو غير صالح؛ تحقق من ترويسة Bearer في طلبك.
`402`	`insufficient_balance`	رصيدك لا يكفي لتنفيذ هذه المهمة؛ أعد شحن الرصيد ثم أعد المحاولة.
`404`	`unknown_type`	نوع المهمة المطلوب غير موجود في الكتالوج — راجع الاسم المرسل في الطلب.
`429`	`rate_limited`	تجاوزت الحد المسموح من الطلبات؛ انتظر قليلًا ثم أعد المحاولة.

ملاحظات تقنية

ما الذي ترسلونه وما الذي تستلمونه

فحوصات كلاسيكية: خفض الرابعة والثلاثين والسبع إلى اليوم عند منتصف ليل UTC، وخفض طابع صباحي بإزاحة زائد-اثنين إلى الساعة بصيغة Z خالصة، والخفض إلى الشهر في اليوم الأول، وإلى السنة في الأول من يناير، ورفض أساس مثل التاسع والعشرين من فبراير في سنة عادية. أرسلوا حقلين إلزاميين: datetime كسلسلة ISO-8601 مثل ألفين وأربعة وعشرين شرطة صفر ستة شرطة خمسة عشر T أربعة عشر نقطتان سبعة وثلاثون نقطتان اثنان وخمسون Z، وunit واحدة من year أو month أو day أو hour أو minute (دون تمييز لحالة الأحرف). تُقبل الأسماء البديلة date وdt وtimestamp وts للسلسلة الأساسية؛ وto وtruncate_to وgranularity للوحدة. الحقول الناقصة، وdatetime غير النصية، والسلاسل خارج شكل ISO، والأيام التقويمية المستحيلة، ومكوّنات الوقت غير الصالحة، والوحدات خارج الرموز الخمسة المسموحة تفشل بـ invalid_input ولا تُحاسب. عند النجاح تعيد الاستجابة datetime الأساسي بعد التشذيب، وunit بحروف صغيرة مُطبّعة، وسلسلة ISO UTC الناتجة بعد الاقتطاع، والسنة والشهر واليوم والساعة والدقيقة والثانية الرقمية للحظة الأرضية، وepoch_seconds للنتيجة، وصيغة قصيرة توثّق قاعدة الأرضية بتوقيت UTC. سعر استدعاءات API الناجحة هو القاعدة المنشورة $0.002 لكل عنصر؛ إخفاقات التحقق لا تستهلك الرصيد المدفوع مسبقًا.

أين تفيد حاسبات اقتطاع التاريخ والوقت إلى وحدة

ولأن القدرة محرك parse خالص، يكون سعر API هو القاعدة المنشورة $0.002 لكل عنصر ناجح ولا يستهلك فشل التحقق الرصيد.

حالات التكامل

fixtures ضمان الجودة عند حدود المجموعات

ولّدوا لحظات أرضية متوقعة عند منتصف الليل وبدايات الأشهر وتحويل الإزاحة إلى UTC لاختبارات الانحدار دون ساعة المضيف.

أسئلة تقنية

كيف أقتطع تاريخًا ووقتًا إلى اليوم بتوقيت UTC؟

أرسلوا datetime كسلسلة ISO-8601 وunit كـ day. تعيد API نفس التاريخ التقويمي عند 00:00:00Z بعد تطبيع أي إزاحة رقمية إلى UTC.

كم تكلفة أداة اقتطاع التاريخ والوقت إلى وحدة؟

أداة المتصفح مجانية. تستخدم طلبات API رصيد KIT المدفوع مسبقًا بسعر $0.002 لكل استدعاء ناجح؛ والمدخل غير الصالح لا يُفوتر.

اطّلع على توثيق KIT الكامل ←

شغّل الأداة مجانًا

مثال محلول

كيف يعمل الاقتطاع بتوقيت UTC دون ساعة النظام

أين تفيد حاسبات اقتطاع التاريخ والوقت إلى وحدة

حالات الاستخدام

مجموعات تحليل يومية وساعية

فترات تقارير شهرية وسنوية

الأسئلة الشائعة

أدوات ذات صلة

للمطوّرين — الوصول عبر API

الـEndpoint

استدعِ الخدمة من بيئتك

مثال على الطلب

مثال على الاستجابة

الأسعار

الأخطاء

ملاحظات تقنية

ما الذي ترسلونه وما الذي تستلمونه

أين تفيد حاسبات اقتطاع التاريخ والوقت إلى وحدة

حالات التكامل

fixtures ضمان الجودة عند حدود المجموعات

أسئلة تقنية

شكرًا