إضافة دقائق إلى تاريخ ووقت

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

أدخلوا لحظة بداية كاملة لا تحتمل الالتباس

أدخلوا قيمة البداية كتاريخ ووقت بصيغة ISO يشتملان على تاريخ تقويمي، والفاصل T، والساعات والدقائق والثواني، ومحدد صريح للمنطقة الزمنية. القيمة المنتهية بالحرف Z تصف UTC أصلًا. أما القيمة المنتهية بإزاحة مثل +02:00 أو -05:30 فتصف حقول الساعة المحلية مع فرقها الدقيق عن UTC. إن اشتراط هذه اللاحقة يمنع سببًا شائعًا لأخطاء الجدولة، وهو الوقت المحلي المجرد الذي يتغير معناه بحسب الحاسوب أو المتصفح أو الخادم الذي يفسره. يُفحص جزء التاريخ وفق قواعد التقويم الغريغوري للسنوات الكبيسة وأطوال الأشهر، ولذلك تُرفض التواريخ المستحيلة بدل تعديلها بصمت. يجب أن تقع الساعات بين 00 و23، والدقائق والثواني بين 00 و59. ويمكن أن تتكون كسور الثانية الاختيارية من رقم واحد إلى ثلاثة أرقام، وتُحفظ بوصفها جزءًا من اللحظة. لا تقبل القدرة أسماء مناطق مثل Europe/London لأنها تحتاج إلى قواعد تاريخية وقد تُحدث التباسًا بسبب التوقيت الصيفي. استخدموا بدلًا منها إزاحة تحدد اللحظة المقصودة بوضوح.

افهموا آلية إضافة الدقائق والتحويل إلى UTC

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

استخدموا النتيجة بأمان في الأتمتة والاختبارات

تلائم هذه القدرة مسارات العمل التي تعرف لحظة البداية مسبقًا وتحتاج إلى طابع زمني مشتق قابل لإعادة الإنتاج. يمكنكم مثلًا إنشاء تذكير بعد ثلاثين دقيقة من حدث، أو حساب موعد نهائي لفترة سماح ثابتة، أو تحويل السجلات المستوردة من إزاحاتها المعلنة إلى UTC، أو إعداد حالات اختبار حول منتصف الليل والأيام الكبيسة. يتضمن الكائن المعاد التاريخ والوقت الأصليين بعد إزالة المسافات الطرفية، وعدد الدقائق الصحيح المطبع، والنتيجة المزاحة، ووسم UTC صريحًا. خزّنوا حقل النتيجة أو قارنوه عندما يتوقع نظام آخر طابعًا زمنيًا قياسيًا. تذكروا أن هذا حساب للدقائق المنقضية، وليس جدولة مدنية بحسب منطقة مسماة. فإضافة ستين دقيقة تضيف دائمًا 3,600 ثانية بالضبط، ولا تستشير انتقالات التوقيت الصيفي أو تقاويم العمل. إذا كان يجب أن يبقى موعد بشري على ساعة الحائط نفسها بعد تغير إزاحة إقليمية، فحددوا المنطقة والإزاحة المقصودة قبل استدعاء القدرة. يعيد الإدخال غير الصالح خطأً نمطيًا يتيح تصحيح الطلب. تبلغ كلفة التنفيذ عبر API مقدار $0.002 لكل عنصر، بينما يستخدم المتصفح الحساب النقي نفسه.