Temps écoulé

Le temps écoulé entre deux repères est l'intervalle d'horloge qui sépare deux dates ou heures explicites, rendu en jours entiers, heures restantes et minutes restantes. Quiconque cherche le temps entre deux dates a besoin de ce détail mixte pour un service, un vol, un séjour hospitalier ou une fenêtre de projet, non d'un âge civil en années-mois-jours ni d'un compte à rebours en direct avec des secondes restantes. Cet outil n'invente jamais l'instant présent via l'horloge de l'hôte.

Ce que le temps écoulé entre deux repères compte vraiment

Le temps écoulé entre deux repères est une durée d'horloge, non un âge civil ni un compte à rebours en direct. Le moteur prend deux instants validés, soustrait leurs comptes de secondes absolus, prend la valeur absolue afin que tout ordre soit licite, puis tronque l'intervalle en jours entiers de quatre-vingt-six mille quatre cents secondes, heures restantes de trois mille six cents secondes et minutes restantes de soixante secondes.

Un reliquat de cinquante-neuf secondes ne devient pas une minute : les minutes sont des minutes entières après retrait des jours et des heures, si bien que le triplet est toujours constitué d'entiers non négatifs, avec des heures de zéro à vingt-trois et des minutes de zéro à cinquante-neuf. Les valeurs date seule sont minuit de ce jour civil, donc du premier janvier au troisième janvier il y a deux jours, zéro heure et zéro minute.

Un datetime tel que le premier janvier à neuf heures jusqu'au deuxième janvier à dix heures trente donne un jour, une heure et trente minutes. Les valeurs horloge seule, comme neuf heures quinze et dix-sept heures quarante-cinq, restent sur un même jour anonyme et renvoient zéro jour plus les heures et minutes de cette journée. Des instants égaux renvoient zéro dans chaque composante et marquent direction comme zero.

Si la fin arrive avant le début, jours, heures et minutes restent la longueur écoulée absolue et direction vaut backward, si bien qu'une paire inversée n'échoue pas et n'invente pas une durée négative. La chaîne formatted joint les trois composantes en une ligne lisible, par exemple deux jours, deux heures, trente minutes, pour étiquettes et reçus.

Employez un voisin années-mois-jours lorsque la recherche est date à date en mois civils, un voisin de minutes signées lorsque le produit ne stocke qu'un entier, et un voisin de compte à rebours lorsque des secondes restantes doivent apparaître ; employez cette page lorsque la requête est le temps entre deux repères et que la réponse doit être jours, heures et minutes.

Contrat d'entrée, validation des dates et forme de la réponse

Chaque valeur peut être un jour civil au format YYYY-MM-DD, un datetime ISO-8601 complet avec séparateur T ou espace facultatif, secondes facultatives, fraction de seconde tronquée et un Z final ou un décalage numérique facultatifs, ou une heure d'horloge seule au format HH:mm ou HH:mm:ss. Les années vont de un à neuf mille neuf cent quatre-vingt-dix-neuf, les mois de un à douze, et le jour doit exister dans ce mois selon les règles bissextiles grégoriennes, y compris le vingt-neuf février uniquement les années bissextiles.

Les heures vont de zéro à vingt-trois et les minutes et secondes de zéro à cinquante-neuf. Une heure d'horloge seule ne peut pas se mêler à une date ou un datetime de calendrier : les deux extrémités doivent être horloge seule ou toutes deux porter une date, sinon la requête échoue en nommant la paire incohérente.

Les deux extrémités sont obligatoires à dessein : un calculateur de temps entre repères qui substitue en silence l'horloge de l'hôte produit des réponses différentes en intégration continue, sur un portable qui traverse un méridien et sur un worker en Coordinated Universal Time, ce qui brise les audits et les exports reproductibles.

Où un calculateur de temps entre deux repères justifie sa place

Les bureaux de vacation et les brouillons de paie ont besoin de jours, d'heures et de minutes restantes entre un tampon d'entrée et un tampon de sortie, non d'un seul entier de minutes ni d'un âge civil en années et mois. Les bureaux de voyage impriment le même triplet sur un itinéraire afin qu'un départ le vendredi matin et une arrivée le dimanche après-midi se décrivent comme deux jours, quelques heures et des minutes restantes, plutôt qu'une moyenne flottante qui dérive en traversant un fuseau.

Les dossiers d'hôpital et d'hôtel stockent l'intervalle mixte contre deux tampons explicites afin qu'un relecteur puisse rejouer la même paire des mois plus tard et obtenir le même détail. Les tableaux de bord personnels utilisent le calculateur gratuit de temps entre repères dans le navigateur pour savoir combien a réellement duré un concert, une séance de cours ou un trajet routier, sans installer une bibliothèque de dates ni expédier une base de fuseaux à chaque client.

Gardez des attentes honnêtes : cette capacité mesure le temps d'horloge écoulé entre deux dates ou heures explicites ; elle n'omet pas les week-ends comme durée ouvrée, ne charge pas les calendriers de jours fériés, n'invente pas aujourd'hui lorsqu'un champ manque, ne convertit pas les mois lunaires et ne conserve pas les secondes restantes dans le triplet principal. Associez-la à un outil années-mois-jours lorsque le formulaire demande un âge civil, et à un auxiliaire de jours entiers lorsque le texte produit ne mentionne jamais les heures.

Comme l'implémentation est un parse pur de palier A, chaque appel réussi reste bon marché, déterministe et exempt de jetons de modèle ou de réseau sortant, précisément ce dont les suites de régression ont besoin lorsqu'elles figent des paires de jour bissextile et de nuit à matin sur des décennies de tampons de début et de fin.