En MongoDB, el $second
el operador de canalización de agregación devuelve la segunda parte de una fecha como un número entre 0
y 59
. El valor también puede ser 60
para tener en cuenta los segundos bisiestos cuando corresponda.
Opcionalmente, puede especificar una zona horaria para usar para el resultado.
El $second
El operador acepta una fecha (como una fecha, una marca de tiempo o un Id. de objeto) o un documento que especifica la fecha y la zona horaria a utilizar.
Ejemplo
Supongamos que tenemos una colección llamada pets
con el siguiente documento:
{ "_id" : ObjectId("600631c7c8eb4369cf6ad9c8"), "name" : "Fetch", "born" : ISODate("2020-12-31T23:30:15.123Z") }
Podemos ejecutar el siguiente código para extraer la segunda parte del born
campo en ese documento.
db.pets.aggregate(
[
{
$project:
{
_id: 0,
birthSecond: { $second: "$born" }
}
}
]
)
Resultado:
{ "birthSecond" : 15 }
Aquí, usé birthSecond
como el nombre del campo a devolver, pero podría haber sido cualquier cosa (como secondsAtBirth
, seconds
, etc).
El _id
El campo se devuelve de forma predeterminada cuando se usan proyecciones en MongoDB, pero en este ejemplo oculté explícitamente el _id
campo usando _id: 0
.
Especifique una zona horaria
Puede especificar una zona horaria para usar para la salida del $second
operador.
Cuando haces esto, el argumento pasa a $second
debe ser de la siguiente forma:
{ date: <dateExpression>, timezone: <tzExpression> }
Donde <dateExpression>
es la fecha a usar, y <tzExpression>
es la zona horaria a utilizar.
La zona horaria se puede especificar utilizando el identificador de zona horaria de Olson (por ejemplo, "Europe/London"
, "GMT"
) o el desplazamiento UTC (por ejemplo, "+02:30"
, "-1030"
).
Identificador de zona horaria de Olson
Aquí hay un ejemplo que genera los segundos en dos zonas horarias diferentes, cada una con los ID de zona horaria de Olson:
db.pets.aggregate(
[
{
$project: {
_id: 0,
kabul: {
$second: { date: "$born", timezone: "Asia/Kabul" }
},
brisbane: {
$second: { date: "$born", timezone: "Australia/Brisbane" }
}
}
}
]
)
Resultado:
{ "kabul" : 15, "brisbane" : 15 }
Dado que el cambio de zona horaria no afecta la parte de los segundos, el resultado es el mismo.
Desplazamiento UTC
En este ejemplo usamos el desplazamiento UTC.
db.pets.aggregate(
[
{
$project: {
_id: 0,
"utcOffset+04:30": {
$second: { date: "$born", timezone: "+04:30" }
},
"utcOffset+05:45": {
$second: { date: "$born", timezone: "+05:45" }
}
}
}
]
)
Resultado:
{ "utcOffset+04:30" : 15, "utcOffset+05:45" : 15 }
Devolver los segundos de un ObjectId
Puedes usar $second
para devolver la porción de segundos de un ObjectId.
Los valores de ObjectId son valores hexadecimales de 12 bytes que constan de:
- Un valor de marca de tiempo de 4 bytes, que representa la creación del ObjectId, medido en segundos desde la época de Unix.
- Un byte de 5 es un valor aleatorio
- Un contador incremental de 3 bytes, inicializado a un valor aleatorio.
En resumen, nuestro documento se ve así:
{ "_id" : ObjectId("600631c7c8eb4369cf6ad9c8"), "name" : "Fetch", "born" : ISODate("2020-12-31T23:30:15.123Z") }
Este documento contiene un ObjectId. Por lo tanto, podemos usar $second
para devolver el segundo en que se creó nuestro documento (o más específicamente, cuando el _id
se creó el valor ObjectId del campo).
Ejemplo:
db.pets.aggregate(
[
{
$project:
{
"timeStamp": { $toDate: "$_id"},
"second": { $second: "$_id" }
}
}
]
).pretty()
Resultado:
{ "_id" : ObjectId("600631c7c8eb4369cf6ad9c8"), "timeStamp" : ISODate("2021-01-19T01:11:35Z"), "second" : 35 }
Podemos ver que el documento fue creado en el segundo 35 (del minuto 11 de la 1 hora del día).
En este caso, también usé el $toDate
operador de canalización de agregación para devolver la parte de la marca de tiempo del ObjectId.