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

كسر الربع المنقضي

عند ظهر 15 فبراير 2024 بتوقيت UTC يكون الربع الأول قد انقضى نصفه تمامًا، أي كسر 0.5. أدخل تاريخًا أو تاريخًا ووقتًا مع الإزاحة لتعرف ما انقضى من الربع وما بقي منه، مقيسًا بالثواني. مجاني في متصفحك.

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

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

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

مثال محلول

إذا أدخلت

التاريخ والوقت: 2024-02-15T12:00:00Z

تحصل على

السنة: 2,024
الشهر: 2
اليوم: 15
الساعة: 12

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

كيف يُحسب كسر ربع التقويم في UTC

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

يرفض المحلّل الأشكال الخاطئة والأشهر خارج المدى والأيام المستحيلة مثل الحادي والثلاثين من أبريل والتاسع والعشرين من فبراير في سنة غير كبيسة، فلا تتحول البيانات السيئة إلى قيمة تقدّم مختلقة. متى عُرفت اللحظة، حوّلها إلى حقبة UTC بالثواني الكاملة بحساب مدني خالص لا يستدعي كائن Date في JavaScript، متجنّبًا مفاجآت المنطقة الزمنية والتوقيت الصيفي للمضيف. أسند شهر UTC إلى ربع التقويم الغريغوري القياسي: يناير إلى مارس هو الربع الأول، أبريل إلى يونيو الثاني، يوليو إلى سبتمبر الثالث، وأكتوبر إلى ديسمبر الرابع.

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

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

ما الذي ترسله وما الذي تستقبله وكيف تتصرف الأخطاء

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

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

أين يظهر تقدّم كسر الربع في العمل الحقيقي

فرق المنتج والمالية ترسم أشرطة تقدّم ربع سنوية لأهداف OKR والإيرادات وحزم مجلس الإدارة وتحتاج حصة متصلة من صفر إلى واحد تطابق حدود الربع المدنية لا عدّاد أيام كاملة يتجاهل التقدّم داخل اليوم. تقويمات العمليات وSRE التي تعيد ميزانيات الأخطاء أو خطط السعة عند بدايات الأرباع تستخدم الكسر نفسه لوضع اللحظة UTC الحالية على محور موحّد للتنبيهات والتقارير. تسويق وعمليات المبيعات يجدولان الحملات وفترات الحصص بسؤال كم من الربع الحالي قد انقضى عندما يُثبَّت إطلاق أو نقطة تحقق بصيغة ISO.

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

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

لوحات OKR والمالية الربع سنوية

حوّل أي تاريخ ووقت ISO إلى كسر تقدّم ربع 0–1 حتى تبقى أشرطة التقدّم وتسميات الكسر المتبقي واعية للكبيسة ومستقرة بـ UTC دون ساعات المضيف.

تقويمات SLA وميزانية الأخطاء

ضع نقطة التحقق الحالية على محور ربع موحّد للتنبيهات والتقارير التي تُعاد عند حدود Q1–Q4.

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

كيف يُحسب كسر الربع؟

fraction = (حقبة UTC للتاريخ والوقت − حقبة UTC لبداية الربع) ÷ (حقبة UTC لبداية الربع التالي − بداية الربع). Q1 يناير–مارس، Q2 أبريل–يونيو، Q3 يوليو–سبتمبر، Q4 أكتوبر–ديسمبر. النتيجة بين 0 و 1.

هل هذا مثل الأيام المنقضية في الربع؟

لا. الأيام المنقضية تعيد عددًا صحيحًا لأيام كاملة من تاريخ بداية الربع. هذه القدرة تعيد كسرًا متصلًا لمدة الربع الكاملة عند تاريخ ووقت صريحين، وهي نية بحث مختلفة.

هل تغيّر السنة الكبيسة الكسر؟

نعم في Q1. السنوات الكبيسة تضيف 29 فبراير فيكون Q1 91 يومًا (7,862,400 ثانية) بدل 90. اللحظة نفسها في فبراير–مارس تُقابل كسرًا أصغر قليلًا في سنة كبيسة.

ماذا يحدث إذا كان التاريخ والوقت غير صالحين؟

الشكل الخاطئ أو الشهر خارج المدى أو أيام مستحيلة مثل 2023-02-29 أو مكوّنات وقت غير صالحة تُرفض ولا تُحاسب.

هل يمكنني إدخال وقت مع إزاحة زمنية؟

نعم. تُحوَّل الإزاحة مثل +02:00 أو الحرف Z إلى UTC أولًا، ثم يُحدَّد الربع. أما التاريخ الخالي من الوقت فيُعامل على أنه منتصف الليل بتوقيت UTC في بداية ذلك اليوم.

أدوات ذات صلة

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

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

الـEndpoint

POSThttps://api.kit.forhosting.com/date/fraction-of-quarter-elapsed

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

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

curl -X POST https://api.kit.forhosting.com/date/fraction-of-quarter-elapsed \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"datetime":"2024-02-15T12:00:00Z"}'

const res = await fetch("https://api.kit.forhosting.com/date/fraction-of-quarter-elapsed", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "datetime": "2024-02-15T12:00:00Z"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/date/fraction-of-quarter-elapsed",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "datetime": "2024-02-15T12:00:00Z"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/date/fraction-of-quarter-elapsed", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"datetime":"2024-02-15T12:00:00Z"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"datetime":"2024-02-15T12:00:00Z"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/date/fraction-of-quarter-elapsed", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

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

{
  "datetime": "2024-02-15T12:00:00Z"
}

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

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "date.fraction_of_quarter_elapsed",
  "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`	تجاوزت الحد المسموح من الطلبات؛ انتظر قليلًا ثم أعد المحاولة.

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

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

كيف يُحسب كسر ربع التقويم في UTC

خط الأنابيب كله حساب صحيح وعائم حتمي بلا بذور عشوائية وبلا ساعة جدارية وبلا نداءات شبكة، فمدخلات متطابقة تنتج دائمًا JSON متطابقًا يناسب Workers عند الحافة والودجات بلا اتصال ومثبتات الانحدار.

ما الذي ترسله وما الذي تستقبله وكيف تتصرف الأخطاء

تُقبل الأسماء البديلة date وiso وat وwhen وvalue وon بالمعنى نفسه حتى يربط العملاء الحاليون الحقل دون إعادة تسمية. الحقول الناقصة والقيم غير السلاسل والسلاسل الفارغة وما لا يطابق شكل ISO المدعوم تفشل بـ invalid_input ولا تُحاسب. عند النجاح تعيد الاستجابة تاريخًا ووقتًا UTC موحّدين بلاحقة Z، والسنة والشهر واليوم والساعة والدقيقة والثانية الرقمية في UTC، ورقم الربع من واحد إلى أربعة، وquarter_label مثل Q2، وسلسلة مقروءة لنطاق الأشهر، وquarter_start وquarter_end كتاريخي تقويم شاملين بصيغة YYYY-MM-DD، ومنطقي is_leap_year يهم طول الربع الأول، والأعداد الصحيحة elapsed_seconds وremaining_seconds، وquarter_seconds كمدة الربع الكاملة، وfraction وremaining_fraction على الفترة الوحدوية، وسلسلة formula قصيرة توثّق تعريف UTC. تسعير استدعاءات API الناجحة هو القاعدة المنشورة $0.002 لكل عنصر؛ وفشل التحقق لا يستهلك الرصيد المدفوع مسبقًا.

أين يظهر تقدّم كسر الربع في العمل الحقيقي

مؤلفو المناهج الذين يدرّسون قواعد الكبيسة الغريغورية ومقاييس التقدّم الخطي يريدون مرجعًا يرفض التواريخ المستحيلة ويعامل الإزاحات كتحويل إلى UTC ويعيد الأرقام نفسها في ودجة المتصفح وفي API. ولأن هذه القدرة محرك parse نقي، فتسعير API هو القاعدة المنشورة $0.002 لكل عنصر ناجح وفشل التحقق لا يستهلك الرصيد.

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

نقاط تحقق الحملات والحصص

اختم الإطلاقات وحصص المبيعات بكسر ربع حتمي من مدخلات ISO صارمة، مع invalid_input واضح عند الطوابع غير الصالحة.

أسئلة تقنية

ما التكلفة؟

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

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

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

مثال محلول

كيف يُحسب كسر ربع التقويم في UTC

ما الذي ترسله وما الذي تستقبله وكيف تتصرف الأخطاء

أين يظهر تقدّم كسر الربع في العمل الحقيقي

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

لوحات OKR والمالية الربع سنوية

تقويمات SLA وميزانية الأخطاء

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

أدوات ذات صلة

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

الـEndpoint

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

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

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

الأسعار

الأخطاء

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

كيف يُحسب كسر ربع التقويم في UTC

ما الذي ترسله وما الذي تستقبله وكيف تتصرف الأخطاء

أين يظهر تقدّم كسر الربع في العمل الحقيقي

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

نقاط تحقق الحملات والحصص

أسئلة تقنية

شكرًا