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

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

احسب رقم الأسبوع الأمريكي لأي تاريخ، بأسابيع من الأحد إلى السبت والأسبوع 1 هو الذي يضم 1 يناير: يقع 15 مارس 2024 في الأسبوع 11. وترى أيضًا عدد أسابيع السنة. مجاني في متصفحك.

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

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

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

مثال محلول

إذا أدخلت

التاريخ: 2024-03-15

تحصل على

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

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

قواعد الأسبوع الأمريكي مقابل أسابيع ISO وكيفية إرسال تاريخ

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

أسابيع ISO 8601 مختلفة: تبدأ يوم الاثنين، والأسبوع واحد هو أسبوع أول خميس في السنة، لذا قد يُطابق اليوم المدني نفسه فهرس أسبوع مختلفًا.

كيف يُحسب الرقم وما شكل التواريخ غير الصالحة

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

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

الاستخدامات الشائعة والحدود العملية

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

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

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

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

مسارات الموارد البشرية والرواتب التي تجمّع الساعات بأسابيع تبدأ الأحد تُعلّم كل فترة دفع برقم الأسبوع الأمريكي الذي يحتوي تاريخ العمل، بما يطابق توقعات WEEKNUM الشائعة في جداول البيانات.

تقاويم المدارس وتخطيط التجزئة

تقاويم المناطق وخطط التسويق غالبًا ترقّم الأسابيع مع 1 يناير في الأسبوع 1؛ حوّلوا تواريخ ISO إلى ذلك الفهرس للشرائح وملخصات البريد ونوافذ المخزون.

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

هل هذا هو نفسه رقم أسبوع ISO؟

لا. أسابيع ISO تبدأ يوم الاثنين وتعرّف الأسبوع 1 بقاعدة أول خميس. قد يعطي التاريخ المدني نفسه فهرسًا مختلفًا وفق قواعد ISO.

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

أمثلة: تنسيق YYYY-MM-DD خاطئ، 30 فبراير، أو 29 فبراير في سنة غير كبيسة. التحقق الفاشل لا يُحاسب.

هل يمكن أن تضم السنة 53 أسبوعًا؟

نعم. قد يقع 31 ديسمبر في الأسبوع 53، بحسب يوم الأسبوع الذي وقع فيه 1 يناير وما إذا كانت السنة كبيسة. ففي 2024 مثلًا يكون آخر أسبوع هو الأسبوع 53.

هل يمكن أن يبدأ الأسبوع 1 في ديسمبر؟

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

هل يبدأ الأسبوع يوم الأحد أم الاثنين؟

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

أدوات ذات صلة

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

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

الـEndpoint

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

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

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

curl -X POST https://api.kit.forhosting.com/date/us-week-number \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date":"2024-03-15","calendar":"valor-ejemplo"}'

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

import os, requests

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

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

body := bytes.NewBufferString(`{"date":"2024-03-15","calendar":"valor-ejemplo"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/date/us-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-03-15",
  "calendar": "valor-ejemplo"
}

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

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

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

تقبل حاسبة رقم الأسبوع الأمريكي هذه تاريخ تقويم ISO، وتطبّق حساب الكبيسة الغريغوري وصيغة يوم أسبوع خالصة، وتعيد فهرس الأسبوع مع حقائق يوم الأسبوع والسنة في JSON مستقر.

قواعد الأسبوع الأمريكي مقابل أسابيع ISO وكيفية إرسال تاريخ

أرسلوا سلسلة تاريخ بصيغة YYYY-MM-DD، أو حقول year وmonth وday المنظمة معًا. تُقبل أسماء بديلة مثل calendar وcalendar_date وiso_date لمسار السلسلة. تُرفض المدخلات المنظمة الجزئية دون الأجزاء الثلاثة بـ invalid_input حتى يصحّح المستدعي الجسم بدل تخمين القيم الناقصة. المدخلات المتطابقة تنتج دائمًا JSON متطابقًا لأن المسار لا يقرأ ساعة الجدار ولا الإعداد المحلي ولا الشبكة.

كيف يُحسب الرقم وما شكل التواريخ غير الصالحة

تفشل التواريخ المستحيلة مثل الحادي والثلاثين من أبريل أو الثلاثين من فبراير أو التاسع والعشرين من فبراير في سنة غير كبيسة بـ invalid_input ورسالة تذكر الطول الحقيقي للشهر. تعيد الاستجابة week_starts مساويًا Sunday وweek_1_rule مساويًا contains_january_1 وweeks_in_year مساويًا لأسبوع الولايات المتحدة في الحادي والثلاثين من ديسمبر حتى تعرض لوحات المتابعة نطاق السنة دون استدعاء ثانٍ.

استخدام API والتسعير وسير العمل والحدود العملية

أرسلوا جسم JSON مع date بصيغة YYYY-MM-DD، أو مع year وmonth وday كأعداد صحيحة ضمن النطاقات المنشورة. عند النجاح يتضمن الحمولة التاريخ المطبّع والمكوّنات المنظمة وday_of_year وday_of_week من صفر للأحد إلى ستة للسبت مع اسم إنجليزي وweek_number وweeks_in_year وis_leap_year وcalendar مساويًا gregorian وmethod مساويًا us_week_number للموجّهات والاختبارات التي تتفرع على التسميات. استخدموا API المدفوعة مسبقًا عندما يحتاج تصدير رواتب أو تقويم مدرسي أو أداة تخطيط تجزئة أو SDK إلى عقد مستقر تحت رصيد KIT بسعر $0.002 لكل عنصر ناجح؛ لا تستهلك إخفاقات التحقق الرصيد بعد رفض المحرك.

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

تكافؤ جداول البيانات في واجهات API

الخدمات التي يجب أن تطابق أرقام الأسبوع القائمة على الأحد في Excel أو Google Sheets تعرض حقل JSON مستقرًا بدل إعادة تنفيذ حساب يوم الأسبوع في كل لغة عميل.

أسئلة تقنية

كيف أحصل على رقم الأسبوع الأمريكي لتاريخ؟

أرسلوا JSON مع date مضبوطًا على سلسلة ISO مثل 2024-03-15، أو year وmonth وday. تتضمن الاستجابة week_number وday_of_week_name.

هل تبدأ الأسابيع يوم الأحد أم الاثنين؟

الأحد. تستخدم هذه الحاسبة الاتفاقية الأمريكية: week_starts دائمًا Sunday، والأسبوع 1 هو الذي يحتوي 1 يناير.

هل حاسبة رقم الأسبوع الأمريكي مجانية؟

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

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

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

مثال محلول

قواعد الأسبوع الأمريكي مقابل أسابيع ISO وكيفية إرسال تاريخ

كيف يُحسب الرقم وما شكل التواريخ غير الصالحة

الاستخدامات الشائعة والحدود العملية

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

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

تقاويم المدارس وتخطيط التجزئة

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

أدوات ذات صلة

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

الـEndpoint

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

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

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

الأسعار

الأخطاء

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

قواعد الأسبوع الأمريكي مقابل أسابيع ISO وكيفية إرسال تاريخ

كيف يُحسب الرقم وما شكل التواريخ غير الصالحة

استخدام API والتسعير وسير العمل والحدود العملية

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

تكافؤ جداول البيانات في واجهات API

أسئلة تقنية

شكرًا