Chevauchement d'horaires de travail

Vous envoyez six nombres — décalage, début et fin de l'équipe A et les trois mêmes de l'équipe B — et le solveur projette les deux fenêtres sur un cercle UTC de vingt-quatre heures, les intersecte et renvoie les minutes de chevauchement, les heures de chevauchement, la part de la journée de chaque équipe partagée en direct et un overlap_percent en tête égal à cent fois l'intersection sur la journée la plus courte.

Comment deux journées de travail deviennent un pourcentage de chevauchement

Les deux journées durent huit heures, donc la plus courte fait huit heures et overlap_percent vaut cent fois trois sur huit, soit trente-sept virgule cinq pour cent (37.5). La même identité figure sur chaque réponse réussie : utc égale local moins le décalage, modulo vingt-quatre heures ; le chevauchement est l'intersection des deux intervalles UTC sur un jour circulaire ; overlap_percent égale cent fois overlap_minutes divisé par le minimum de team_a_minutes et team_b_minutes. Les champs par équipe overlap_percent_a et overlap_percent_b prennent la durée propre comme dénominateur, de sorte qu'un poste de quatre heures entièrement inclus dans un poste de huit heures indique cent pour cent pour l'équipe courte et cinquante pour la longue, tandis que le chiffre en tête reste à cent parce que chaque minute de la journée la plus courte est concurrente.

Contrat d'entrée, champs de réponse et règles de validation

Les heures peuvent être fractionnaires. Envoyez par POST un objet JSON avec six nombres finis obligatoires. offset_a et offset_b sont des décalages UTC fixes en heures, chacun entre moins quatorze et plus quatorze inclus ; les alias comprennent utc_a, team_a_offset, a_offset et les noms équivalents de l'équipe B. start_a, end_a, start_b et end_b sont des heures d'horloge locale de zéro à vingt-quatre inclus ; les alias comprennent team_a_start, a_start, team_a_end, a_end et les noms équivalents de B. Lorsque end_a précède start_a, la fenêtre A enveloppe minuit ; la même règle s'applique à B. En cas de succès le corps répète les six entrées arrondies et des libellés de décalage tels que UTC−5, indique team_a_hours, team_b_hours, team_a_minutes et team_b_minutes, publie chaque fenêtre en UTC sous team_a_utc_start, team_a_utc_end, team_b_utc_start et team_b_utc_end avec les booléens team_a_wraps et team_b_wraps, et fournit overlap_minutes, overlap_hours, overlap_percent, overlap_percent_a, overlap_percent_b, overlap_windows comme tableau d'horloges UTC de début et de fin, same_window lorsque les deux intervalles UTC sont identiques, un message d'une ligne et la chaîne formula. Exemple : offset_a moins cinq, start_a neuf, end_a dix-sept, offset_b zéro, start_b neuf, end_b dix-sept donne trois heures de chevauchement, trente-sept virgule cinq pour cent (37.5) et une seule fenêtre UTC de 14:00 à 17:00. Une validation échouée — champs manquants, valeurs non finies, un décalage dont la valeur absolue dépasse quatorze, un début ou une fin hors de zéro à vingt-quatre, ou une journée de longueur nulle — renvoie invalid_input en nommant le champ et n'est jamais facturée. Les appels réussis coûtent le tarif de base publié $0.002 avec l'unité item.

Où un pourcentage de chevauchement d'horaires gagne sa place

Les équipes d'opérations RH utilisent un calculateur de pourcentage de chevauchement d'horaires lorsqu'elles rédigent des heures de collaboration commune pour une entreprise scindée en deux pôles : si New York et Londres ne partagent que trois heures sur huit, une politique qui exige quatre heures en direct n'est pas tenable sans allonger un côté. Les décalages invalides et les journées de longueur nulle ne consomment pas le solde. Conservez les décalages comme les nombres UTC± déjà imprimés sur les billets et les configurations serveur ; cet outil ne résout pas les noms IANA tels que America/New_York et n'applique pas les transitions d'heure d'été. Si une région change de décalage en mars, envoyez le nombre d'hiver ou d'été que vous visez réellement. Les modèles d'effectifs convertissent overlap_hours en sièges concurrents afin qu'un roster de support en relève solaire ne prétende pas qu'un matin de Tokyo et un matin de Californie sont le même quart. Les organisations commerciales et de succès client placent les appels récurrents dans l'intersection publiée comme overlap_windows plutôt que de deviner avec une horloge mondiale. Un langage contractuel qui promet une journée partagée minimale peut figer overlap_percent dans un test plutôt que dans une capture d'écran. Parce que l'implémentation est parse de niveau A, chaque appel réussi coûte le $0.002 publié, sans jetons de modèle ni réseau sortant. Associez des exemples pour enseigner : décalages et heures identiques renvoient cent pour cent et same_window true ; New York contre Londres de neuf à cinq renvoie trente-sept virgule cinq pour cent (37.5) ; Tokyo de neuf à dix-huit contre San Francisco de neuf à dix-huit renvoie une courte tranche consciente de l'enroulement ; un décalage de quinze démontre le chemin dur d'invalid_input. Épinglez overlap_percent et overlap_minutes dans les tests et vous obtenez une arithmétique de concurrence reproductible pour manuels, landings SEO et edge workers sans dresser votre propre base de fuseaux.