Syntaxe de XAML DateTime

Certains contrôles, tels que Calendar et DatePicker, ont des propriétés qui utilisent le DateTime type. Bien que vous spécifiiez généralement une date ou une heure initiale pour ces contrôles dans le code-behind au moment de l’exécution, vous pouvez spécifier une date ou une heure initiale en XAML. L’analyseur XAML WPF gère l’analyse des DateTime valeurs à l’aide d’une syntaxe de texte XAML intégrée. Cette rubrique décrit les spécificités de la DateTime syntaxe de texte XAML.

Quand utiliser la syntaxe XAML DateTime

La définition de dates en XAML n’est pas toujours nécessaire et peut même ne pas être souhaitable. Par exemple, vous pouvez utiliser la DateTime.Now propriété pour initialiser une date au moment de l’exécution, ou vous pouvez effectuer tous vos ajustements de date pour un calendrier dans le code-behind en fonction de l’entrée utilisateur. Toutefois, il existe des scénarios où vous souhaiterez peut-être coder en dur des dates dans un modèle de contrôle avec Calendar et DatePicker. La DateTime syntaxe XAML doit être utilisée pour ces scénarios.

La syntaxe XAML DateTime est un comportement natif

DateTime est une classe définie dans les bibliothèques de classes de base du CLR. En raison de la relation entre les bibliothèques de classes de base et le reste du CLR, il n’est pas possible d’appliquer TypeConverterAttribute à la classe et d’utiliser un convertisseur de type pour traiter les chaînes à partir de XAML et les convertir en DateTime dans le modèle objet d’exécution. Il n’existe aucune DateTimeConverter classe qui fournit le comportement de conversion ; le comportement de conversion décrit dans cette rubrique est natif de l’analyseur XAML WPF.

Mettre en forme des chaînes pour la syntaxe XAML DateTime

Vous pouvez spécifier le format d’un DateTime à l'aide d'une chaîne de format. Les chaînes de format formalisent la syntaxe de texte qui peut être utilisée pour créer une valeur. DateTime les valeurs des contrôles WPF existants utilisent généralement uniquement les composants de date et DateTime non les composants d’heure.

Lorsque vous spécifiez un DateTime code XAML, vous pouvez utiliser l’une des chaînes de format de manière interchangeable.

Vous pouvez également utiliser des formats et des chaînes de format qui ne sont pas spécifiquement affichées dans cette rubrique. Techniquement, le code XAML pour toute valeur DateTime spécifiée, puis analysée par l'analyseur XAML WPF utilise un appel interne à DateTime.Parse, par conséquent, vous pouvez utiliser une chaîne DateTime.Parse acceptée pour votre entrée XAML. Pour plus d’informations, consultez DateTime.Parse.

Les sections suivantes décrivent certaines des chaînes de format courantes DateTime .

Modèle de date courte (« d »)

L’exemple suivant montre le format de date court pour un DateTime en XAML :

M/d/YYYY

Il s’agit du formulaire le plus simple qui spécifie toutes les informations nécessaires pour les utilisations classiques par les contrôles WPF et qui ne peut pas être influencé par des décalages de fuseau horaire accidentels par rapport à un composant de temps, et est donc recommandé sur les autres formats.

Par exemple, pour spécifier la date du 1er juin 2010, utilisez la chaîne suivante :

3/1/2010

Pour plus d’informations, consultez DateTimeFormatInfo.ShortDatePattern.

Modèle de Date-heure Triable (« s »)

Les éléments suivants illustrent le modèle triable DateTime en XAML :

yyyy'-'MM'-'dd'T'HH':'mm':'ss

Par exemple, pour spécifier la date du 1er juin 2010, utilisez la chaîne suivante (les composants d’heure sont tous entrés comme 0) :

2010-06-01T000:00:00

modèle RFC1123 (« r »)

Le modèle RFC1123 est utile, car il peut s’agir d’une entrée de chaîne à partir d’autres générateurs de dates qui utilisent également le modèle RFC1123 pour des raisons invariantes de culture. Voici le modèle RFC1123 DateTime en XAML :

ddd, dd MMM yyyy HH':'mm':'ss 'UTC'

Par exemple, pour spécifier la date du 1er juin 2010, utilisez la chaîne suivante (les composants d’heure sont tous entrés comme 0) :

Mon, 01 Jun 2010 00:00:00 UTC

Autres formats et modèles

Comme indiqué précédemment, un DateTime dans XAML peut être spécifié en tant que chaîne acceptable comme entrée pour DateTime.Parse. Cela inclut d’autres formats formalisés (par exemple UniversalSortableDateTimePattern), et les formats qui ne sont pas formalisés comme une forme particulière DateTimeFormatInfo . Par exemple, le formulaire YYYY/mm/dd est acceptable comme entrée pour DateTime.Parse. Cette rubrique ne tente pas de décrire tous les formats possibles qui fonctionnent, mais recommande plutôt le modèle de date courte comme pratique standard.

Voir aussi

• XAML dans WPF