As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# \$1currentDate
<a name="currentDate"></a>

O `$currentDate` operador é usado para definir o valor de um campo para a data e a hora atuais. Esse operador é útil para atualizar automaticamente um campo com o carimbo de data/hora atual quando um documento é inserido ou atualizado.

**Parâmetros**
+ `field`: o campo a ser atualizado com a data e a hora atuais.
+ `type`: (opcional) Especifica o tipo de BSON a ser usado na data atual. Pode ser `date` ou `timestamp`.

## Exemplo (MongoDB Shell)
<a name="currentDate-examples"></a>

O exemplo a seguir demonstra como usar o `$currentDate` operador para definir o `lastModified` campo com a data e a hora atuais quando um novo documento é inserido.

**Crie documentos de amostra**

```
db.users.insert({
  name: "John Doe",
  email: "john.doe@example.com"
})
```

**Exemplo de consulta**

```
db.users.updateOne(
  { name: "John Doe" },
  { $currentDate: { lastModified: true } }
)
```

**Exibir documento atualizado**

```
db.users.findOne({ name: "John Doe" })
```

**Saída**

```
{
  _id: ObjectId('...'),
  name: 'John Doe',
  email: 'john.doe@example.com',
  lastModified: ISODate('2025-10-25T22:50:29.963Z')
}
```

## Exemplos de código
<a name="currentDate-code"></a>

Para ver um exemplo de código para usar o `$currentDate` comando, escolha a guia do idioma que você deseja usar:

------
#### [ Node.js ]

```
const { MongoClient } = require('mongodb');

async function updateUserWithCurrentDate() {
  const client = await MongoClient.connect('mongodb://<username>:<password>@<cluster-endpoint>:27017/?tls=true&tlsCAFile=global-bundle.pem&replicaSet=rs0&readPreference=secondaryPreferred&retryWrites=false');
  const db = client.db('test');
  const users = db.collection('users');

  await users.updateOne(
    { name: 'John Doe' },
    { $currentDate: { lastModified: true } }
  );

  console.log('User updated with current date');
  client.close();
}

updateUserWithCurrentDate();
```

------
#### [ Python ]

```
from pymongo import MongoClient

def update_user_with_current_date():
    client = MongoClient('mongodb://<username>:<password>@<cluster-endpoint>:27017/?tls=true&tlsCAFile=global-bundle.pem&replicaSet=rs0&readPreference=secondaryPreferred&retryWrites=false')
    db = client['test']
    users = db.users

    result = users.update_one(
        {'name': 'John Doe'},
        {'$currentDate': {'lastModified': True}}
    )

    print('User updated with current date')
    client.close()

update_user_with_current_date()
```

------