Este artigo contém uma lista de operadores de data, métodos e variáveis que você pode usar ao trabalhar com datas no MongoDB.
Operadores de atualização de campo
| Operador | Descrição |
|---|---|
$currentDate | Define o valor de um campo para a data atual. Ele pode ser definido como um tipo de data ou carimbo de data/hora. O padrão é Data. |
Operadores de expressão de data (pipeline de agregação)
Os operadores de pipeline de agregação a seguir retornam objetos de data ou componentes de um objeto de data. Eles podem ser usados para construir expressões para uso nos estágios do pipeline de agregação.
| Operador | Descrição |
|---|---|
$dateFromParts | Construi um objeto BSON Date a partir das partes constituintes da data. |
$dateFromString | Converte uma string de data/hora em um objeto de data. |
$dateToParts | Retorna um documento contendo as partes constituintes de uma data. |
$dateToString | Retorna a data como uma string. |
$dayOfMonth | Retorna o dia do mês de uma determinada data como um número entre 1 e 31 . |
$dayOfWeek | Retorna o dia da semana de uma determinada data como um número entre 1 (domingo) e 7 (sábado). |
$dayOfYear | Retorna o dia do ano de uma determinada data como um número entre 1 e 366 (ano bissexto). |
$hour | Retorna a hora de uma determinada data como um número entre 0 e 23 . |
$isoDayOfWeek | Retorna o número do dia da semana de uma determinada data no formato ISO 8601, variando de 1 (para segunda-feira) para 7 (para domingo). |
$isoWeek | Retorna o número da semana de uma determinada data no formato ISO 8601, variando de 1 para 53 . |
$isoWeekYear | Retorna o número do ano para uma determinada data no formato ISO 8601. |
$millisecond | Retorna os milissegundos de uma determinada data como um número entre 0 e 999 . |
$minute | Retorna o minuto de uma determinada data como um número entre 0 e 59 . |
$month | Retorna o mês de uma determinada data como um número entre 1 (janeiro) e 12 (dezembro). |
$second | Retorna os segundos de uma determinada data como um número entre 0 e 60 (segundos bissextos). |
$toDate | Converte um valor em uma data. |
$week | Retorna o número da semana para uma determinada data como um número entre 0 (a semana parcial que precede o primeiro domingo do ano) e 53 (ano bissexto). |
$year | Retorna o ano de uma determinada data como um número (por exemplo, 2021 ). |
Métodos
O método a seguir pode ser usado para retornar uma string de data/hora ou um objeto Date.
| Método | Descrição |
|---|---|
Date() | Retorna uma string de data/hora ou um objeto Date. Você pode fornecer uma data. Caso contrário, ele retornará a data/hora atual. |
Variáveis do sistema
As variáveis de sistema a seguir podem ser usadas para retornar um valor de data e hora ou carimbo de data/hora ao usar um pipeline de agregação.
| Método | Descrição |
|---|---|
NOW | Retorna o valor atual de data e hora. Esta variável foi introduzida no MongoDB versão 4.2. |
CLUSTER_TIME | Retorna o valor do carimbo de data/hora atual. Disponível apenas em conjuntos de réplicas e clusters fragmentados. Esta variável foi introduzida no MongoDB versão 4.2. |
