===== QDate ===== La classe QDate fournit des fonctions pour gérer des dates. [[#Description détaillée|Plus d'informations...]] **Note :** toutes les fonctions dans cette classe sont [[#reentrant|réentrantes]]. ==== Description détaillée ==== La classe QDate fournit des fonctions pour gérer des dates. Un objet QDate contient une date, cela veut dire une année, un mois, un jour et un numéro (1 - 31) du calendrier grégorien (voir [[#utilisation du calendrier grégorien et julien]] pour les dates antérieures au 15 Octobre 1582). Il peut lire la date actuelle de l'horloge système. Il fournit des fonctions de comparaison et de manipulation de dates. Par exemple, il est possible d'ajouter et de soustraire des jours, des mois et des années à des dates. Un objet QDate est souvent construit en donnant l'année, le mois et le numéro du jour. Notez que QDate interprète les années à deux chiffres (exemple : année 0 – 99). QDate peut aussi être construit avec la fonction statique [[#CurrentDate()]], qui crée un objet QDate contenant la date de l'horloge système. Une date explicite peut être définie aussi en utilisant [[#setDate()]]. La fonction [[#fromString()]] prend deux arguments, une chaîne de caractères et une chaîne représentant le format de la date qui est utilisé sur cette première, et au final elle retourne un objet QDate. Les fonctions [[#year()]], [[#month()]], [[#day()]] donnent accès à l'année, au mois et au chiffre du jour. Ainsi que les fonctions [[#dayOfWeek()]] (jours de la semaine) et [[#dayOfYear()]] (jour de l'année) qui retournent le nombre approprié. La même information est accessible sous forme de texte avec les fonctions [[#toString()]], [[#shortDayName()]], [[#shortMonthName()]], et [[#longMonthName()]]. QDate fournit un ensemble complet d'opérateurs permettant de comparer deux objets QDate, où plus petit signifie antérieur et plus grand signifie postérieur. Vous pouvez incrémenter (ou décrémenter) une date par un certain nombre de jours en utilisant [[#addDays()]]. De même, vous pouvez utiliser [[#addMonths()]] (pour les mois) et [[#addYears()]] (pour les années). La fonction [[#daysTo()]] retourne le nombre de jours entre deux dates. Les fonctions [[#daysInMonth()]] et [[#daysInYear()]] retournent le nombre de jours du mois ou de l'année. La fonction [[#isLeapYear()]] indique si l'année passée en argument est une année bissextile ou non. === Utilisation du calendrier grégorien et julien === QDate utilise le calendrier grégorien dans tous les cas, en commençant à la date du 15 octobre 1582. Pour les dates allant jusqu'au 4 octobre 1582 inclus, le calendrier julien est utilisé. Ce qui signifie qu'il y a un écart de 10 jours à l'intérieur du calendrier entre le 4 et le 15 octobre 1582. Quand vous utilisez [[QDateTime]] pour les dates de cette époque, le jour après le 4 octobre 1582 est le 15 octobre 1582, et les dates entre les deux sont invalides. Le passage de date de Jules à Grégoire utilisé ici est la date à laquelle le calendrier grégorien est introduit pour la première fois, par le Pape Gregoire XIII. Ce changement n'est pas universellement accepté et certaines localités l'ont seulement exécuté à une date ultérieure (le cas échéant). [[QDateTime]] ne prend aucun de ces faits historiques en compte. Si une application doit soutenir une spécification locale du système de datation, il doit le faire de sa propre initiative, sans oublier de convertir les dates à l'aide du jour julien. === L'année 0 === Il n'y a pas d'année 0. Les dates de cette année sont considérées comme invalides. L'année -1 est l'année ''1 avant J.-C.'' ou ''1 an avant l'ère actuelle''. Le jour avant 0001-01-01 est le 31 décembre 1 ACN (avant l'ère actuelle). === Fourchette des dates valides === La fourchette des dates valides est du 2 janvier 4713 ACN à l'année 11 millions CE. Le jour julien retourné par [[#tojulienDay()]] est un nombre proche de 1 jusqu'à débordement, même à travers l'écart du calendrier de [[QDateTime]]. Elle est adaptée pour une utilisation dans des applications qui doivent convertir un [[doc:4.5:QDateTime]] en une date d'un autre système de calendrier, exemple, l'hébreu, l'islamique ou le chinois. Voir aussi [[QTime]], [[QDateTime]], [[QDateEdit]], [[QDateTimeEdit]] et [[QCalendarWidget]]. ==== Types membres ==== === MonthNameType-enum === ''enum QDate::MonthNameType'' Cette énumération décrit les types de représentation de la chaîne de caractères utilisée pour le nom du mois. ^ Constante ^ Valeur ^ Description ^ | ''QDate::DateFormat'' | 0 | Ce type de nom peut être utilisé pour le formatage de la date en chaîne de caractères. | | ''QDate::StandaloneFormat'' | 1 | Ce type est utilisé quand vous avez besoin d'énumérer les mois ou les semaines. Généralement, les noms autonomes sont représentés dans leur forme singulière avec la première lettre en majuscule. | Cette énumération a été introduite à partir de Qt 4.5. ==== Fonctions membres ==== === QDate() === ''QDate::QDate ()'' Construit une date vide. Les dates vides sont invalides. Voir aussi [[#isNull()]] et [[#isValid()]]. === QDate() === ''QDate::QDate ( int y, int m, int d )'' Construit une date avec l'année ''y'', le mois ''m'' et le jour ''d''. Si la date spécifiée est invalide, la date ne sera pas modifiée et [[#isValid()]] retournera false. Une date avant le 2 Janvier 4713 avant J.C est considérée comme invalide. **Attention :** Les années de 0 à 99 ans sont interprétées en tant que telles, ce qui veut dire qu'il est impossible de mettre 10 pour signifier l'année 2010. Voir aussi [[#isValid()]]. === addDays() === ''QDate QDate::addDays ( int ndays ) const'' Retourne un objet QDate contenant ''ndays'' (nombre de jours) en plus de la date de cet objet (ou en moins si ''ndays'' est négatif). Voir aussi [[#addMonths()]], [[#addYears()]] et [[#daysTo()]]. === addMonths() === ''QDate QDate::addMonths ( int nmonths ) const'' Retourne un objet QDate contenant ''nmonths'' (nombre de mois) en plus de la date de cet objet (ou en moins si ''nmonths'' est négative). **Note :** Si la dernière combinaison jour/mois n'existe pas dans le résultat mois/année, cette fonction retournera la dernière date valide. **Attention :** [[QDate]] possède une cavité temporelle autour des jours introduisant le calendrier Grégorien (les jours du 5 au 14 Octobre 1582 inclus, n'existe pas). Si le résultat du calcul tombe sur l'un de ces jours, [[QDate]] retournera soit le 4 Octobre, soit le 15 Octobre. Voir aussi [[#addDays()]] et [[#addYears()]]. === addYears() === ''QDate QDate::addYears ( int nyears ) const'' Retourne un objet [[QDate]] contenant ''nyears'' (nombre d'années) en plus de la date de cet objet (ou en moins si ''nyears'' est négative). **Note :** Si la dernière combinaison jour/mois n'existe pas dans l'année résultante (c'est-à-dire, si la date était le 29 février et que l'année n'est pas bissextile), cette fonction retournera la dernière date valide (le 28 Février). Voir aussi [[#addDays()]] et [[#addMonths()]]. === currentDate() === ''QDate QDate::currentDate () [static]'' Ceci est une fonction membre surchargée. Retourne la date actuelle indiquée par l'horloge système. Voir aussi [[qtime#currentTime|QTime::currentTime()]] et [[qdatetime#currentDateTime|QDateTime::currentDateTime()]]. === day() === ''int QDate::day () const'' Retourne le jour du mois (1 à 31) de cette date. Voir aussi [[#year()]], [[#month()]] et [[#dayOfWeek()]]. === dayOfWeek() === ''int QDate::dayOfWeek () const'' Retourne le jour de la semaine (1 à 7) de cette date Voir aussi [[#day()]], [[#dayOfYear()]] et [[qt#DayOfWeek-enum|Qt::dayOfWeek]]. === dayOfYear() === ''int QDate::dayOfYear () const'' Retourne le jour de l'année (1 a 365 ou 366 cela dépend si l'année est bissextile) de cette date. Voir aussi [[#day()]] et [[#dayOfWeek()]]. === daysInMonth() === ''int QDate::daysInMonth () const'' Retourne le nombre de jours que le mois contient (28 à 31) à cette date. Voir aussi [[#day()]] et [[#daysInYear()]]. === daysInYear() === ''int QDate::daysInYear () const'' Retourne le nombre de jours que l'année contient (365 ou 366) à cette date. Voir aussi [[#day()]] et [[#daysInMonth()]]. === daysTo() === ''int QDate::daysTo ( const QDate & d ) const'' Retourne le nombre de jours entre sa date et la date ''d'' (Peut être négatif si ''d'' est antérieur à cette date) Exemple : QDate d1(1995, 5, 17); // 17 Mai 1995 QDate d2(1995, 5, 20); // 20 Mai 1995 d1.daysTo(d2); // retourne 3 d2.daysTo(d1); // retourne -3 Voir aussi [[#addDays()]]. === fromjulianDay() === ''QDate QDate::fromjulianDay ( int''jd'' ) [static]'' Convertit le jour ''jd'' du calendrier julien en un [[QDate]]. Voir aussi [[#toJulianDay()]]. === fromString() === ''QDate QDate::fromString ( const [[QString]] & string, [[qt#DateFormat-enum|Qt::DateFormat]] format = Qt::TextDate ) [static]'' Retourne la [[QDate]] représentée par la chaîne de caractères ''string'', utilisant le ''format'' donné, ou une date invalide si la chaîne de caractères ne peut être parsée. Note pour [[qt#DateFormat-enum|Qt::TextDate]] : Il est recommandé d'utiliser le nom abrégé des mois en Anglais (ex. : "Jan" , "Feb" ). Selon la configuration des paramètres locaux de l'utilisateur, il est aussi possible d'utiliser les noms locaux des mois ("français"). === fromString() === ''QDate QDate::fromString ( const [[QString]] & string, const [[QString]] & format ) [static]'' Retourne la [[QDate]] représentée par la chaîne de caractères ''string'', utilisant le ''format'' donné, ou une date invalide si la chaîne de caractères ne peut être parsée. Ces expressions peuvent être utilisées pour le format : ^ Expression ^ Sortie ^ | d | Le jour est un nombre qui ne commence pas par zéro (1 à 31). | | dd | Le jour est un nombre qui commence par zéro (01 à 31). | | ddd | L'abréviation du nom local du jour (ex. : 'Lun' à 'Dim'). Utilise [[#shortDayName|QDate::shortDayName()]]. | | dddd | Le nom local du jour (ex. : 'Lundi' à 'Dimanche'). Utilise [[#longDayName|QDate::longDayName()]]. | | M | Le mois est un nombre qui ne commence pas par zéro (1 à 12). | | MM | Le mois est un nombre qui commence par zéro (01 à 12). | | MMM | L'abréviation du nom local du mois (ex. : 'Jan' à 'Dec'). Utilise QDate::shortMonthName (). | | MMMM | Le nom local du mois (e.g. 'Janvier' à 'Décembre'). Utilise QDate::longMonthName (). | | yy | L'année sur deux chiffres (00 à 99). | | yyyy | L'année sur quatre chiffres. Si l'année est négative, le signe moins est ajouté devant. | Toutes les autres entrées sont traitées comme du texte. Toutes les chaînes de caractères qui sont entre des guillemets simples sont traitées comme du texte et non comme une expression. Par exemple : QDate date = QDate::fromString("1MM12car2003", "d'MM'MMcaryyyy"); // ''date'' est le 1 décembre 2003 Si le format n'est pas défini correctement, une [[QDate]] invalide est retournée. Dans certains cas, il est préférable d'éviter les expressions de format qui ne requièrent pas les zéros de début de chaine. C'est le cas des expressions de format d et M qui se baseront sur deux chiffres, même si ceux-ci sont en dehors de la plage d'acceptation, et qui ne laisseront plus assez de chiffres disponibles pour la suite de l'expression de format. Dans l'exemple ci-dessous, on aurait pu s'attendre à obtenir la date du 30 Janvier, mais le résultat est en réalité invalide car M va récupérer deux chiffres : QDate date = QDate::fromString("130", "Md"); // retourne une date invalide Pour tous les champs qui ne sont pas représentés dans le format, les valeurs par défaut suivantes seront utilisées : ^ Champ ^ Valeur par défaut ^ | Année | 1900 | | Mois | 1 | | Jour | 1 | Les exemples suivants illustrent les valeurs par défaut: QDate::fromString("1.30", "M.d"); // 30 Janvier 1900 QDate::fromString("20000110", "yyyyMMdd"); // 10 Janvier 2000 QDate::fromString("20000110", "yyyyMd"); // 10 janvier 2000 Voir aussi [[qdatetime#fromString|QDateTime::fromString(), [[qtime#fromString|QTime::fromString()]], [[qdate#toString|QDate::toString()]], [[qdatetime#toString|QDateTime::toString()]] et [[qtime#toString|QTime::toString()]]. === getDate() === ''void QDate::getDate ( int * year, int * month, int * day )'' Extrait la date, l'année, le mois et le jour, et les assigne à ''*year'', ''*month'' et ''*day''. Les pointeurs peuvent être nuls. Cette fonction a été introduite à partir de Qt 4.5. Voir aussi [[#year()]], [[#month()]], [[#day()]] et [[#isValid()]]. === isLeapYear() === ''bool QDate::isLeapYear ( int year ) [static]'' Retourne ''true'' si l'année spécifiée dans ''year'' est une année bissextile, sinon retourne false. === isNull() === ''bool QDate::isNull () const'' Retourne ''true'' si la date est nulle, sinon retourne false. Une date nulle est invalide. **Note :** Le comportement de cette fonction est équivalent à [[#isValid()]]. Voir aussi [[#isValid()]]. === isValid() === ''bool QDate::isValid () const'' Retourne ''true'' si la date est invalide, sinon retourne false. Voir aussi isNull(). === isValid() === ''bool QDate::isValid ( int year, int month, int day ) [static]'' Ceci est une fonction membre surchargée. Retourne ''true'' si la date spécifiée (''year'', ''month'', et ''day'') est valide, sinon retourne false. Exemple : QDate::isValid(2002, 5, 17); // ''true'' QDate::isValid(2002, 2, 30); // ''false'' (30 Février n'existe pas) QDate::isValid(2004, 2, 29); // ''true'' (2004 est une année bissextile) QDate::isValid(2000, 2, 29); // ''true'' (2000 est une année bissextile) QDate::isValid(2006, 2, 29); // ''false'' (2006 n'est pas une année bissextile) QDate::isValid(2100, 2, 29); // ''false'' (2100 n'est pas une année bissextile) QDate::isValid(1202, 6, 6); // ''true'' (bien que 1202 est pré-Grégorien) Voir aussi [[#isNull()]] et [[#setDate()]]. === longDayName() === ''[[QString]] QDate::longDayName ( int weekday ) [static]'' Retourne la version longue du nom du jour de ''weekday'' (ex. : 'Lundi'). Le nom retourné est de type normal et peut être utilisé pour le formatage de date. Voir aussi [[#toString()]], [[#shortDayName()]], [[#shortMonthName()]] et [[#longMonthName()]]. === longDayName() === ''[[QString]] QDate::longDayName ( int weekday, [[qdate#MonthNameType-enum|MonthNameType]] type ) [static]'' Retourne le long nom de ''weekday'' pour la représentation spécifiée par le type. Les jours sont énumérés selon la convention suivante : * 1 = "Lundi" * 2 = "Mardi" * 3 = "Mercredi" * 4 = "Jeudi" * 5 = "Vendredi" * 6 = "Samedi" * 7 = "Dimanche" Les noms des jours sont basés sur ceux qui sont paramétrés dans le système local. Cette fonction a été introduite à partir de Qt 4.5. Voir aussi [[#toString()]], [[#shortDayName()]], [[#shortMonthName()]] et [[#longMonthName()]]. === longMonthName() === ''[[QString]] QDate::longMonthName ( int month ) [static]'' Retourne la version longue du nom du mois ''month'' (ex. : 'Janvier'). Le nom retourné est de type normal et peut être utilisé pour le formatage de date. Voir aussi [[#toString()]], [[#shortMonthName()]], [[#shortDayName()]] et [[#longDayName()]]. === longMonthName() === ''[[QString]] QDate::longMonthName ( int month, [[qdate#MonthNameType-enum|MonthNameType]] type ) [static]'' Retourne le nom long de ''month'' pour la représentation spécifiée par ''type''. Les mois sont énumérés selon la convention suivante : * 1 = "Janvier" * 2 = "Février" * 3 = "Mars" * 4 = "Avril" * 5 = "Mai" * 6 = "Juin" * 7 = "Juillet" * 8 = "Août" * 9 = "Septembre" * 10 = "Octobre" * 11 = "Novembre" * 12 = "Décembre" Les noms des mois sont basés sur ceux qui sont paramètrés dans le systeme local. Cette fonction a été introduite à partir de Qt 4.5. Voir aussi [[#toString()]], [[#shortMonthName()]], [[#shortDayName()]] et [[#longDayName()]]. === month() === ''int QDate::month () const'' Retourne le numéro correspondant au mois de cette date, utilisant la convention suivante : * 1 = "Janvier" * 2 = "Février" * 3 = "Mars" * 4 = "Avril" * 5 = "Mai" * 6 = "Juin" * 7 = "Juillet" * 8 = "Août" * 9 = "Septembre" * 10 = "Octobre" * 11 = "Novembre" * 12 = "Décembre" Voir aussi [[#year()]] et [[#day()]]. === setDate() === ''bool QDate::setDate ( int year, int month, int day )'' Fixe la date avec ''year'', ''month'' et ''day''. Retourne ''true'' si la date est valide, sinon false. Si la date spécifiée est invalide, l'objet [[QDate]] sera invalide. Toute date avant le 2 Janvier 4713 avant J.C sera considérée comme invalide. Cette fonction a été introduite à partir de Qt 4.2. Voir aussi [[#isValid()]]. === shortDayName() === ''[[QString]] QDate::shortDayName ( int weekday ) [static]'' Retourne le nom abrégé du jour de ''weekday'' (ex. : 'Lun'). Le nom retourné est de type normal et peut être utilisé pour le formatage de date. Voir aussi [[#toString()]], [[#longDayName()]], [[#shortMonthName()]] et [[#longMonthName()]]. === shortDayName() === ''[[QString]] QDate::shortDayName ( int weekday, MonthNameType type ) [static]'' Retourne le nom abrégé du jour ''weekday'' (ex. : 'Lun') pour la représentation spécifiée par ''type''. Les jours sont énumérés selon la convention suivante : * 1 = "Lun" * 2 = "Mar" * 3 = "Mer" * 4 = "Jeu" * 5 = "Ven" * 6 = "Sam" * 7 = "Dim" Les noms des jours sont basés sur ceux qui sont paramétrés dans le système local. Cette fonction a été introduite à partir de Qt 4.5. Voir aussi [[#toString()]], [[#longDayName()]], [[#longMonthName()]] et [[#longDayName()]]. === shortMonthName() === ''[[QString]] QDate::shortMonthName ( int month ) [static]'' Retourne le nom abrégé de ''month'' (ex. : 'Jan'). Le nom retourné est de type normal et peut être utilisé pour le formatage de date. Voir aussi [[#toString()]], [[#longMonthName()]], [[#shortDayName()]] et [[#longDayName()]]. === shortMonthName() === ''[[QString]] QDate::shortMonthName ( int month, MonthNameType type ) [static]'' Retourne le nom abrégé du mois ''month'' (ex. : 'Jan') pour la représentation spécifiée par ''type''. Les mois sont énumérés selon la convention suivante : * 1 = "Jan" * 2 = "Fév" * 3 = "Mar" * 4 = "Avr" * 5 = "Mai" * 6 = "Jui" * 7 = "Jul" * 8 = "Aoû" * 9 = "Sep" * 10 = "Oct" * 11 = "Nov" * 12 = "Déc" Les noms des mois sont basés sur ceux qui sont paramètrés dans le systeme local. Cette fonction a été introduite à partir de Qt 4.5. Voir aussi [[#toString()]], [[#longMonthName()]], [[#shortDayName()]] et [[#longDayName()]]. === tojulianDay() === ''int QDate::tojulianDay () const'' Convertit la date en un jour julien. Voir aussi [[#fromjulianDay()]]. === toString() === ''[[QString]] QDate::toString ( const QString & format ) const'' Retourne la date sous forme de chaîne de caractères. Le paramètre ''format'' détermine le format du résultat de la chaîne de caractères. Ces expressions peuvent être utilisées : ^ Expression ^ Sortie ^ | d | Le jour est un nombre qui ne commence pas par zéro (1 à 31). | | dd | Le jour est un nombre qui commence par zéro (01 à 31). | | ddd | L'abréviation du nom local du jour (ex. : 'Lun' à 'Dim'). Utilise [[#shortDayName|QDate::shortDayName()]]. | | dddd | Le nom local du jour (ex. : 'Lundi' à 'Dimanche'). Utilise [[#longDayName|QDate::longDayName()]]. | | M | Le mois est un nombre qui ne commence pas par zéro (1 à 12). | | MM | Le mois est un nombre qui commence par zéro (01 à 12). | | MMM | L'abréviation du nom local du mois (ex. : 'Jan' à 'Dec'). Utilise [[#shortMonthName|QDate::shortMonthName()]]. | | MMMM | Le nom local du mois (e.g. 'Janvier' à 'Décembre'). Utilise [[#longMonthName|QDate::longMonthName()]]. | | yy | L'année sur deux chiffres (00 à 99). | | yyyy | L'année sur quatre chiffres. Si l'année est négative, le signe moins est ajouté au début. | Toutes les autres caractères seront ignorés. Toutes les chaînes de caractères qui sont entre guillemets simples sont traitées comme texte et non comme expression. Deux guillemets simples consécutifs sont remplacés par un simple guillemet à la sortie. Exemple de formats de chaîne de caractères (en supposant que l'objet QDate est le 20 Juillet 1969) : ^ Format ^ Résultat ^ | dd.MM.yyyy | 20.07.1969 | | ddd MMMM d yy | dim juillet 20 69 | | 'Le jour est' dddd | Le jour est dimanche | Si la date est invalide, une chaîne vide sera retournée. **Attention :** Le format [[qt#DateFormat-enum|Qt::ISODate]] est valide seulement pour les années comprises entre 0 et 9999 incluse. Cette restriction s'applique au format local actuel selon les paramètres locaux fixés. Voir aussi [[qdatetime#toString|QDateTime::toString()]] et [[qtime#toString|QTime::toString()]]. === toString() === ''[[QString]] QDate::toString ( [[qt#DateFormat-enum|Qt::DateFormat]] format = Qt::TextDate ) const'' Ceci est une fonction membre surchargée. Retourne la date sous forme de chaîne de caractères. Le paramètre ''format'' détermine le format de la chaîne. Si ''format'' est [[qt#DateFormat-enum|Qt::TextDate]], la chaîne est formatée par défaut. [[#shortDayName|QDate::shortDayName()]] et [[#shortMonthName|QDate::shortMonthName()]] sont utilisés pour générer la chaîne de caractères, dont les noms des jours et des mois utilisés sont ceux du système. Un exemple de ce formatage est "Sam. Mai 20 1995". Si ''format'' est [[qt#DateFormat-enum|Qt::ISODate]], le format de chaîne correspond à la norme internationale ISO 8601, qui spécifie la représentation numérique de la date et de l'heure, prenant la forme YYY-MM-DD, où YYY est l'année, MM est le mois de l'année (entre 01 et 12) et DD est le jour du mois entre 01 et 31. Un exemple de ce formatage est "1995-05-20". Si ''format'' est [[qt#DateFormat-enum|Qt::SystemLocaleShortDate]] ou [[qt#DateFormat-enum|Qt::SystemLocaleLongDate]], le format de la chaîne de caractères dépendra de la configuration locale du système. Même principe pour l'appel de [[qlocale#system|QLocale::system()]].toString(date, [[qlocale#FormatType-enum|QLocale::ShortFormat]]) ou [[qlocale#system|QLocale::system()]].toString(date, [[qlocale#FormatType-enum|QLocale::LongFormat]]). Un exemple du formatage Qt::SystemLocaleLongDate est "Samedi 20 Mai 1995". Si ''format'' est [[qt#DateFormat-enum|Qt::DefaultLocaleShortDate]] ou [[qt#DateFormat-enum|Qt::DefaultLocaleLongDate]], le format de la chaîne de caractères dépendra de l'application locale par défaut. Cette application locale peut être modifiée avec [[qlocale#setDefault|QLocale::setDefault()]], ou le système local si aucune valeur locale par défaut n'a été fixée. Même principe pour l'appel de QLocale().toString(date, [[qlocale#FormatType-enum|QLocale::ShortFormat]]) ou QLocale().toString(date, [[qlocale#FormatType-enum|QLocale::LongFormat]]). Si la date est invalide, une chaîne de caractères vide sera retournée. **Attention :** Le format [[qt#DateFormat-enum|Qt::ISODate]] est valide seulement pour les années comprises entre 0 et 9999 inclus. Cette restriction s'applique au format local actuel selon les paramètres locaux fixés. Voir aussi [[#shortDayName()]] et [[#shortMonthName()]]. === weekNumber() === ''int QDate::weekNumber ( int * yearNumber = 0 ) const'' Retourne le numéro de la semaine (1 à 53), et enregistre l'année dans ''*yearNumber'', à moins que ''yearNumber'' soit nul (par défaut). Retourne 0 si la date est invalide. Conformément à la norme internationale ISO 8601, la semaine 1 de l'année commence toujours par un lundi, et le premier jeudi d'une année est toujours en semaine 1. La plupart des années sont de 52 semaines, mais certaines en ont 53. ''*yearNumber'' n'est pas toujours pareil que [[#year()]]. Par exemple, le 1er Janvier 2000 aura la semaine 52 de l'année 1999, et le 31 Décembre 2002 aura la semaine 1 de l'année 2003. > Copyright (c) 1989 The Regents of the University of California. All rights reserved. > Redistribution and use in source and binary forms are permitted provided that the above copyright notice and this paragraph are duplicated in all such forms and that any documentation, advertising materials, and other materials related to such distribution and use acknowledge that the software was developed by the University of California, Berkeley. The name of the University may not be used to endorse or promote products derived from this software without specific prior written permission. THIS SOFTWARE IS PROVIDED "AS IS" AND WITHOUT ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. Voir aussi [[#isValid()]]. === year() === ''int QDate::year () const'' Retourne l'année de cette date. Les nombres négatifs indiquent les années avant 1A.D. = 1 C.E. telle que l'année -44 est l'année 44 avant J.C Voir aussi [[#month()]] et [[#day()]]. === operator!=() === ''bool QDate::operator!= ( const QDate & d ) const'' Retourne ''true'' si cette date est différente de ''d'' sinon retourne false. === operator<() === ''bool QDate::operator< ( const QDate & d ) const'' Retourne ''true'' si cette date est antérieure à celle de ''d'' sinon retourne false. === operator<=() === ''bool QDate::operator<= ( const QDate & d ) const'' Retourne ''true'' si cette date est antérieure ou égale à celle de ''d'' sinon retourne false. === operator==() === ''bool QDate::operator== ( const QDate & d ) const'' Retourne ''true'' si cette date est égale à celle de ''d'' sinon retourne false. === operator>() === ''bool QDate::operator> ( const QDate & d ) const'' Retourne ''true'' si cette date est postérieure à celle de ''d'' sinon retourne false. === operator>=() === ''bool QDate::operator>= ( const QDate & d ) const'' Retourne ''true'' si cette date est postérieure ou égale à celle de ''d'' sinon retourne false. ==== En relation mais non membres de la classe ==== === operator<<() === ''[[QDataStream]] & operator<< ( [[QDataStream]] & out, const QDate & date )'' Écrit la ''date'' dans le flux ''out''. Voir aussi [[datastreamformat|Format des opérateurs QDataStream]]. === operator>>() === ''[[QDataStream]] & operator>> ( [[QDataStream]] & in, QDate & date )'' Lit une date depuis le flux ''in'' et le met dans ''date''. Voir aussi [[datastreamformat|Format des opérateurs QDataStream]]. ==== Remerciements ==== Merci à pour la traduction ainsi qu'à , et à pour leur relecture !