bson | timestamp functions
Cette section décrit les fonctions permettant de manipuler les valeurs d'horodatage BSON.
BSON (Binary JSON) est une représentation binaire de documents de type JSON principalement utilisée par MongoDB. Certains systèmes qui implémentent des API compatibles avec MongoDB, tels qu'Azure Cosmos DB, prennent également en charge les documents BSON.
Un horodatage BSON est une valeur de 64 bits composée de deux parties de 32 bits :
•valeur time_t (32 bits les plus significatifs) : le nombre de secondes écoulées depuis l'époque Unix (1970-01-01T00:00:00Z)
•valeur ordinal (32 bits de poids faible) : un compteur incrémental utilisé pour distinguer les opérations se produisant au cours d’une même seconde
Note : les horodatages BSON utilisent une valeur de 32 bits pour stocker les secondes écoulées depuis l’époque Unix. Cela limite la date maximale représentable à l’année 2038.
MapForce prend en charge les fonctions d’horodatage BSON suivantes :
•timestamp-datetime: renvoie la valeur datetime en UTC, convertie à partir du nombre de secondes stocké depuis l’époque Unix.
•timestamp-ordinal: extrait la valeur ordinale de l’horodatage.
•to-timestamp: crée un horodatage à partir d’une valeur datetime et d’une valeur ordinale.
Note : les horodatages BSON sont principalement destinés à un usage interne dans MongoDB. Pour les valeurs de date et d'heure générales, utilisez le type Date BSON.
Gestion des dates dans MapForce
Les valeurs Date BSON (en millisecondes depuis l'époque Unix) sont automatiquement converties en valeurs datetime et inversement. Pour plus de détails, consultez le tableau ci-dessous.
Conversion | Ce qui se passe |
|---|---|
bson.date > string | Produit une chaîne datetime ISO 8601 (par exemple, 2020-02-02T01:02:02Z).
Note : les dates BSON sont stockées en UTC. |
string > bson.date | Analyse une chaîne datetime ISO, la convertit en UTC et la stocke en tant que date BSON. |
Liens utiles