Bitbybit Docs
    Preparing search index...

    Class Dates

    Dates et heures sous forme de valeurs JavaScript Date : les créer, lire et définir leurs parties, et les formater en texte. Les mois comptent à partir de 0 (janvier est 0, décembre 11) et les jours de la semaine à partir de 0 (dimanche) ; les jours du mois comptent à partir de 1. Chaque setter renvoie une nouvelle date et laisse celle donnée inchangée. Des variantes en heure locale et en UTC existent pour la plupart des opérations.

    Index

    Constructors

    convert

    • Formate la partie date en texte, sans l'heure, dans le fuseau horaire local.

      Exemple : 15 janvier 2024 à 14:30 -> 'Mon Jan 15 2024'

      Parameters

      Returns string

      La date sous forme de texte tel que 'Mon Jan 15 2024'

    • Formate la date et l'heure au format ISO 8601 utilisé pour l'échange de données, toujours en UTC.

      Exemple : 15 janvier 2024 à 14:30 -> '2024-01-15T14:30:45.000Z'

      Parameters

      Returns string

      La date sous forme de texte tel que '2024-01-15T14:30:45.000Z'

    • Formate la date telle qu'elle apparaît dans du JSON, c'est-à-dire au format ISO 8601 en UTC.

      Exemple : 15 janvier 2024 à 14:30 -> '2024-01-15T14:30:00.000Z'

      Parameters

      Returns string

      La date sous forme de texte tel que '2024-01-15T14:30:00.000Z'

    • Formate la date et l'heure complètes en texte dans le fuseau horaire local, avec le décalage du fuseau.

      Exemple : 15 janvier 2024 à 14:30 -> 'Mon Jan 15 2024 14:30:00 GMT+0000'

      Parameters

      Returns string

      La date et l'heure sous forme de texte

    • Formate la partie heure en texte, sans la date, dans le fuseau horaire local avec le décalage du fuseau.

      Exemple : 15 janvier 2024 à 14:30 -> '14:30:45 GMT+0000'

      Parameters

      Returns string

      L'heure sous forme de texte tel que '14:30:45 GMT+0000'

    • Formate la date et l'heure en texte en UTC.

      Exemple : 15 janvier 2024 à 14:30 -> 'Mon, 15 Jan 2024 14:30:00 GMT'

      Parameters

      Returns string

      La date et l'heure sous forme de texte UTC

    create

    • Donne la date et l'heure actuelles au moment de l'appel.

      Returns Date

      La date et l'heure actuelles

    • Construit une date à partir de ses parties, lues dans le fuseau horaire local.

      Le mois compte à partir de 0 : 0 est janvier, 11 décembre. Une partie hors de sa plage bascule, de sorte que le jour 32 de janvier devient le premier février. Exemple : année 2024, mois 0, jour 15, heures 14, minutes 30 -> 15 janvier 2024 à 14:30 heure locale

      Parameters

      • inputs: CreateDateDto

        L'année, le mois, le jour, les heures, les minutes, les secondes et les millisecondes

      Returns Date

      La date

      const date = bitbybit.dates.createDate({ year: 2024, month: 0, day: 15, hours: 14, minutes: 30, seconds: 0, milliseconds: 0 });
      
    • Construit une date à partir de ses parties, lues en UTC de sorte que le fuseau horaire local n'intervient pas.

      Le mois compte à partir de 0 : 0 est janvier, 11 décembre. Une partie hors de sa plage bascule. Exemple : année 2024, mois 0, jour 15 -> 15 janvier 2024 à 00:00 UTC

      Parameters

      • inputs: CreateDateDto

        L'année, le mois, le jour, les heures, les minutes, les secondes et les millisecondes

      Returns Date

      La date

      const date = bitbybit.dates.createDateUTC({ year: 2024, month: 0, day: 15, hours: 0, minutes: 0, seconds: 0, milliseconds: 0 });
      
    • Construit une date à partir d'un horodatage Unix : le nombre de millisecondes depuis le 1er janvier 1970 à 00:00 UTC.

      Exemple : 1705329000000 -> 15 janvier 2024 à 14:30 UTC

      Parameters

      Returns Date

      La date

      const date = bitbybit.dates.createFromUnixTimeStamp({ unixTimeStamp: 1705329000000 });
      

    get

    • Lit le jour du mois, de 1 à 31, dans le fuseau horaire local.

      Exemple : 15 janvier 2024 -> 15

      Parameters

      Returns number

      Le jour du mois

    • Lit le jour de la semaine dans le fuseau horaire local : 0 est dimanche, 6 samedi.

      Exemple : 15 janvier 2024 -> 1, un lundi

      Parameters

      Returns number

      Le jour de la semaine de 0 à 6

    • Lit l'année complète dans le fuseau horaire local.

      Exemple : 15 janvier 2024 -> 2024

      Parameters

      Returns number

      L'année

    • Lit le mois dans le fuseau horaire local, en comptant à partir de 0 : 0 est janvier, 11 décembre.

      Exemple : 15 janvier 2024 -> 0

      Parameters

      Returns number

      Le mois de 0 à 11

    • Lit l'heure, de 0 à 23, dans le fuseau horaire local.

      Exemple : 14:30 -> 14

      Parameters

      Returns number

      L'heure

    • Lit les minutes, de 0 à 59, dans le fuseau horaire local.

      Exemple : 14:30 -> 30

      Parameters

      Returns number

      Les minutes

    • Lit les secondes, de 0 à 59, dans le fuseau horaire local.

      Exemple : 14:30:45 -> 45

      Parameters

      Returns number

      Les secondes

    • Lit les millisecondes, de 0 à 999, dans le fuseau horaire local.

      Exemple : 14:30:45.123 -> 123

      Parameters

      Returns number

      Les millisecondes

    • Donne la date sous forme d'horodatage Unix : les millisecondes depuis le 1er janvier 1970 à 00:00 UTC.

      Exemple : 15 janvier 2024 à 14:30 UTC -> 1705329000000

      Parameters

      Returns number

      L'horodatage en millisecondes

    • Lit l'année complète en UTC.

      Exemple : 15 janvier 2024 -> 2024

      Parameters

      Returns number

      L'année

    • Lit le mois en UTC, en comptant à partir de 0 : 0 est janvier, 11 décembre.

      Exemple : 15 janvier 2024 -> 0

      Parameters

      Returns number

      Le mois de 0 à 11

    • Lit le jour du mois, de 1 à 31, en UTC.

      Exemple : 15 janvier 2024 -> 15

      Parameters

      Returns number

      Le jour du mois

    • Lit l'heure, de 0 à 23, en UTC.

      Exemple : 14:00 UTC -> 14

      Parameters

      Returns number

      L'heure

    • Lit les minutes, de 0 à 59, en UTC.

      Exemple : 14:30 UTC -> 30

      Parameters

      Returns number

      Les minutes

    • Lit les secondes, de 0 à 59, en UTC.

      Exemple : 14:30:45 UTC -> 45

      Parameters

      Returns number

      Les secondes

    • Lit les millisecondes, de 0 à 999, en UTC.

      Exemple : 14:30:45.123 UTC -> 123

      Parameters

      Returns number

      Les millisecondes

    parse

    • Lit une date écrite sous forme de texte et donne son horodatage Unix, les millisecondes depuis le 1er janvier 1970 à 00:00 UTC.

      Un texte ISO 8601 comme '2024-01-15' ou '2024-01-15T14:30:00Z' est lu de façon fiable ; un texte qui ne peut pas être lu donne NaN. Exemple : '2024-01-15' -> 1705276800000

      Parameters

      Returns number

      L'horodatage en millisecondes, ou NaN quand le texte n'est pas une date

      const stamp = bitbybit.dates.parseDate({ dateString: "2024-01-15T14:30:00Z" });
      

    set

    • Fait une copie de la date avec une autre année, dans le fuseau horaire local. La date donnée n'est pas modifiée.

      Exemple : 15 janvier 2024 avec l'année 2025 -> 15 janvier 2025

      Parameters

      Returns Date

      Une nouvelle date avec l'année modifiée

      const changed = bitbybit.dates.setYear({ date: bitbybit.dates.now(), year: 2025 });
      
    • Fait une copie de la date avec un autre mois, dans le fuseau horaire local ; les mois comptent à partir de 0. La date donnée n'est pas modifiée.

      Exemple : 15 janvier 2024 avec le mois 5 -> 15 juin 2024

      Parameters

      Returns Date

      Une nouvelle date avec le mois modifié

      const changed = bitbybit.dates.setMonth({ date: bitbybit.dates.now(), month: 5 });
      
    • Fait une copie de la date avec un autre jour du mois, dans le fuseau horaire local. La date donnée n'est pas modifiée.

      Exemple : 15 janvier 2024 avec le jour 20 -> 20 janvier 2024

      Parameters

      Returns Date

      Une nouvelle date avec le jour modifié

      const changed = bitbybit.dates.setDayOfMonth({ date: bitbybit.dates.now(), day: 20 });
      
    • Fait une copie de la date avec une autre heure, dans le fuseau horaire local. La date donnée n'est pas modifiée.

      Exemple : 14:30 avec les heures 9 -> 09:30

      Parameters

      Returns Date

      Une nouvelle date avec l'heure modifiée

      const changed = bitbybit.dates.setHours({ date: bitbybit.dates.now(), hours: 9 });
      
    • Fait une copie de la date avec d'autres minutes, dans le fuseau horaire local. La date donnée n'est pas modifiée.

      Exemple : 14:30 avec les minutes 45 -> 14:45

      Parameters

      Returns Date

      Une nouvelle date avec les minutes modifiées

      const changed = bitbybit.dates.setMinutes({ date: bitbybit.dates.now(), minutes: 45 });
      
    • Fait une copie de la date avec d'autres secondes, dans le fuseau horaire local. La date donnée n'est pas modifiée.

      Exemple : 14:30:00 avec les secondes 30 -> 14:30:30

      Parameters

      Returns Date

      Une nouvelle date avec les secondes modifiées

      const changed = bitbybit.dates.setSeconds({ date: bitbybit.dates.now(), seconds: 30 });
      
    • Fait une copie de la date avec d'autres millisecondes, dans le fuseau horaire local. La date donnée n'est pas modifiée.

      Exemple : 14:30:00.000 avec les millisecondes 500 -> 14:30:00.500

      Parameters

      Returns Date

      Une nouvelle date avec les millisecondes modifiées

      const changed = bitbybit.dates.setMilliseconds({ date: bitbybit.dates.now(), milliseconds: 500 });
      
    • Fait une copie de la date déplacée à un horodatage Unix, les millisecondes depuis le 1er janvier 1970 à 00:00 UTC. La date donnée n'est pas modifiée.

      Exemple : n'importe quelle date avec le temps 0 -> 1er janvier 1970 à 00:00 UTC

      Parameters

      • inputs: DateTimeDto

        La date et l'horodatage en millisecondes

      Returns Date

      Une nouvelle date avec l'horodatage modifié

      const changed = bitbybit.dates.setTime({ date: bitbybit.dates.now(), time: 1705329000000 });
      
    • Fait une copie de la date avec une autre année, en UTC. La date donnée n'est pas modifiée.

      Exemple : 15 janvier 2024 avec l'année 2025 -> 15 janvier 2025

      Parameters

      Returns Date

      Une nouvelle date avec l'année modifiée

      const changed = bitbybit.dates.setUTCYear({ date: bitbybit.dates.now(), year: 2025 });
      
    • Fait une copie de la date avec un autre mois, en UTC ; les mois comptent à partir de 0. La date donnée n'est pas modifiée.

      Exemple : 15 janvier 2024 avec le mois 5 -> 15 juin 2024

      Parameters

      Returns Date

      Une nouvelle date avec le mois modifié

      const changed = bitbybit.dates.setUTCMonth({ date: bitbybit.dates.now(), month: 5 });
      
    • Fait une copie de la date avec un autre jour du mois, en UTC. La date donnée n'est pas modifiée.

      Exemple : 15 janvier 2024 avec le jour 20 -> 20 janvier 2024

      Parameters

      Returns Date

      Une nouvelle date avec le jour modifié

      const changed = bitbybit.dates.setUTCDay({ date: bitbybit.dates.now(), day: 20 });
      
    • Fait une copie de la date avec une autre heure, en UTC. La date donnée n'est pas modifiée.

      Exemple : 14:30 UTC avec les heures 9 -> 09:30 UTC

      Parameters

      Returns Date

      Une nouvelle date avec l'heure modifiée

      const changed = bitbybit.dates.setUTCHours({ date: bitbybit.dates.now(), hours: 9 });
      
    • Fait une copie de la date avec d'autres minutes, en UTC. La date donnée n'est pas modifiée.

      Exemple : 14:30 UTC avec les minutes 45 -> 14:45 UTC

      Parameters

      Returns Date

      Une nouvelle date avec les minutes modifiées

      const changed = bitbybit.dates.setUTCMinutes({ date: bitbybit.dates.now(), minutes: 45 });
      
    • Fait une copie de la date avec d'autres secondes, en UTC. La date donnée n'est pas modifiée.

      Exemple : 14:30:00 UTC avec les secondes 30 -> 14:30:30 UTC

      Parameters

      Returns Date

      Une nouvelle date avec les secondes modifiées

      const changed = bitbybit.dates.setUTCSeconds({ date: bitbybit.dates.now(), seconds: 30 });
      
    • Fait une copie de la date avec d'autres millisecondes, en UTC. La date donnée n'est pas modifiée.

      Exemple : 14:30:00.000 UTC avec les millisecondes 500 -> 14:30:00.500 UTC

      Parameters

      Returns Date

      Une nouvelle date avec les millisecondes modifiées

      const changed = bitbybit.dates.setUTCMilliseconds({ date: bitbybit.dates.now(), milliseconds: 500 });