# DATETIME

> Fonction DATETIME dans StackQL : calculer une valeur de date et d'heure à partir d'une entrée et d'un ou plusieurs modificateurs, renvoyée au format YYYY-MM-DD HH:MM:SS.

Source: https://stackql.io/fr/language-spec/functions/datetime/datetime-fn

Renvoie une valeur de date et d'heure calculée à partir d'une date et heure en entrée et d'un ou plusieurs modificateurs.  

Voir aussi :  
[[` SELECT `]](/language-spec/select) [[ Modificateurs de date ]](/language-spec/functions/datetime/date_modifiers) 

* * * 

## Syntaxe

```sql
SELECT DATETIME(datetime_expression , modifier, ...) FROM <multipartIdentifier>;
```

## Arguments

__*datetime_expression*__  
La valeur de date et d'heure.

__*modifier*__  
Zéro ou plusieurs modificateurs à appliquer à *datetime_expression*.  Pour plus d'informations sur les modificateurs, consultez [**Modificateurs de date**](/language-spec/functions/datetime/date_modifiers)

## Valeur(s) renvoyée(s)

Renvoie une chaîne de caractères représentant la date et l'heure de l'entrée *datetime_expression* après application de *modifier*.

* * *

## Exemples

### Convertir une heure UTC en heure locale avec le modificateur `localtime`

```sql
SELECT name, timeCreated,
datetime(timeCreated, 'localtime') as local_time_created
FROM google.storage.buckets WHERE project = 'stackql';
```

### Convertir une date et heure en UTC

```sql
SELECT name, timeCreated,
datetime('now', 'utc') as now_utc
FROM google.storage.buckets WHERE project = 'stackql';
```

### Calculer une date par rapport à une autre date

```sql
SELECT name, timeCreated,
datetime(timeCreated, '+24 hours') as a_day_later
FROM google.storage.buckets WHERE project = 'stackql';
```

### Obtenir le prochain jour de la semaine spécifié après une date donnée

```sql
SELECT name, timeCreated,
datetime(timeCreated, 'weekday 0') as following_sunday
FROM google.storage.buckets WHERE project = 'stackql';
```

### Obtenir le début du mois pour une date donnée

```sql
SELECT name, timeCreated,
datetime(timeCreated, 'start of month') as start_of_month
FROM google.storage.buckets WHERE project = 'stackql';
```

### Convertir un horodatage Unix en date et heure

```sql
SELECT datetime(1576417943, 'unixepoch') as date_from_ts
FROM google.storage.buckets WHERE project = 'stackql';
```

:::tip 

Pour convertir une date et heure en horodatage epoch Unix, consultez [**STRFTIME**](/language-spec/functions/datetime/strftime).  Pour calculer la différence entre deux objets de date et d'heure, consultez [**STRFTIME**](/language-spec/functions/datetime/strftime) ou [**JULIANDAY**](/language-spec/functions/datetime/julianday).

:::

Pour plus d'informations, consultez [https://www.sqlite.org/lang_datefunc.html](https://www.sqlite.org/lang_datefunc.html)