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

حاسبة رقم أسبوع ISO

أدخل تاريخًا واعرف أسبوعه وفق ISO: يوم 2024-01-01 هو الأسبوع 1 من 2024، أما 2021-01-01 فما زال في الأسبوع 53 من 2020. وتظهر سنة الأسبوع مع الرقم حتى لا تختلط أيام ديسمبر ويناير. مجاني في متصفحك.

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

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

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

مثال محلول

إذا أدخلت

التاريخ: 2024-01-01

تحصل على

السنة: 2,024
الشهر: 1
اليوم: 1
أسبوع ISO: 1

تأخذ حاسبة رقم أسبوع ISO هذه تاريخًا ميلاديًّا واحدًا بصيغة YYYY-MM-DD وتُرجع رقم أسبوعه وفق ISO-8601 مع سنة ترقيم الأسبوع التي تنتمي إليها هاتان القيمتان. تبدأ أسابيع ISO دائمًا يوم الاثنين وتنتهي يوم الأحد، والأسبوع الأول من السنة هو الأسبوع الذي يحتوي أول خميس فيها — ولهذا كثيرًا ما يذكر أواخر ديسمبر وأوائل يناير سنة أسبوع تختلف عن السنة المدنية على التقويم. من الفحوص الكلاسيكية: 2024-01-01 يقابل الأسبوع 1 من 2024، و2021-01-01 يقابل الأسبوع 53 من 2020. يستخدم المحرك حسابًا تقويميًّا حتميًّا بأعداد صحيحة فقط: تُحسَب السنوات الكبيسة وأطوال الأشهر واليوم الترتيبي من السنة ويوم أسبوع ISO دون نداءات شبكة أو أخذ عيّنات عشوائية أو الاعتماد على ساعة الجهاز.

ما هو رقم أسبوع ISO وماذا تحتوي الاستجابة

تجيب تواريخ أسبوع ISO-8601 عن سؤال مختلف عن تقاويم الشهر واليوم: فهي تحدّد موضع يوم داخل أسبوع يبدأ من الاثنين ومُرقَّم من 1 إلى 52 أو 53 داخل سنة ترقيم أسبوعية. يُعرَّف الأسبوع الأول بأنه الأسبوع الذي يحتوي أول خميس من السنة، وهو ما يعادل الأسبوع الذي يحتوي 4 يناير. بسبب هذه القاعدة، يمكن أن ينتمي 29 ديسمبر حتى 3 يناير إلى سنة الأسبوع السابقة أو التالية حتى لو ذكرت السنة المدنية على الفاتورة الرقم القديم أو الجديد.

من الحالات المرفوضة: غياب date، أو صيغة خاطئة مثل 2024/01/01، أو أشهر مستحيلة، وأيام غير موجودة مثل 2023-02-29. إن احتجت حقب يونكس الزمنية، أو التحليل متعدّد الصيغ، أو حساب أيام العمل، فاستخدم الأدوات المخصّصة لذلك؛ هذه الصفحة تجيب فقط عن رقم أسبوع ISO وسنة الأسبوع لتاريخ تقويمي مُتحقَّق منه.

كيف يُقرأ التاريخ وكيف يبقى الأسبوع قابلًا لإعادة الإنتاج

يجب أن تطابق السلسلة أربعة أرقام، ثم شرطة، ثم رقمَين، ثم شرطة أخرى، ثم رقمَين؛ تُزال المسافات البادئة أو اللاحقة، لكن التواريخ الجزئية أو يوم السنة الترتيبي وحده أو أسماء الأشهر لا تُوسَّع هنا. بعد التحليل، يجب أن تقع السنة بين 1 و9999، والشهر بين 1 و12، واليوم بين 1 والطول الحقيقي لذلك الشهر في تلك السنة، مع اتّباع السنوات الكبيسة قاعدة الميلادي: القابلية للقسمة على أربعة إلا سنوات القرن غير القابلة للقسمة على أربعمئة.

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

أين تفيد أرقام أسابيع ISO في التخطيط والتقارير والبرمجيات

تستخدم فرق العمليات والمالية أرقام أسابيع ISO حين يجب أن تتّسق وتيرة أسبوعية عبر دول لا تبدأ الأسبوع جميعها يوم الأحد: تستفيد جداول التصنيع وحزم البيع بالتجزئة وتسميات دورات أجايل والتقارير القانونية التي تذكر الأسبوع من السنة كلها من معرّف أسبوع واحد لا لبس فيه. يستدعي المطوّرون العقد نفسه من النصوص البرمجية لختم دلاء السجلّات، أو لتوليد متجهات اختبار حتمية لأنظمة الرواتب وأوراق الوقت، أو لتلبية متطلّبات منتج تتطلّب تسميات من W01 حتى W53 بدل ترقيم أسبوعي محلّي مرتجل.

يستخدم المعلّمون وكاتبو المعايير الأداة لعرض تواريخ الحدود مثل 2005-01-01 في الأسبوع 53 من 2004 مقابل 2005-01-03 في الأسبوع 1 من 2005 دون الاعتماد على أرقام تسلسلية لجداول البيانات تختلف بين إكسل وISO. اقرنها بتحويل الحقبة الزمنية أو تطبيع التاريخ حين تحتاج خطوات تقويمية ذات صلة، وبمساعدات حتمية مجانية أخرى عند بناء مختبر صغير من أدوات التاريخ.

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

تسميات التقارير الأسبوعية

اختم لوحات القيادة وحزم البيع بالتجزئة وتقارير العمليات بأزواج أسبوع ISO وسنة أسبوع ثابتة بدل أسابيع محلّية تعتمد على المنطقة.

فحوص الامتثال عند حدود السنة

تحقّق من تواريخ أواخر ديسمبر وأوائل يناير التي تنتمي إلى سنة الأسبوع السابقة أو التالية قبل إقفال الحسابات أو تقديم إحصاءات مبنية على الأسبوع.

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

كيف يُعرَّف رقم أسبوع ISO؟

تجري الأسابيع من الاثنين إلى الأحد. الأسبوع 1 هو الأسبوع الذي يحتوي أول خميس من السنة (الأسبوع الذي يحتوي 4 يناير). قد تستخدم النتيجة سنة أسبوع تختلف عن السنة المدنية.

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

لا. تطابِق فقط تاريخًا تقويميًّا مُتحقَّقًا منه بحقول أسبوع ISO بحساب حسابي بحت. لا يوجد كائن Date، ولا إزاحة منطقة زمنية، ولا اعتماد على «اليوم».

لماذا يقع 1 يناير 2021 في الأسبوع 53 من 2020؟

لأن الأسبوع الأول من السنة هو الذي يضم أول خميس فيها، ويأتي 1 يناير 2021 قبله. لذلك يبقى هذا اليوم في آخر أسبوع من 2020، وهو الأسبوع 53.

ماذا يعرض الناتج إلى جانب رقم الأسبوع؟

يعرض رقم يوم الأسبوع من 1 للاثنين إلى 7 للأحد مع اسمه، ورمزًا قصيرًا مثل 2024-W01، وعدد أسابيع سنة الأسبوع تلك، وترتيب اليوم في السنة.

ما التواريخ التي لا تقبلها الحاسبة؟

لا تقبل تواريخ غير موجودة مثل 2023-02-29، ولا أي كتابة بغير صيغة سنة-شهر-يوم بشرطات مثل 2024/01/01. ويجب أن تكون السنة بين 1 و9999.

أدوات ذات صلة

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

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

الـEndpoint

POSThttps://api.kit.forhosting.com/date/iso-week-number

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

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

curl -X POST https://api.kit.forhosting.com/date/iso-week-number \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date":"2024-01-01"}'

const res = await fetch("https://api.kit.forhosting.com/date/iso-week-number", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "date": "2024-01-01"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/date/iso-week-number",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "date": "2024-01-01"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/date/iso-week-number", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"date":"2024-01-01"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"date":"2024-01-01"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/date/iso-week-number", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

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

{
  "date": "2024-01-01"
}

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

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

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

الأسعار

لكل طلب$0.002

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

الحدود

`year_min`	1
`year_max`	9999

الأخطاء

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

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

استخدمها مجانًا في المتصفح للتخطيط والرواتب وأوراق العمل الامتثالية، أو استدعِ واجهة برمجة التطبيقات مقابل $0.002 لكل طلب ناجح حين تحتاج تسميات أسبوعية ثابتة قابلة لإعادة الإنتاج في التكامل المستمر أو خطوط أنابيب التقارير أو ميزات المنتج.

ما هو رقم أسبوع ISO وماذا تحتوي الاستجابة

تقبل هذه الحاسبة حقلًا واحدًا مطلوبًا، date، كسلسلة صارمة YYYY-MM-DD، وتتحقّق من أن اليوم موجود فعلًا في التقويم الميلادي — بما في ذلك 29 فبراير فقط في السنوات الكبيسة والطول الصحيح لكل شهر — ثم تُرجع التاريخ المُطبَّع، والسنة والشهر واليوم المدنيَّين، ورقم أسبوع ISO كـ iso_week، وسنة ترقيم الأسبوع كـ iso_week_year، ويوم أسبوع ISO من 1 للاثنين حتى 7 للأحد مع اسم مقروء، وسلسلة مختصرة iso_week_string مثل 2020-W53، وعدد الأسابيع التي تحتويها سنة الأسبوع تلك، والترتيب اليوم من السنة، وتذكيرًا مختصرًا بالصيغة. لا يوجد تحويل منطقة زمنية، ولا يوم بداية أسبوع يعتمد على المنطقة، ولا تقريب عائم: فإما أن يكون الإدخال يومًا تقويميًّا حقيقيًّا وتكون حقول الأسبوع محدَّدة تمامًا، أو يفشل الطلب برمز invalid_input.

كيف يُقرأ التاريخ وكيف يبقى الأسبوع قابلًا لإعادة الإنتاج

الحقل المفضّل هو date، لكن الأسماء البديلة iso_date وd وvalue مقبولة كي تستطيع جداول البيانات وسلاسل الاستعلام والنماذج المُكتَّبة إعادة استخدام العقد نفسه دون إعادة تسمية الأعمدة. اقرن التشغيل المجاني في المتصفح بالواجهة البرمجية المدفوعة حين تحتاج وسم الأسبوع نفسه داخل خط أنابيب آلي.

أين تفيد أرقام أسابيع ISO في التخطيط والتقارير والبرمجيات

يتجنّب المحلّلون الذين يبنون لوحات مقارنة سنة بسنة الخطأ الكلاسيكي بفارق واحد حيث تنتمي أيام يناير الأولى إلى الأسبوع 52 أو 53 من سنة الأسبوع السابقة إذا خزّنوا كلًّا من iso_week وiso_week_year بدل السنة المدنية وحدها. تعمل هذه الصفحة كليًّا داخل متصفحك؛ وعبر الواجهة البرمجية يكلّف كل استعلام ناجح $0.002، ولا تُحتسب رسوم على التحقّق الفاشل، ولا يُحفَظ شيء بعد إعادة الاستجابة. هذا الفصل — استكشاف تفاعلي مجاني وواجهة برمجية مدفوعة مطابقة له — يواكب بقية كتالوج الفئة A في KIT، ويتيح لك الانتقال من فحص لمرّة واحدة إلى خط أنابيب دون أن تتغيّر النتيجة الرياضية.

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

بيانات اختبار حتمية

أنشئ قيم iso_week وiso_week_string قابلة لإعادة الإنتاج لاختبارات الوحدة وفحوص الخصائص وتأكيدات التكامل المستمر دون انحراف Date.

أسئلة تقنية

كم تكلّف حاسبة رقم أسبوع ISO؟

هي مجانية في متصفحك على هذه الصفحة. عبر الواجهة البرمجية يكلّف الطلب الناجح $0.002؛ ولا تُحتسب رسوم على المدخلات غير الصالحة.

لماذا قد تختلف iso_week_year عن السنة التقويمية؟

غالبًا ما تقع التواريخ من نحو 29 ديسمبر حتى 3 يناير في آخر أسبوع من سنة الأسبوع السابقة أو الأسبوع 1 من التالية وفق قواعد ISO-8601.

ما صيغ التاريخ المقبولة؟

فقط تواريخ تقويمية صارمة بصيغة YYYY-MM-DD. تُرفَض قيم مثل 2024/01/01 أو 01-01-2024 أو 2023-02-29 (غير كبيسة) برمز invalid_input.

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

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

مثال محلول

ما هو رقم أسبوع ISO وماذا تحتوي الاستجابة

كيف يُقرأ التاريخ وكيف يبقى الأسبوع قابلًا لإعادة الإنتاج

أين تفيد أرقام أسابيع ISO في التخطيط والتقارير والبرمجيات

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

تسميات التقارير الأسبوعية

فحوص الامتثال عند حدود السنة

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

أدوات ذات صلة

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

الـEndpoint

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

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

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

الأسعار

الحدود

الأخطاء

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

ما هو رقم أسبوع ISO وماذا تحتوي الاستجابة

كيف يُقرأ التاريخ وكيف يبقى الأسبوع قابلًا لإعادة الإنتاج

أين تفيد أرقام أسابيع ISO في التخطيط والتقارير والبرمجيات

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

بيانات اختبار حتمية

أسئلة تقنية

شكرًا