Informations sur le temps

L'endpoint /time permet de récupérer des informations sur le temps en fonction de différents paramètres. Vous pouvez obtenir l'heure actuelle ou une heure aléatoire entre une plage spécifiée, dans différents formats et fuseaux horaires.

gethttps://api.moxon.dev/v3/time

Paramètres

typestringoptionnel
live (par défaut) pour le temps actuel, random pour un temps aléatoire
startstringoptionnel
Date de début pour la plage aléatoire (format : YYYY-MM-DD)
endstringoptionnel
Date de fin pour la plage aléatoire (format : YYYY-MM-DD)
formatstringoptionnel
Format de la réponse (voir les options ci-dessous)
timezonestringoptionnel
Fuseau horaire à utiliser (voir les options ci-dessous)

Options de format

Format	Description
`iso`	Format ISO 8601 (par défaut)
`timestamp`	Timestamp Unix
`locale`	Format local
`date`	Date au format `MM/DD/YYYY`
`time`	Heure au format `HH:MM:SS`
`year`	Année uniquement
`month`	Mois uniquement
`day`	Jour uniquement
`hour`	Heure uniquement
`minute`	Minutes uniquement
`second`	Secondes uniquement
`ms`	Millisecondes uniquement
`dayOfWeek`	Jour de la semaine (0-6)
`dayOfYear`	Jour de l'année (1-365/366)
`weekNumber`	Numéro de semaine
`timezone`	Nom du fuseau horaire
`timezoneOffset`	Décalage horaire

Options de fuseau horaire

Fuseau horaire	Description
`UTC`	Temps universel coordonné (par défaut)
`Europe/Paris`	Fuseau horaire de Paris
`America/New_York`	Fuseau horaire de New York
`Asia/Tokyo`	Fuseau horaire de Tokyo
`Australia/Sydney`	Fuseau horaire de Sydney

Exemples de requête

Temps actuel (tous les formats)

GET /v3/time

{
    "iso": "2000-01-01T12:00:00.000Z",
    "utc": "Sat, 01 Jan 2000 12:00:00 GMT",
    "timestamp": 946724400,
    "locale": "1/1/2000, 12:00:00 PM Coordinated Universal Time",
    "date": "3/3/2000",
    "time": "12:00:00 PM",
    "year": 2000,
    "month": 1,
    "day": 1,
    "hour": 12,
    "minute": 0,
    "second": 0,
    "ms": 0,
    "dayOfWeek": 6,
    "dayOfYear": 1,
    "weekNumber": 1,
    "timezone": "UTC",
    "timezoneOffset": 0
}

Temps aléatoire avec format spécifique

curl -X GET "https://api.moxon.dev/v3/time?type=random&format=locale&timezone=Europe/Paris"

{
    "date": "7/28/2024, 2:06:52 PM GMT+01:00"
}

Gestion des erreurs

Si les paramètres sont invalides, l'API retournera une erreur :

400Please provide a valid type (?type={type})Le paramètre type est invalide
400Please provide a valid start date (?start={YYYY-MM-DD})Le paramètre start est invalide
400Please provide a valid end date (?end={YYYY-MM-DD})Le paramètre end est invalide
400Please provide a valid format (?format={format})Le paramètre format est invalide
400Please provide a valid timezone (?timezone={timezone})Le paramètre timezone est invalide

Modifier cette page sur GitHub Signaler un problème

Mis à jour le 8 avril 2026