   
QDateLa classe QDate fournit des fonctions pour g�rer des dates. Plus d'informations... #include <QDate>Voir la position dans l'arbre des classes. Note : toutes les fonctions dans cette classe sont r�entrantes. Description d�taill�eLa 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 julienQDate 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 0Il 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 validesLa 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 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 membresenum QDate::MonthNameTypeCette �num�ration d�crit les types de repr�sentation de la cha�ne de caract�res utilis�e pour le nom du mois.
Cette �num�ration a �t� introduite ou modifi�e � partir de Qt 4.5. Fonctions membresQDate::QDate ()Construit une date vide. Les dates vides sont invalides. Voir aussi isNull() et isValid(). 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(). QDate QDate::addDays ( int ndays ) constRetourne 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(). QDate QDate::addMonths ( int nmonths ) constRetourne 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(). QDate QDate::addYears ( int nyears ) constRetourne 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(). QDate QDate::currentDate () [static]Retourne la date actuelle indiqu�e par l'horloge syst�me. Voir aussi QTime::currentTime() et QDateTime::currentDateTime(). int QDate::day () constRetourne le jour du mois (1 � 31) de cette date. Voir aussi year(), month() et dayOfWeek(). int QDate::dayOfWeek () constRetourne le jour de la semaine (1 � 7) de cette date Voir aussi day(), dayOfYear() et Qt::dayOfWeek. int QDate::dayOfYear () constRetourne 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(). int QDate::daysInMonth () constRetourne le nombre de jours que le mois contient (28 � 31) � cette date. Voir aussi day() et daysInYear(). int QDate::daysInYear () constRetourne le nombre de jours que l'ann�e contient (365 ou 366) � cette date. Voir aussi day() et daysInMonth(). int QDate::daysTo ( const QDate & d ) constRetourne 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(). QDate QDate::fromjulianDay ( int jd ) [static]Convertit le jour jd du calendrier julien en un QDate. Voir aussi toJulianDay(). QDate QDate::fromString ( const QString & string, 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::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 »). 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 :
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 :
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(), [[qtime::fromString|QTime::fromString(), QDate::toString(), QDateTime::toString() et QTime::toString(). 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(). 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. bool QDate::isNull () constRetourne 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(). bool QDate::isValid () constRetourne true si la date est invalide, sinon retourne false. Voir aussi isNull(). 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(). 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(). QString QDate::longDayName ( int weekday, 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 :
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(). 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(). QString QDate::longMonthName ( int month, 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 :
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(). int QDate::month () constRetourne le num�ro correspondant au mois de cette date, utilisant la convention suivante :
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(). 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(). 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 :
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(). 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(). 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 :
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(). int QDate::tojulianDay () constConvertit la date en un jour julien. Voir aussi fromjulianDay(). QString QDate::toString ( const QString & format ) constRetourne 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 :
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) :
Si la date est invalide, une cha�ne vide sera retourn�e. Attention : Le format 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() et QTime::toString(). QString QDate::toString ( Qt::DateFormat format = Qt::TextDate ) constCeci 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::TextDate, la cha�ne est format�e par d�faut. QDate::shortDayName() et 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::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::SystemLocaleShortDate ou 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().toString(date, QLocale::ShortFormat) ou QLocale::system().toString(date, QLocale::LongFormat). Un exemple du formatage Qt::SystemLocaleLongDate est « Samedi 20 Mai 1995 ». Si format est Qt::DefaultLocaleShortDate ou 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(), 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::ShortFormat) ou QLocale().toString(date, QLocale::LongFormat). Si la date est invalide, une cha�ne de caract�res vide sera retourn�e. Attention : Le format 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(). int QDate::weekNumber ( int * yearNumber = 0 ) constRetourne 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. Voir aussi isValid(). int QDate::year () constRetourne 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 bool QDate::operator!= ( const QDate & d ) constRetourne true si cette date est diff�rente de d sinon retourne false. bool QDate::operator< ( const QDate & d ) constRetourne true si cette date est ant�rieure � celle de d sinon retourne false. bool QDate::operator<= ( const QDate & d ) constRetourne true si cette date est ant�rieure ou �gale � celle de d sinon retourne false. bool QDate::operator== ( const QDate & d ) constRetourne true si cette date est �gale � celle de d sinon retourne false. bool QDate::operator> ( const QDate & d ) constRetourne true si cette date est post�rieure � celle de d sinon retourne false. bool QDate::operator>= ( const QDate & d ) constRetourne true si cette date est post�rieure ou �gale � celle de d sinon retourne false. En relation mais non membres de la classeQDataStream & operator<< ( QDataStream & out, const QDate & date )�crit la date dans le flux out. Voir aussi s�rialisation des type de donn�es Qt. QDataStream & operator>> ( QDataStream & in, QDate & date )Lit une date depuis le flux in et le met dans date. Voir aussi s�rialisation des type de donn�es Qt. RemerciementsMerci � Mikael Sans pour la traduction ainsi qu'� Jonathan Courtois, Thibaut Cuvelier et � Philippe Beaucart pour leur relecture ! |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Cette page est une traduction d'une page de la documentation de Qt, �crite par Nokia Corporation and/or its subsidiary(-ies). Les �ventuels probl�mes r�sultant d'une mauvaise traduction ne sont pas imputables � Nokia. | Qt 4.7 | |
| Copyright © 2025 Developpez LLC. Tous droits r�serv�s Developpez LLC. Aucune reproduction, m�me partielle, ne peut �tre faite de ce site et de l'ensemble de son contenu : textes, documents et images sans l'autorisation expresse de Developpez LLC. Sinon, vous encourez selon la loi jusqu'� 3 ans de prison et jusqu'� 300 000 E de dommages et int�r�ts. Cette page est d�pos�e � la SACD. | ||
| Vous avez d�nich� une erreur ? Un bug ? Une redirection cass�e ? Ou tout autre probl�me, quel qu'il soit ? Ou bien vous d�sirez participer � ce projet de traduction ? N'h�sitez pas � nous contacter ou par MP ! | ||
