Aller au contenu
Accueil moxon

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/v5/time
Essayerget/v5/time

Paramètres

  • type"live" | "random" | "countdown"optionnel

    live (par défaut) pour le temps actuel, random pour un temps aléatoire, countdown vers une cible

  • startstringoptionnel

    Date de début pour la plage random (format : YYYY-MM-DD)

  • endstringoptionnel

    Date de fin pour la plage random (format : YYYY-MM-DD)

  • targetstringoptionnel

    Date cible pour le mode countdown (format : YYYY-MM-DD ou ISO 8601)

  • formatstringoptionnel

    Format de la réponse (voir les options ci-dessous)

    • iso
    • utc
    • timestamp
    • locale
    • date
    • time
    • year
    • month
    • day
    • hour
    • minute
    • second
    • ms
    • dayOfWeek
    • dayOfYear
    • weekNumber
    • timezone
  • timezonestringoptionnel

    Fuseau horaire à utiliser (voir les options ci-dessous)

    • UTC
    • Europe/Paris
    • America/New_York
    • Asia/Tokyo
    • Australia/Sydney

Options de format

FormatDescription
isoFormat ISO 8601 (par défaut)
timestampTimestamp Unix
localeFormat local
dateDate au format MM/DD/YYYY
timeHeure au format HH:MM:SS
yearAnnée uniquement
monthMois uniquement
dayJour uniquement
hourHeure uniquement
minuteMinutes uniquement
secondSecondes uniquement
msMillisecondes uniquement
dayOfWeekJour de la semaine (0-6)
dayOfYearJour de l'année (1-365/366)
weekNumberNuméro de semaine
timezoneNom du fuseau horaire
timezoneOffsetDécalage horaire

Options de fuseau horaire

Fuseau horaireDescription
UTCTemps universel coordonné (par défaut)
Europe/ParisFuseau horaire de Paris
America/New_YorkFuseau horaire de New York
Asia/TokyoFuseau horaire de Tokyo
Australia/SydneyFuseau horaire de Sydney

Champs de réponse

  • isostring

    Date au format ISO 8601

  • utcstring

    Date au format UTC

  • timestampnumber

    Timestamp Unix

  • localestring

    Date et heure au format local

  • datestring

    Date au format MM/DD/YYYY

  • timestring

    Heure au format HH:MM:SS

  • yearnumber

    Année

  • monthnumber

    Mois (1-12)

  • daynumber

    Jour du mois

  • hournumber

    Heure (0-23)

  • minutenumber

    Minutes

  • secondnumber

    Secondes

  • msnumber

    Millisecondes

  • dayOfWeeknumber

    Jour de la semaine (0-6)

  • dayOfYearnumber

    Jour de l'année (1-365/366)

  • weekNumbernumber

    Numéro de semaine

  • timezonestring

    Nom du fuseau horaire

  • timezoneOffsetnumber

    Décalage horaire en minutes

Exemples de code

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 target date (?target=...)Le paramètre target 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