> For the complete documentation index, see [llms.txt](https://documentation.soulver.app/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://documentation.soulver.app/fr/reference-de-syntaxe/dates/dates-and-times.md).

# Calculs de calendrier

Fini de compter les jours sur un calendrier !

### Ajouter ou soustraire du temps à des dates

```
10 June + 3 weeks                     | 1 July
April 1, 2019 − 3 months 5 days       | 27 December 2018

12/02/1988 + 32 years                 | 12 February 2020
01.05.2005 + 3 years 2 months 3 weeks | 22 July 2008

3 weeks after March 14, 2019          | 4 April 2019
28 days before March 12               | 12 February
2 months 3 days after June 5          | 8 August

yesterday - 8 weeks 3 days            | 12 July
Yesterday + 1 week                    | 11 June
```

### Obtenir une date relative au présent

```
today + 3 weeks | 1 October
now − 1 month   | 5 May

4 days from now | 14 September
3 days ago      | 7 September
```

### Calculs avec jours fériés nommés

Vous pouvez utiliser des noms de jours fériés dans les calculs de dates. Par exemple, `days until Christmas` compte à rebours jusqu'à Noël.

Pour les jours fériés dont les dates changent chaque année, précisez l'année pour retrouver la date :

`Easter 2027` → **March 28, 2027**

**Fêtes et dates spéciales prises en charge**

* **Noël :** Réveillon de Noël, jour de Noël, lendemain de Noël, Noël orthodoxe
* **Pâques :** Vendredi Saint, Samedi Saint, Dimanche de Pâques, Lundi de Pâques, Vendredi Saint orthodoxe, Pâques orthodoxe
* **Nouvel An :** Réveillon du Nouvel An, Jour de l'An, Réveillon du Nouvel An chinois, Nouvel An chinois
* **Ramadan :** Ramadan (le début), Fin du Ramadan
* **Hanoucca :** Hanoukka (le début), Fin de Hanoukka
* **Autres dates :** Saint-Valentin, Halloween, Thanksgiving (États-Unis), Black Friday

Ces noms peuvent être utilisés dans les calculs, que les dates soient ou non jours fériés dans votre pays.

### **Trouver la durée entre deux dates**

```
January 10 - February 5         | 3 weeks 5 days

3 March to 30 May               | 2 months 3 weeks 6 days

days since July 15              | 57 days
days till December 25           | 106 days
days between 3 March and 30 May | 88 days

1978 to 2021                    | 42 years

```

{% hint style="info" %}
Les intervalles de temps sont calculés du midi de la première date au midi de la dernière date de l'intervalle.

Utilisez la fonction d'intervalle inclusif si vous souhaitez inclure à la fois la date de début et la date de fin dans l'intervalle (voir [ci-dessous](#inclusive-intervals-of-time-1))
{% endhint %}

### Intervalles de temps inclusifs entre deux dates <a href="#inclusive-intervals-of-time" id="inclusive-intervals-of-time"></a>

```
April 1 through April 30 in days | 30 days
```

### Numéros de semaine (ISO 8601)

```
week of year                  | 36
week number on march 12, 2021 | 10
```

### Obtenir des parties d'un rendez-vous

Recherchez la position d’une date dans l’année ou le mois :

`day number on March 15, 2024` → **75**

`day of month on March 15, 2024` → **15**

Sans date, `day of year` et `day of month` sont utilisés aujourd'hui.

### **Nombre de jours dans un mois ou un trimestre**

```
days in Q3            | 92 days
days in February 2020 | 29 days
```

### Combien d’années s’est écoulée ?

Tapez `year percentage` pour voir la durée de l'année en cours écoulée, exprimée en pourcentage.

Vous pouvez également utiliser `month percentage`, `week percentage` ou `day percentage` pour le mois, la semaine ou le jour en cours.

### Trouver le point médian entre deux dates

```
midpoint between March 12 and April 5   | 24 March
halfway between today and next Thursday | 13 September
```

### Formatage des dates

Utilisez un modèle de format pour contrôler la façon dont une date est affichée :

`March 12, 2023 as EEEE, MMM d, yyyy` → **Sunday, Mar 12, 2023**

Ici, `EEEE` donne le nom du jour de la semaine, `MMM` le mois abrégé, `d` le jour du mois et `yyyy` l'année à quatre chiffres.

Visitez [NSDateFormatter.com](https://www.nsdateformatter.com) pour découvrir les symboles de format et expérimenter vos propres modèles.

## Notes sur l'ambiguïté des calculs de calendrier

**Mois ambigus**

Contrairement aux jours et aux semaines, les mois ne sont pas clairement définis en termes de secondes. Soulver tente de faire ce qui est le plus logique étant donné l'expression. Il est intelligent pour prendre en compte les années bissextiles et autres particularités du calendrier :

```
Feb 28 + 1 month          | 28 March
January 31 2020 + 1 month | February 29 2020
```

**Dates sans année spécifiée**

Une date sans année spécifiée peut utiliser l'année en cours ou l'année suivante.

```
# In December 2019

// next year is assumed, as the nearest January is in the future
January 12 + 3 weeks | 2 February 2020

// this year is assumed, as the month is still recently in the past
November 1 - 5 days  | 27 October 2019
```
