تحليل التواريخ النسبية
بدءًا من 10 يناير 2020 الساعة 12:00 بتوقيت UTC، تصبح العبارة in 3 days يوم 13 يناير 2020 الساعة 12:00 بتوقيت UTC. أدخل عبارة قصيرة بالإنجليزية أو الإسبانية ولحظة مرجعية لتحصل على التاريخ والوقت الدقيقين. مجاني في متصفحك.
- مجاني
- يعمل في متصفحك
- دون تسجيل
- بياناتك لا تغادر جهازك
شغّل الأداة مجانًا
مثال محلول
- النص
- in 3 days
- التاريخ المرجعي
- 2020-01-10T12:00:00.000Z
- التاريخ والوقت بصيغة ISO
- 2020-01-13T12:00:00.000Z
- طابع Unix الزمني (مللي ثانية)
- 1,578,916,800,000
فسّر العبارات النسبية المحدودة بالإنجليزية والإسبانية للحصول على طوابع زمنية مطلقة بصيغة ISO محسوبة بالنسبة إلى نقطة ارتساء تحددها أنت.
من عبارة إلى لحظة دقيقة
نكتب التواريخ النسبية باستمرار: بعد 3 أيام، بعد بضعة أسابيع، منذ مدة. ومثل هذه العبارة لا معنى ثابتًا لها حتى نحدد من أين تبدأ، ولهذا تطلب الأداة لحظة مرجعية. ثم تعد منها إلى الأمام أو إلى الخلف وتعطيك النتيجة الدقيقة. ويبقى وقت اليوم كما هو، فالعبارة المحسوبة من الظهر تقع عند الظهر أيضًا: بدءًا من 10 يناير 2020 الساعة 12:00 بتوقيت UTC تصبح in 3 days يوم 13 يناير 2020 الساعة 12:00. وتحصل على النتيجة تاريخًا ووقتًا مقروءين ورقمًا واحدًا بالمللي ثانية.
كيف تحصل على إجابات موثوقة
أكثر المفاجآت شيوعًا مصدرها اللحظة المرجعية. فإذا حُسبت العبارة نفسها من نقطة بداية أخرى أشارت إلى يوم آخر، لذا احتفظ بالمرجع مع النتيجة حين يهمك ذلك. وتعمل الأداة بمجموعة محدودة من العبارات القصيرة بالإنجليزية والإسبانية لا بأي جملة، وتُرفض العبارة الفارغة أو القيمة التي ليست نصًا قبل أي حساب. ويجري كل شيء على جهازك دون الرجوع إلى الإنترنت، فتعطي العبارة نفسها مع اللحظة المرجعية نفسها الإجابة ذاتها دائمًا، دون حاجة إلى جدول بيانات.
المدخلات والمخرجات
يجب أن تكون الحقول المطلوبة في المخطط موجودة وذات أنواع صحيحة، بينما تستعمل الحقول الاختيارية قيمًا افتراضية موثّقة يمكنك تجاوزها عند الحاجة. وتتضمن الاستجابات الناجحة دائمًا حقول المخرجات الأساسية، حتى تبقى ارتباطات الواجهة مستقرة وقابلة للتنبؤ من تنفيذ إلى آخر دون أن تضطر إلى إضافة فحوص إضافية من عندك. وننصحك بشدة بقراءة الأمثلة المرجعية المتعلقة بترتيب خطوات التحقق، وحتمية النتائج، وسلاسل مطابقة الأخطاء المخصصة لإصدار الشهادات بعناية شديدة وبشكل كامل، قبل ربط هذه الإمكانية بأنظمة حساسة أو بمجموعات اختبار آلية يجب أن تظل موثوقة وثابتة على المدى الطويل.
الحالات الحدية والقيود
تُرفض السلاسل الفارغة والأنواع الخاطئة والنطاقات المتناقضة في وقت مبكر جدًا، أي قبل أي عملية حسابية على الإطلاق، مما يجعل السلوك قابلًا للتنبؤ في مواجهة البيانات المشوّهة أو غير المتوقعة. أما التواريخ المدنية الخالية من المنطقة الزمنية فتُعامَل بوصفها تواريخ تقويمية بسيطة فحسب، دون أي تحويل ضمني أو خفي قد يفسد النتيجة من حيث لا تدري. وتنتقل الجداول المرجعية بالكامل داخل مجلد الإمكانية، ولا يجري أي اتصال بالشبكة أثناء التنفيذ، وهو ما يحفظ خصوصية بياناتك وسرعة المعالجة معًا في آنٍ واحد.
حالات الاستخدام
العمل اليومي
احصل على إجابة موثوقة دون الحاجة إلى جدول بيانات.
التعليم
أمثلة مرجعية ثابتة لعروضك التوضيحية.
الأسئلة الشائعة
الشبكة؟
لا حاجة إلى شبكة؛ يجري التحليل على الجهاز.
ما هو التاريخ النسبي؟
هو تعبير مثل in 3 days لا يكون له معنى إلا انطلاقًا من نقطة بداية. فهو وحده لا يحدد أي يوم، أما مع لحظة مرجعية فيشير إلى تاريخ ووقت دقيقين.
ما فائدة اللحظة المرجعية؟
هي اللحظة التي تُحسب منها العبارة. فالعبارة نفسها تعطي نتائج مختلفة من لحظات مختلفة، لذا دوّن اللحظة التي استخدمتها إذا احتجت إلى إعادة الحساب لاحقًا.
بأي لغة يمكنني كتابة العبارة؟
بالإنجليزية أو الإسبانية. تفهم الأداة مجموعة محدودة من العبارات النسبية القصيرة بهاتين اللغتين لا النص الحر، وهذا ما يجعل كل إجابة متوقعة.
ماذا تتضمن النتيجة؟
التاريخ والوقت بصيغة ISO، مثل 2020-01-13 الساعة 12:00 بتوقيت UTC، واللحظة نفسها كعدد من المللي ثانية، وهنا 1578916800000، جاهزًا لجدول بيانات أو أداة أخرى.
أدوات ذات صلة
للمطوّرين — الوصول عبر API
كل ما في هذه الصفحة متاح برمجيًا. هذا القسم موجّه للفرق التقنية التي تريد ربط الأداة بأنظمتها الخاصة؛ بقية المستخدمين يمكنهم استخدام الأداة أعلاه مباشرة دون الحاجة لقراءة ما يلي.
الـEndpoint
صادِق على طلبك بترويسة Bearer، وأرسل طلب POST واحدًا لتدخل مهمتك قائمة التنفيذ فورًا؛ ثم تستلم النتيجة عبر webhook أو رابط موقّع.
استدعِ الخدمة من بيئتك
curl -X POST https://api.kit.forhosting.com/date/relative-parse \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"text":"in 3 days"}'const res = await fetch("https://api.kit.forhosting.com/date/relative-parse", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"text": "in 3 days"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/date/relative-parse",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"text": "in 3 days"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/date/relative-parse", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"text":"in 3 days"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"text":"in 3 days"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/date/relative-parse", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)مثال على الطلب
{
"text": "in 3 days"
}مثال على الاستجابة
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "date.relative_parse",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}الواجهة غير متزامنة: تستلم task_id فور الإرسال، ويمكنك الاستعلام عن الحالة بمعدل طلب واحد في الثانية.
الأسعار
السعر معلن كما تراه: لا tokens ولا نظام نقاط؛ وإن فشلت المهمة فلن تُحاسَب عليها.
الأخطاء
| HTTP | الرمز | المعنى |
|---|---|---|
401 | unauthorized | مفتاح الوصول مفقود أو غير صالح؛ تحقق من ترويسة Bearer في طلبك. |
402 | insufficient_balance | رصيدك لا يكفي لتنفيذ هذه المهمة؛ أعد شحن الرصيد ثم أعد المحاولة. |
404 | unknown_type | نوع المهمة المطلوب غير موجود في الكتالوج — راجع الاسم المرسل في الطلب. |
429 | rate_limited | تجاوزت الحد المسموح من الطلبات؛ انتظر قليلًا ثم أعد المحاولة. |
ملاحظات تقنية
كيف تعمل
تفسّر هذه الإمكانية العبارات النسبية المحدودة المكتوبة باللغة الإنجليزية أو باللغة الإسبانية، ثم تحوّلها إلى طوابع زمنية مطلقة بصيغة ISO-8601، تُحسب دائمًا بالنسبة إلى نقطة ارتساء تحددها أنت بنفسك. العملية الحسابية حتمية بالكامل وتُنفَّذ مجانًا داخل متصفحك باستخدام الدالة النقية نفسها التي تستعملها الواجهة البرمجية، بحيث تبقى النتائج متطابقة سواء كنت متصلًا بالإنترنت أو غير متصل. يجري التحقق من كل مُدخَل قبل أي عملية حسابية، ولذلك تُبلَّغ الأنواع غير الصحيحة فورًا عبر خطأ invalid_input واضح وثابت. وقبل دمج هذه الوظيفة في مسارات الإنتاج أو الاختبارات الآلية لديك، يُرجى الاطلاع بعناية على الأمثلة المرجعية الكاملة التي تغطي حالات النجاح ومسارات الخطأ معًا، وترتيب خطوات التحقق، والتكافؤ الدقيق بين المتصفح والواجهة البرمجية، والمعالجة الآمنة لقيم الفاصلة العائمة الخارجة عن الحدود المسموح بها في هذه الصيغة تحديدًا.
المدخلات والمخرجات
أما القيم الوسيطة الكبيرة جدًا التي تتجاوز دقة معيار IEEE-754 فتُنتج خطأً صريحًا بتجاوز النطاق بدلًا من قيمة فارغة صامتة، وهو ما يجنّبك المفاجآت غير السارّة في الحسابات اللاحقة التي تعتمد على هذه النتيجة.
الحالات الحدية والقيود
راجع دائمًا الأمثلة المتاحة بعناية قبل الدمج، فهي توثّق بدقة ترتيب خطوات التحقق، والتكافؤ الكامل بين المتصفح والواجهة البرمجية، وسلاسل مطابقة الأخطاء الثابتة المخصصة لإصدار الشهادات، والمعالجة الآمنة لقيم الفاصلة العائمة الواقعة خارج الحدود التي تسمح بها هذه الصيغة.
حالات التكامل
الأتمتة
الدالة النقية نفسها في الأداة والواجهة البرمجية.
أسئلة تقنية
هل هي مجانية؟
نعم، الفئة A مباشرة في المتصفح.
مُدخَل غير صالح؟
خطأ invalid_input مع مطابقة واضحة.
هل هي مستقرة؟
أمثلة حتمية تثبّت العقد.
المؤلف؟
samurai.