تقدم السنة ٪
يمثل 1 يوليو 2024 نسبة 50% من السنة تمامًا: فهو اليوم 183 من 366، ويتبقى 183 يومًا. أدخل أي تاريخ لتغذية شريط تقدم أو متابعة أهداف سنوية أو خطة موسمية بالرقم نفسه. مجاني في متصفحك.
- مجاني
- يعمل في متصفحك
- دون تسجيل
- بياناتك لا تغادر جهازك
شغّل الأداة مجانًا
مثال محلول
- التاريخ
- 2024-07-01
- السنة
- 2,024
- الشهر
- 7
- اليوم
- 1
- يوم السنة
- 183
تقدم السنة هو حصة السنة المدنية التي انقضت بالفعل في تاريخ مدني معيّن، مُعبَّرًا عنها كنسبة مئوية من فوق الصفر بقليل في الأول من يناير حتى مئة في الحادي والثلاثين من ديسمبر. لوحات المنتجات ومتتبعات الأهداف السنوية وتقويمات التسويق الموسمي وأدوات الإنتاجية الشخصية كلها تحتاج ذلك الرقم دون صراع مع مناطق المضيف أو جداول التوقيت الصيفي. تقبل هذه الحاسبة تاريخ تقويم ISO واحدًا بالصيغة الصارمة سنة-شهر-يوم بأربعة أرقام ورقمين ورقمين، وتتحقق من وجود اليوم فعليًا في التقويم الغريغوري بما في ذلك فبراير في السنوات الكبيسة، وتحسب ترتيب يوم السنة، وتعيد النسبة المئوية المساوية لمئة مضروبة في ذلك الترتيب مقسومًا على ثلاثمائة وخمسة وستين أو ثلاثمائة وستة وستين. تتضمن الاستجابة أيضًا الأيام المتبقية والنسبة المتبقية وعلامة كبيسة وطول السنة لتبقى أشرطة التقدم والعدّ التنازلي متسقة. التواريخ المستحيلة مثل 29 فبراير في سنة عادية أو 31 أبريل تفشل بخطأ تحقق واضح بدل التفاف صامت.
كيف تُحسب نسبة تقدم السنة من تاريخ ISO
ابدأوا بتاريخ تقويم مكتوب كسنة وشهر ويوم بالصيغة الدولية ISO مع شرطات وعروض ثابتة ليتفق كل عميل على نفس الأعداد الصحيحة الثلاثة. أكّدوا أولًا أن السنة ضمن نطاق غريغوري عملي وأن الشهر بين واحد واثني عشر. ثم طبّقوا قاعدة الكبيسة التي تستخدمها التقاويم المدنية عالميًا: السنة كبيسة إذا قُسمت على أربعة، إلا أن سنوات القرن كبيسة فقط إذا قُسمت أيضًا على أربعمائة.
تجعل هذه القاعدة 29 فبراير قانونيًا في سنوات مثل 2024 و2000 وغير قانوني في 2023 و1900. مع معرفة حالة الكبيسة، راجعوا طول كل شهر لتلك السنة وارفضوا أي يوم يتجاوز طول الشهر، مثل 31 أبريل أو 30 فبراير. عند صلاحية الثلاثي، اجمعوا أطوال كل شهر كامل قبل الشهر المعطى ثم أضيفوا يوم الشهر للحصول على ترتيب يوم السنة.
الأول من يناير دائمًا واحد، والأول من مارس واحد وستون في سنة كبيسة وستون في سنة عادية، والحادي والثلاثون من ديسمبر ثلاثمائة وستة وستون أو ثلاثمائة وخمسة وستون. تُعرَّف نسبة تقدم السنة بأنها مئة مضروبة في يوم السنة مقسومًا على طول السنة، فيكون آخر يوم في السنة مئة بالمئة تمامًا والأيام السابقة تتدرج خطيًا. الأيام المتبقية تساوي طول السنة ناقص يوم السنة، والنسبة المتبقية هي الكسر المكمل مضروبًا في مئة.
أين تظهر حاسبات تقدم السنة في العمل الحقيقي
ترسم فرق المنتج والنمو أشرطة تقدم سنوية لـOKR وأهداف الإيرادات وتقويمات المحتوى وتحتاج نسبة موثوقة تطابق التواريخ المدنية بدل كسور epoch يونكس التي تتجاهل أيام الكبيسة. تتابع الموارد البشرية والمالية سياسات الإجازات ونوافذ التقارير المالية ومواعيد التدريب كحصة من السنة لتبقى اللوحات مقروءة لغير المهندسين. يجدول التسويق حملات موسمية بسؤال أي نسبة من السنة قد انقضت عندما يُثبَّت تاريخ الإطلاق.
البرمجيات التي يجب أن تبقى حرة من مكتبات المناطق الزمنية ما زالت تحتاج نسبة تقويم خالصة لنوافذ الصيانة وتقويمات الامتثال وwidgets الإنتاجية الشخصية المعرّفة بتواريخ مدنية. إن احتجتم لاحقًا لترتيب يوم السنة وحده دون نسبة، أو عدّ أيام العمل بين تاريخين، أو العمر من تاريخ الميلاد، أو أرقام يوم يولياني كاملة، أو ترقيم أسبوع السنة تحت ISO 8601، فاعاملوها كنيات بحث وصفحات هبوط منفصلة بدل إثقال صفحة نسبة تقدم السنة.
حالات الاستخدام
لوحات OKR والأهداف السنوية
حوّلوا أي تاريخ ISO إلى ٪ السنة المنقضية لتبقى أشرطة التقدم وتسميات النسبة المتبقية واعية بالكبيسة بلا مناطق المضيف.
تقويمات التسويق الموسمي
اربطوا تواريخ إطلاق الحملات بنسب تقدم السنة لعروض التخطيط والمحفزات الموسمية الآلية.
الأسئلة الشائعة
هل تغيّر السنة الكبيسة النسبة؟
نعم. السنوات الكبيسة فيها 366 يومًا، فنفس الشهر-اليوم بعد فبراير يُربَط بنسبة مختلفة عن السنة العادية. 29 فبراير يُقبل فقط في السنوات الكبيسة.
ماذا لو كان التاريخ غير صالح؟
الشكل الخاطئ أو الشهر خارج النطاق أو أيام مستحيلة مثل 2023-02-29 تُرفض ولا تُحاسب.
هل هذا مثل يوم السنة؟
لا. يوم السنة يعيد الترتيب 1–366. هذه القدرة تعيد النسبة المنقضية من السنة (والنسبة المتبقية)، وهي نية بحث مختلفة رغم أن كليهما يستخدم رياضيات التقويم.
كيف تُحسب نسبة تقدم السنة؟
يُقسم ترتيب اليوم في السنة على عدد أيام تلك السنة، أي 365 أو 366، ثم يُضرب في 100. لهذا يعطي 31 ديسمبر دائمًا 100% بالضبط.
هل تعرض النتيجة ما تبقى من السنة؟
نعم. إلى جانب النسبة المنقضية تظهر الأيام المتبقية والنسبة المتبقية. في 1 يوليو 2024 يتبقى 183 يومًا و50%، وفي 31 ديسمبر لا يتبقى شيء.
أدوات ذات صلة
للمطوّرين — الوصول عبر API
كل ما في هذه الصفحة متاح برمجيًا. هذا القسم موجّه للفرق التقنية التي تريد ربط الأداة بأنظمتها الخاصة؛ بقية المستخدمين يمكنهم استخدام الأداة أعلاه مباشرة دون الحاجة لقراءة ما يلي.
الـEndpoint
صادِق على طلبك بترويسة Bearer، وأرسل طلب POST واحدًا لتدخل مهمتك قائمة التنفيذ فورًا؛ ثم تستلم النتيجة عبر webhook أو رابط موقّع.
استدعِ الخدمة من بيئتك
curl -X POST https://api.kit.forhosting.com/date/year-progress \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"date":"2024-07-01"}'const res = await fetch("https://api.kit.forhosting.com/date/year-progress", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"date": "2024-07-01"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/date/year-progress",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"date": "2024-07-01"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/date/year-progress", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"date":"2024-07-01"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"date":"2024-07-01"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/date/year-progress", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)مثال على الطلب
{
"date": "2024-07-01"
}مثال على الاستجابة
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "date.year_progress",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}الواجهة غير متزامنة: تستلم task_id فور الإرسال، ويمكنك الاستعلام عن الحالة بمعدل طلب واحد في الثانية.
الأسعار
السعر معلن كما تراه: لا tokens ولا نظام نقاط؛ وإن فشلت المهمة فلن تُحاسَب عليها.
الأخطاء
| HTTP | الرمز | المعنى |
|---|---|---|
401 | unauthorized | مفتاح الوصول مفقود أو غير صالح؛ تحقق من ترويسة Bearer في طلبك. |
402 | insufficient_balance | رصيدك لا يكفي لتنفيذ هذه المهمة؛ أعد شحن الرصيد ثم أعد المحاولة. |
404 | unknown_type | نوع المهمة المطلوب غير موجود في الكتالوج — راجع الاسم المرسل في الطلب. |
429 | rate_limited | تجاوزت الحد المسموح من الطلبات؛ انتظر قليلًا ثم أعد المحاولة. |
ملاحظات تقنية
كيف تُحسب نسبة تقدم السنة من تاريخ ISO
المسار كله حساب صحيح وعشري حتمي بلا بذور عشوائية وبلا طوابع ساعة حائط وبلا كائن Date في JavaScript وبلا نداءات شبكة، فتعطي المدخلات المتطابقة دائمًا نفس JSON.
ما ترسلونه وما تستلمونه
أرسلوا حقل سلسلة إلزاميًا باسم date يحتوي يوم تقويم ISO صارم مثل 2024-07-01. الأيام التي تطابق النمط وليست تواريخ تقويم حقيقية —بما في ذلك 29 فبراير غير الكبيس وأشهر خارج واحد إلى اثني عشر— تفشل أيضًا برسالة تسمّي المشكلة ليصحح العملاء الإدخال دون تخمين. تشمل الفحوصات الكلاسيكية الأول من يناير قرب صفر فاصلة سبعة وعشرين بالمئة في سنة عادية، والأول من يوليو قرب منتصف السنة مع إزاحة يوم واحد بين الكبيسة والعادية، والحادي والثلاثين من ديسمبر مئة بالمئة تمامًا. الحقول الناقصة والقيم غير السلسلية والسلاسل التي لا تطابق نمط أربعة-اثنين-اثنين أرقامًا تفشل بـinvalid_input ولا تُحاسب. عند النجاح تعيد الاستجابة سلسلة التاريخ المطبّعة ومكوّنات السنة والشهر واليوم العددية والعدد الصحيح day_of_year من واحد إلى ثلاثمائة وخمسة وستين أو ثلاثمائة وستة وستين وboolean is_leap_year وdays_in_year كثلاثمائة وخمسة وستين أو ثلاثمائة وستة وستين وremaining_days حتى آخر يوم في تلك السنة وpercent ككسر السنة المنقضي مضروبًا في مئة وremaining_percent كالكسر المكمل مضروبًا في مئة وسلسلة formula قصيرة توثّق قاعدة الكبيسة وتعريف النسبة. تسعير استدعاءات API الناجحة هو الأساس المنشور $0.002 لكل عنصر؛ إخفاقات التحقق لا تستهلك الرصيد المدفوع مسبقًا.
أين تظهر حاسبات تقدم السنة في العمل الحقيقي
ولأن هذه القدرة محرك parse خالص، تسعير API هو الأساس المنشور $0.002 لكل عنصر ناجح والتحقق الفاشل لا يستهلك الرصيد.
حالات التكامل
الامتثال ومتتبعات الإجازات
اختموا السياسات السنوية بنسبة مستقرة وremaining_days من مدخلات YYYY-MM-DD صارمة، مع invalid_input واضح عند التواريخ السيئة.
أسئلة تقنية
كيف تُحسب نسبة تقدم السنة؟
percent = 100 × day_of_year / days_in_year، حيث day_of_year هو الترتيب من 1 لتاريخ ISO وdays_in_year هو 365 أو 366 وفق قواعد الكبيسة الغريغورية. 31 ديسمبر دائمًا 100% تمامًا.
كم التكلفة؟
أداة المتصفح مجانية وتعمل محليًا. طلبات API تستخدم رصيد KIT المدفوع مسبقًا بسعر $0.002 لكل عنصر ناجح؛ الإدخال غير الصالح لا يُحاسب.