aboutsummaryrefslogtreecommitdiff
path: root/files/fr/web/css/time/index.md
blob: c60d751bfc89ae8c72eb2032dcc835904e8d52b3 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
---
title: <time>
slug: Web/CSS/time
tags:
  - CSS
  - Reference
  - Type
translation_of: Web/CSS/time
---
{{CSSRef}}

Le type de donnée **`<time>`** indique des durées exprimées en secondes ou en millisecondes. Il est par exemple utilisé dans les propriétés {{cssxref("animation")}}, {{cssxref("transition")}}.

## Syntaxe

Une valeur temporelle consiste en une valeur de type {{cssxref("&lt;number&gt;")}} immédiatement suivie d'une unité. Comme avec les autres unités CSS, il n'y a pas d'espace entre l'unité et le nombre. La valeur peut éventuellement être précédée d'un signe `+` ou `-`.

Même si toutes les unités représentent le même temps pour la valeur `0`, l'unité ne doit pas être omises, car il ne s'agit pas d'une {{cssxref("&lt;length&gt;")}} : `0` n'est pas valide et ne représente pas `0s`, `0ms`.

### Unités

- `s`
  - : Cette unité permet d'exprimer le temps en secondes. Par exemple : `0s`, `1.5s`, `-60s`.
- `ms`
  - : Cette unité permet d'exprimer le temps en millisecondes. Par exemple : `0ms`, `1500ms`, `-6000ms`.

La conversion entre `s` et `ms` suit la logique suivante : `1s = 1000ms`.

## Exemples

### Valeurs valides

```css example-good
12s         Nombre entier positif
-456ms      Nombre entier négatif
4.3ms       Nombre décimal
14mS        L'unité n'est pas sensible à la casse, cependant les majuscules sont déconseillées pour s et ms.
+0s         Zero, précédé d'un + et suivi de son unité.
-0ms        Zero, précédé d'un - et suivi de son unité (bien qu'étrange, ceci est autorisé).
```

### Valeurs invalides

```css example-bad
0           Bien qu'un zéro sans unité soit autorisé pour les longueurs, ceci n'est pas valide avec les autres dimensions.
12.0        Il s'agit d'un nombre, pas d'un temps, l'unité est obligatoire.
7 ms        Aucun espace n'est autorisé entre le nombre et l'unité.
```

## Spécifications

| Spécification                                                                | État                             | Commentaires                         |
| ---------------------------------------------------------------------------- | -------------------------------- | ------------------------------------ |
| {{SpecName('CSS4 Values','#time','&lt;time&gt;')}}         | {{Spec2('CSS4 Values')}} |                                      |
| {{SpecName('CSS3 Values','#time','&lt;time&gt;')}}         | {{Spec2('CSS3 Values')}} | Définition normative de `s` et `ms`  |
| {{SpecName('CSS2.1','aural.html#times','&lt;time&gt;')}} | {{Spec2('CSS2.1')}}         | Définition informelle de `s` et `ms` |

## Compatibilité des navigateurs

{{Compat("css.types.time")}}