bson | timestamp functions
En esta sección se describen las funciones para trabajar con valores de marca de tiempo BSON.
BSON (Binary JSON) es una representación binaria de documentos similares a JSON que utiliza principalmente MongoDB. Algunos sistemas que implementan API compatibles con MongoDB, como Azure Cosmos DB, también admiten documentos BSON.
Una marca de tiempo BSON es un valor de 64 bits que se compone de dos partes de 32 bits:
•valor time_t (los 32 bits más significativos): el número de segundos transcurridos desde la época Unix (1970-01-01T00:00:00Z)
•valor ordinal (32 bits menos significativos): un contador incremental que se utiliza para distinguir las operaciones que tienen lugar en el mismo segundo
Nota: Las marcas de tiempo BSON utilizan un valor de 32 bits para almacenar los segundos transcurridos desde la época Unix. Esto establece que la fecha más avanzada que se puede representar es el año 2038.
MapForce admite las siguientes funciones de marca de tiempo BSON:
•timestamp-datetime: devuelve el valor de fecha y hora en UTC, convertido a partir del número de segundos almacenado desde la época Unix.
•timestamp-ordinal: extrae el valor ordinal de la marca de tiempo.
•to-timestamp: crea una marca de tiempo a partir de una fecha y hora y un número ordinal.
Nota: las marcas de tiempo BSON están destinadas principalmente al uso interno en MongoDB. Utilice el tipo Date de BSON para los valores generales de fecha y hora.
Cómo se gestionan las fechas en MapForce
Los valores de fecha BSON (milisegundos desde la época Unix) se convierten automáticamente a valores de fecha y hora, y viceversa. Para más detalles, consulte la tabla más abajo.
Conversión | Qué ocurre |
|---|---|
bson.date > string | Genera una cadena de fecha y hora conforme a la norma ISO 8601 (por ejemplo, 2020-02-02T01:02:02Z).
Nota: las fechas BSON se almacenan en formato UTC. |
string > bson.date | Analiza una cadena de fecha y hora en formato ISO, la convierte a UTC y la almacena como un objeto BSON de tipo Date. |
Enlaces prácticos