ForHosting KIT · Dates et temps

Trimestre calendaire

Le 15 mai 2024 tombe au deuxième trimestre, qui va du 1er avril au 30 juin 2024. Saisissez une date et obtenez son trimestre calendaire, le premier et le dernier jour de ce bloc et les trois mois qu'il couvre. Gratuit dans votre navigateur.

Gratuit
Fonctionne dans votre navigateur
Sans inscription
Vos données restent sur votre appareil

Lancer gratuitement Voir l’API

Utilisez-le depuis WebAPIE-mailTelegramApp bientôt

Exemple résolu

Si vous saisissez

Date: 2024-05-15

Vous obtenez

Année: 2 024
Mois: 5
Jour: 15
Trimestre: 2

Un trimestre calendaire est l'un des quatre blocs fixes de trois mois qui divisent une année civile : Q1 va du premier janvier au trente et un mars, Q2 du premier avril au trente juin, Q3 du premier juillet au trente septembre, et Q4 du premier octobre au trente et un décembre. Les équipes financières, les feuilles de route produit, les calendriers scolaires et les rapports de conformité demandent constamment dans quel trimestre tombe un jour donné et quelles sont les dates inclusives de début et de fin de ce bloc. Ce chercheur accepte une seule date de calendrier ISO sous la forme stricte année-mois-jour avec quatre, deux et deux chiffres, vérifie que le jour existe réellement sur le calendrier grégorien y compris les févriers bissextiles, mappe le mois au numéro de trimestre de un à quatre, et renvoie le libellé du trimestre, la date ISO de début, la date ISO de fin et les trois mois de ce trimestre. Les dates impossibles telles que le vingt-neuf février d'une année commune ou le trente et un avril échouent avec une erreur de validation claire au lieu d'un ajustement silencieux.

Comment les trimestres calendaires se déduisent d'une date ISO

Partez d'une date de calendrier écrite comme année, mois et jour sous la forme ISO internationale avec tirets et largeurs fixes afin que chaque client s'accorde sur les mêmes trois entiers. Confirmez d'abord que l'année se situe dans une plage grégorienne pratique de l'an un à neuf mille neuf cent quatre-vingt-dix-neuf et que le mois est entre un et douze.

Appliquez ensuite la règle de l'année bissextile des calendriers civils mondiaux : une année est bissextile lorsqu'elle est divisible par quatre, sauf que les années séculaires ne le sont que si elles sont aussi divisibles par quatre cents. Cette règle rend légal le vingt-neuf février en des années telles que deux mille vingt-quatre et deux mille, et illégal en deux mille vingt-trois et mille neuf cents.

Avec le statut bissextile connu, consultez la longueur de chaque mois pour cette année et rejetez tout jour qui dépasse cette longueur, par exemple le trente et un avril ou le trente février. Lorsque le triple est valide, convertissez le mois en trimestre avec une carte entière simple : mois un à trois sont le trimestre un, quatre à six le deux, sept à neuf le trois, et dix à douze le quatre, ce qui revient au plancher de mois moins un divisé par trois puis plus un.

Le début et la fin de chaque trimestre sont des bornes civiles fixes pour cette année : premier janvier–trente et un mars, premier avril–trente juin, premier juillet–trente septembre, premier octobre–trente et un décembre. Les années bissextiles ne changent jamais ces dates de fin car février n'est jamais le dernier mois d'un trimestre.

Où les chercheurs de trimestre apparaissent dans le travail réel

Les équipes finance et comptabilité étiquettent factures, réservations et dossiers de conseil par trimestre calendaire afin que les rapports annuels s'agrègent sans clés ambiguës basées sur le seul mois. Les chefs de produit planifient jalons de feuille de route et OKR sur Q1 à Q4 et ont besoin des dates inclusives de début et de fin pour filtres ou fenêtres de rappel.

Les entrepôts de données partitionnent les tables de faits par trimestre et doivent tamponner chaque ligne source d'un numéro de trimestre stable dérivé d'une date civile ISO plutôt que de l'horloge locale de l'hôte. Les calendriers de conformité et les trimestres scolaires publient souvent des échéances comme le dernier jour d'un trimestre ; les validateurs ont besoin du trimestre d'un jour donné et de la date de fin pour les contrôles de plage.

Si vous avez besoin plus tard de trimestres fiscaux avec un mois de début personnalisé, d'ordinaux du jour de l'année, de comptages de jours ouvrés ou de numéros de semaine ISO, traitez-les comme des intentions de recherche et des pages distinctes plutôt que de surcharger ce chercheur de trimestre calendaire.

Questions fréquentes

Quels sont les trimestres calendaires ?

Q1 va du 1er janvier au 31 mars, Q2 du 1er avril au 30 juin, Q3 du 1er juillet au 30 septembre, et Q4 du 1er octobre au 31 décembre. Les bornes sont des dates civiles de la même année que l'entrée.

L'année bissextile change-t-elle les dates de fin de trimestre ?

Non. Février n'est jamais le dernier mois d'un trimestre, donc Q1 se termine toujours le 31 mars en année bissextile comme en année commune. Les règles bissextiles n'affectent que la validité du 29 février en entrée.

Quel format de date est exigé ?

ISO strict YYYY-MM-DD avec année à quatre chiffres et mois et jour à deux chiffres. Des valeurs comme 2024-5-15 ou 2024/05/15 sont rejetées pour que chaque client s'accorde sur la même chaîne.

Que se passe-t-il avec une date invalide telle que 2023-02-29 ?

Le message d'erreur explique que le jour n'est pas valide pour cette année et ce mois.

À quel trimestre appartiennent les jours de bordure comme le 1er janvier ou le 31 décembre ?

Le 1er janvier appartient au premier trimestre et le 31 décembre au quatrième. Le dernier jour d'un trimestre reste dans ce trimestre et ne glisse jamais dans le suivant.

Outils associés

Pour les développeurs — accès API

Tout sur cette page est disponible par programmation. Cette section s'adresse aux équipes qui veulent l'intégrer à leurs systèmes ; les autres peuvent simplement utiliser l'outil ci-dessus.

Endpoint

POSThttps://api.kit.forhosting.com/date/quarter-of-year

Authentification par jeton Bearer : un seul POST met la tâche en file d’attente, et le résultat vous parvient par webhook ou lien signé.

Appeler depuis votre stack

curl -X POST https://api.kit.forhosting.com/date/quarter-of-year \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date":"2024-05-15"}'

const res = await fetch("https://api.kit.forhosting.com/date/quarter-of-year", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "date": "2024-05-15"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/date/quarter-of-year",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "date": "2024-05-15"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/date/quarter-of-year", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"date":"2024-05-15"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"date":"2024-05-15"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/date/quarter-of-year", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

Exemple de requête

{
  "date": "2024-05-15"
}

Exemple de réponse

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "date.quarter_of_year",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

L’API est asynchrone : chaque appel renvoie un task_id immédiatement, puis vous interrogez l’état à raison d’une requête par seconde.

Tarifs

par requête$0.002

Le prix est publié, sans tokens ni crédits. Une tâche qui échoue n’est pas facturée.

Erreurs

HTTP	Code	Signification
`401`	`unauthorized`	Clé API absente ou invalide : vérifiez l’en-tête Authorization.
`402`	`insufficient_balance`	Solde insuffisant : rechargez votre compte pour lancer cette tâche.
`404`	`unknown_type`	Type de tâche inconnu : vérifiez le champ type de votre requête.
`429`	`rate_limited`	Trop de requêtes : ralentissez la cadence, puis réessayez.

Notes techniques

Comment les trimestres calendaires se déduisent d'une date ISO

Tout le pipeline est une arithmétique entière déterministe sans graines aléatoires, sans horloge murale, sans objet Date JavaScript et sans appels réseau, de sorte que des entrées identiques produisent toujours le même JSON.

Ce que vous envoyez et ce que vous recevez

Envoyez un champ chaîne obligatoire nommé date contenant un jour de calendrier ISO strict tel que 2024-05-15. Les jours qui correspondent au motif mais ne sont pas de vraies dates, y compris le vingt-neuf février hors année bissextile et les mois hors de un à douze, échouent aussi avec un message qui nomme le problème pour que les clients corrigent sans deviner. Contrôles classiques : le quinze mai mappe vers Q2 avec bornes premier avril–trente juin ; le premier janvier vers Q1 ; le trente et un décembre vers Q4 ; les frontières de trimestre tombent sur le bon bloc sans glisser. Les champs manquants, les valeurs non chaîne et les chaînes qui ne correspondent pas au motif quatre-deux-deux chiffres échouent avec invalid_input et ne sont pas facturés. En succès la réponse renvoie la date normalisée, les composants numériques année, mois et jour, quarter comme entier de un à quatre, quarter_label comme chaîne familière Q1 à Q4, quarter_start et quarter_end comme dates ISO inclusives du bloc civil, months_in_quarter comme tableau de trois numéros de mois, un booléen is_leap_year, et une courte chaîne formula qui documente la règle mois-vers-trimestre. Le tarif des appels API réussis est la base publiée de $0.002 par élément ; les échecs de validation ne consomment pas le solde prépayé.

Où les chercheurs de trimestre apparaissent dans le travail réel

Comme cette capacité est un moteur de parse pur, le tarif API est la base publiée de $0.002 par élément réussi et la validation échouée ne consomme pas le solde.

Cas d'intégration

Reporting financier et de conseil

Mappez chaque date ISO de réservation ou facture vers Q1–Q4 avec quarter_start et quarter_end pour des agrégats et filtres trimestriels cohérents entre outils.

Feuilles de route et fenêtres d'OKR

Tamponnez les jalons avec quarter_label et bornes inclusives pour que les tableaux de bord filtrent le « trimestre courant » sans fuseaux de l'hôte.

Partitions d'entrepôt et étiquettes de lot

Dérivez un numéro de trimestre stable depuis des entrées strictes YYYY-MM-DD pour les clés de partition, avec invalid_input clair sur les jours de calendrier impossibles.

Questions techniques

Combien cela coûte-t-il ?

L'outil navigateur est gratuit et s'exécute localement. Les requêtes API utilisent le solde KIT prépayé à $0.002 par élément réussi ; l'entrée invalide n'est pas facturée.

Consulter la documentation complète du KIT →

Lancer gratuitement

Exemple résolu

Comment les trimestres calendaires se déduisent d'une date ISO

Où les chercheurs de trimestre apparaissent dans le travail réel

Questions fréquentes

Outils associés

Pour les développeurs — accès API

Endpoint

Appeler depuis votre stack

Exemple de requête

Exemple de réponse

Tarifs

Erreurs

Notes techniques

Comment les trimestres calendaires se déduisent d'une date ISO

Ce que vous envoyez et ce que vous recevez

Où les chercheurs de trimestre apparaissent dans le travail réel

Cas d'intégration

Reporting financier et de conseil

Feuilles de route et fenêtres d'OKR

Partitions d'entrepôt et étiquettes de lot

Questions techniques

merci