حساب إجمالي ساعات العمل بعد خصم الاستراحات

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

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

قدّموا صفًا واحدًا لكل فترة عمل متصلة. يحتاج كل صف إلى تاريخ ووقت clock_in وتاريخ ووقت clock_out مكتوبين بصيغة ISO 8601، مع الثواني والرمز Z أو إزاحة UTC رقمية مثل -04:00. الإزاحة ضرورية لأن الوقت المحلي وحده قد لا يحدد لحظة واحدة أثناء تغييرات التوقيت. أضيفوا break_minutes عندما تتضمن النوبة استراحة غير مدفوعة، واتركوا الحقل إذا لم يكن هناك خصم. يمكن إدخال دقائق الاستراحة بقيمة عشرية، وهذا مفيد إذا كان النظام المصدر يسجل أجزاء الدقيقة. يجوز أن يكون الخروج في اليوم التقويمي التالي، ولذلك لا تحتاج النوبات الليلية إلى وضع خاص. ترفض الحاسبة التواريخ المستحيلة، والإزاحات الناقصة، والخروج الذي لا يلي الدخول، والاستراحات السالبة، والاستراحة الأطول من مدة النوبة. كما ترفض النوبات المتداخلة بعد توحيدها وفق UTC، لأن احتسابها معًا سيزيد المجموع من دون تنبيه. إن إدخال كل صف بوضوح يجعل البيانات قابلة للتدقيق، ويمنع افتراض سياسات استراحة الطعام أو قواعد التقريب أو اعتبار الفجوات بين النوبات استراحات تلقائيًا.

افهموا طريقة إجراء الحساب وفق UTC

يُفسَّر كل طابع زمني بوصفه قيمة في التقويم الميلادي، ثم يُحوَّل إلى موضع بالمللي ثانية وفق UTC باستخدام الإزاحة المكتوبة. لا يستشير الحساب المنطقة الزمنية للجهاز، ولا قاعدة بيانات للمناطق الزمنية، ولا التاريخ الحالي، ولا أي خدمة خارجية. في كل صف صالح، تساوي المدة الإجمالية لحظة الخروج وفق UTC مطروحًا منها لحظة الدخول وفق UTC. تُحوَّل مدة الاستراحة المدخلة من دقائق إلى مللي ثوانٍ، ثم تُطرح من المدة الإجمالية لذلك الصف. بعد ذلك تُجمع المدد الإجمالية والاستراحات كلٌّ على حدة قبل إنتاج الصافي النهائي. يضمن هذا الترتيب نتائج ثابتة للفرق التي تستخدم سجلات بإزاحات مختلفة، وكذلك للنوبات التي تتجاوز منتصف الليل. تتضمن النتيجة total_hours لصافي وقت العمل، وtotal_minutes للأنظمة التي تفضّل الدقائق، وgross_hours قبل الخصومات، وbreak_minutes لإجمالي الخصم، وshift_count للمطابقة. لا تُقرّب قيم الساعات والدقائق إلى ست منازل عشرية إلا عند إخراج النتيجة، بينما يبقى الجمع الداخلي بالمللي ثانية الصحيحة. لذلك تعطي المدخلات نفسها ملف JSON نفسه مهما اختلفت لغة المتصفح أو موقع الخادم.

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

تفصل الحقول المعادة بين نشاط التسجيل الأصلي والمدة النهائية المستحقة للدفع، مما يتيح للمراجع إعادة إجراء الحساب. قارنوا shift_count بعدد الصفوف المستوردة، وgross_hours بالفترة الإجمالية الخام، وbreak_minutes بالخصومات غير المدفوعة المتوقعة قبل اعتماد total_hours. لا تطبق هذه القدرة شرائح العمل الإضافي، أو قواعد الاستراحات المدفوعة، أو معدلات الأجور، أو سماحات الجداول، أو التقريب الخاص بجهة العمل. تختلف تلك السياسات باختلاف الاتفاق والقانون، لذا ينبغي تطبيقها في خطوة لاحقة موثقة بوضوح. كذلك لا تستنتج الحاسبة الاستراحات من الفجوات بين صفوف منفصلة؛ فالخصم يقتصر على قيم break_minutes التي تقدمونها. وبذلك تصلح الدالة مكوّنًا حتميًا لإعداد الرواتب، وفواتير المتعاقدين، وتقارير وقت المشروعات، ومطابقة الحضور من دون تضمين سياسة خفية. يمكنكم تشغيلها مجانًا في المتصفح لإجراء فحص فردي، بينما تبلغ كلفة الأتمتة عبر API مقدار $0.002 لكل طلب. ولعمليات الاستيراد القابلة للتكرار، احتفظوا بسلاسل ISO الأصلية وإزاحاتها مع الملخص المعاد، حتى يمكن تتبع أي مجموع محل نزاع وصولًا إلى اللحظات والخصومات الدقيقة المستخدمة.