Tutorial - Tableur Calc d'OpenOffice.org par l'exemple

Accueil Fonctions Calc Menu Basic EDI OOo 1.x EDI OOo 2.x EDI LibO - OOo 3.x Affectation touche Affectation icône Etape par étape Macro débutant Fonctions Basic Dialogues OOo1-2 Dialogues LibO-OOo3 Quelques exemples Exemples dialogue Fonctions perso Définitions Recherche sur site

FONCTIONS BASIC. Fonctions Dates & heures

Accès direct : Menu fonctions Basic, Textes, Dates et heures, Logiques, mathématiques, Ecran, Fichiers, Variables, Erreurs, Divers,

Pour faciliter la compréhension, tous les exemples cités se basent sur la même date (09/07/2005) et les correspondances numériques (38542) ou ISO (20050709). (Voir normes ISO 8601. Les résultats peuvent varier suivant les formats d'affichages. Les fonctions équivalentes Calc peuvent n'être qu'approchantes.

Fonctions / Instructions	T^*	Retour	Exemple	Résultat	Commentaires	Equivalent Calc^**
CDate(Expression)	F	Date	MaVariable = cDate(38542.4753)	38542,4753	Convertit une valeur en date et heure. La partie décimale représente les heures. § DateFromIso, CDateToIso
				09/07/2005 11:24:26
CDateFromIso (String)	F	Date	MaVariable = CDateFromIso ("20050709")	38542	Retourne la date numérique à partir d'une date au format ISO.§ CDate, CDateToIso
CDateToIso (nombre)	F	Chaîne	MaVariable = CDateToIso(38542)	20050709	Retourne date au format ISO à partir d'une date. § CDate, CDateFromIso
			MaVariable = CDateToIso (DateSerial (2005, 07, 09))
Date	F	Date	MaVariable = Date	09/07/2005 (exemple)	Retourne la date système. § CDate, CDateFromIso, DateToIso, Date, DateSerial, DateValue, Now	DATE
			Date = MaVariable	Change date système
DateDiff	F	Nombre	MaVariable = DateDiff (Ajouter, Date1, Date2 [, Semaine_début [,Année_début]])	Voir détails à la suite de ce tableau	Retourne un nombre d'intervalles (jours, mois, années,...) entre deux valeurs de dates.
DateSerial (année, mois, jour)	F	Date	MaVariable = DateSerial (2005, 07, 09)	38542 (suivant format affichage)	Retourne le nombre de jours entre le 31/12/1899 et la date saisie. Dates autorisées du 01/12/1582 au 31/12/9999	DATEVAL
DateValue ([date])	F	Long	MaVariable = DateValue ("09/07/2005")	38542 (suivant format affichage)	Retourne une date en valeur. Cette fonction autorise les dates du 01/12/1582 (-115811) au 31/12/9999 (2958465), le 30/12/1899 correspond à la valeur zéro. § CDate, CDateFromIso, CDateToIso, Date, DateSerial, DateValue, Now
Day (nombre)	F	Entier	MaVariable = Day(38542)	9	Retourne (entier) le jour du mois à partir d'une date. § Month, WeekDay, Year	JOUR
			MaVariable = Day (DateSerial (2005, 07, 09))
GetSystemTicks()	F	Long	MaVariable = GetSystemTicks()	2958465 (exemple)	Retourne le nombre de cycles du système d'exploitation
Hour(nombre)	F	Entier	MaVariable = Hour("11:24:26")	11	Retourne les heures. § Minute, Second	HEURE
			MaVariable = Hour (TimeSerial (11,24,26))
Minute(nombre)	F	Entier	MaVariable = Minute("11:24:26")	24	Retourne les minutes. § Hour, Second	MINUTE
			MaVariable = Minute (TimeSerial (11,24,26))
Month(nombre)	F	Entier	MaVariable = Month(38542)	7	Retourne le mois à partir d'une date. § Day, WeekDay, Year	MOIS
			MaVariable = Month (DateSerial (2005, 07, 09))
Now	F	Date	MaVariable = Now	09/07/2005 11:24:26 (exemple)	Date et heure système courantes. § Date, DateSerial, DateValue	MAINTENANT
Second(nombre)	F	Entier	MaVariable = Second("11:24:26")	26	Retourne les secondes. § Hour, Minute	SECONDE
			MaVariable = Second (TimeSerial (11,24,26))
Time	I		MaVariable = Time	13:20:15 (exemple)	Retourne l'heure système.	MAINTENANT
Timer	F	Date	MaVariable = Timer	50210 (exemple)	Nombre de secondes écoulées depuis minuit. Déclaration variable Long, sinon retour date
TimeSerial (h, m, s)	F	Date	MaVariable = TimeSerial (11,24,26)	0,4753	Retourne une valeur (double précision) entre 0 et 0,9999999999. Les heures vont de 0 à 23 et minutes et secondes de 0 à 59. Un dépassement de minutes ou secondes influent sur heures et minutes.	TEMPSVAL
				11:24:26
TimeValue ("HH:MM:SS")	F	Date	MaVariable = TimeValue("11:24:26")	0,4753	Heure numérique à partir d'une chaîne formatée heures, minutes, secondes
				11:24:26
Wait millisec	I		Wait 5000	arrêt programme 5 secondes	Pause pendant le nombre de millisecondes spécifiées
WeekDay (nombre)	F	Entier	MaVariable = WeekDay(38542)	7	Retourne le jour de la semaine à partir d'une date. § Day, Month, Year	JOURSEM
			MaVariable = WeekDay (DateSerial (2005, 07, 09))
Year(nombre)	F	Entier	MaVariable = Year(38542)	2005	Retourne l'année à partir d'une date. § Day, Month, WeekDay	ANNEE
			MaVariable = Year (DateSerial (2005, 07, 09))

^* F : Fonction, I : Instruction, O : Opérateur
^** Les fonctions équivalentes Calc peuvent n'être qu'approchantes.
[Entre crochets, options]

Fonction DateDiff

Syntaxe : DateDiff (paramètres, Date1, Date2 [, Semaine_début [,Année_début]])

Paramètres	Explications	Equivalent Calc
yyyy	Différence en années	Annees
q	différence en trimestres
m	différence en mois	NB.MOIS
y	différence en jours, idem paramètre d	=date1-date2
w	différence en semaines
ww	différence en semaines
d	différence en jours, idem paramètre y
h	différence en heures
n	différence en minutes
s	différence en secondes

Semaine_début	Explications
0	Valeur système par défaut
1	Dimanche (par défaut)
2	Lundi
3	Mardi
4	Mercredi
5	Jeudi
6	Vendredi
7	Samedi

Année_début	Explications
0	Valeur système par défaut
1	La semaine 1 est la semaine du 1er janvier (par défaut)
2	La semaine 1 est la première semaine contenant quatre jours ou plus de cette même année
3	La semaine 1 est la première semaine contenant uniquement des jours de la nouvelle année

Le paramétre optionnel Semaine_début agit uniquement sur le paramétre WW des calculs de semaines. Les tableaux suivant illustrent les cas possibles. Faites la relation avec le tableau des options Semaine_début

Exemples DateDiff	Résultats	Commentaires
MaVariable = DateDiff ("yyyy", "01/02/2003", "09/07/2005")	2 (ans)
MaVariable = DateDiff ("q", "01/02/2003", "09/07/2005")	10 (trimestres)
MaVariable = DateDiff ("m", "01/02/2003", "09/07/2005")	29 (mois)
MaVariable = DateDiff ("y", "01/02/2003", "09/07/2005")	889 (jours)	Identique à 09/07/2005 - 01/02/2003 dans une cellule (format nombre)
MaVariable = DateDiff ("d", "01/02/2003", "09/07/2005")	889 (jours)

MaVariable = DateDiff ("w", "01/01/2004", "14/07/2004")	27 (semaines)
MaVariable = DateDiff ("ww", "01/01/2004", "14/07/2004")	28 (semaines)
MaVariable = DateDiff ("ww", "01/01/2004", "14/07/2004", 2)	28 (semaines)	01/01/2004 est un jeudi. Semaine_début à 2 correspond au lundi
MaVariable = DateDiff ("ww", "01/01/2004", "14/07/2004", 5)	27 (semaines)	01/01/2004 est un jeudi. Semaine_début à 5 correspond au jeudi

MaVariable = DateDiff ("h", "08/07/2005", "09/07/2005")	24 (heures)
MaVariable = DateDiff ("n", "08/07/2005", "09/07/2005")	1440 (minutes)
MaVariable = DateDiff ("s", "08/07/2005", "09/07/2005")	86400 (secondes)
MaVariable = DateDiff ("h", "08/07/2005", "09/07/2005 2:15:30")	26 (heures)
MaVariable = DateDiff ("m", "08/07/2005", "09/07/2005 2:15:30")	1576 (minutes)
MaVariable = DateDiff ("s", "08/07/2005", "09/07/2005 2:15:30")	94530 (secondes)