Fonction CDOW( )
Renvoie le nom du jour de la semaine de la date ou de la DateHeure indiquée. Abréviation de "Jour de la semaine au format caractère".
Syntaxe
CDOW(date/DateHeure; longueur)
Paramètres
Nom | Type | Description |
---|---|---|
date/DateHeure |
DateHeure |
Le champ, l'expression, ou la valeur littérale pour lesquels renvoyer le nom du jour. |
longueur |
numérique |
Une valeur entre 1 et 9 indiquant la longueur de la chaîne de sortie. Pour afficher les noms raccourcis des jours, indiquez une valeur inférieure. |
Sortie
Caractère.
Exemples
Exemples basiques
Renvoie "Wednesday" car le 31 décembre 2014 tombe un mercredi et la longueur est de 9 :
CDOW(`20141231`; 8)
Renvoie "Wed" car le 31 décembre 2014 tombe un mercredi et la longueur est de 3 :
CDOW(`20141231 235959`; 3)
Renvoie le nom complet du jour pour chaque valeur dans le champ Date_facture :
CDOW(Date_facture; 9)
Renvoie le nom du jour abrégé pour chaque valeur dans le champ Horodatage_reçu :
CDOW(Horodatage_reçu; 3)
Exemples avancés
Ajout d'un champ identifiant les jours de la semaine pour les dates
Utilisez la fonction CDOW( ) pour créer un champ calculé qui identifie les jours de la semaine pour toutes les dates d'un champ de dates. Une fois que vous avez créé le champ calculé, vous pouvez l'ajouter à la vue à côté de la colonne de date.
DEFINE FIELD Nom_du_jour COMPUTED CDOW(Date_Trans; 3)
Création d'un filtre pour rechercher les transactions ayant eu lieu un week-end
Utilisez la fonction CDOW( ) pour créer un filtre qui isole les transactions ayant eu lieu pendant un week-end :
SET FILTER TO CDOW(Date_Trans; 3) = "Sam" OR CDOW(Date_Trans; 3) = "Dim"
Remarques
Informations sur les paramètres
Un champ indiqué pour date/DateHeure peut utiliser n'importe quel format de date ou de DateHeure, tant que la définition de champ définit correctement le format.
Si le paramètre longueur est inférieur au nom du jour, celui-ci est tronqué pour correspondre à la longueur indiquée. Si le paramètre longueur est plus long que le nom du jour, celui-ci est complété avec des espaces.
Spécification d'une valeur littérale de date ou de DateHeure
Lorsque vous indiquez une valeur littérale de date ou de DateHeure pour date/DateHeure, vous êtes limité aux formats de la table ci-dessous, et vous devez entourer la valeur de guillemets inversés – par exemple, `20141231`.
N'utilisez aucun séparateur comme les barres obliques (/) ou les deux points (:) entre les composants individuels des dates ou des heures.
-
Valeurs DateHeure : vous pouvez utiliser n'importe laquelle des combinaisons de formats de date, de séparateur et d'heure répertoriées dans le tableau ci-dessous. La date doit précéder l'heure, et vous devez utiliser un séparateur entre les deux. Les séparateurs valides sont un espace unique, la lettre « t » ou la lettre « T ».
-
Valeurs heure : vous devez indiquer l'heure à l'aide de l'horloge de 24 heures. Les décalages par rapport à l'heure universelle coordonnée (UTC) doivent être préfacés d'un signe plus (+) ou d'un signe moins (-).
Exemples de formats
Exemples de valeurs littérales
AAAAMMJJ
`20141231`
AAMMJJ
`141231`
AAAAMMJJ hhmmss
`20141231 235959`
AAMMJJthhmm
`141231t2359`
AAAAMMJJThh
`20141231T23`
AAAAMMJJ hhmmss+/-hhmm
(décalage UTC)
`20141231 235959-0500`
AAMMJJ hhmm+/-hh
(décalage UTC)
`141231 2359+01`
Remarque
N'utilisez pas hh seul dans le format d'heure principal avec des données qui ont un décalage UTC. Par exemple, évitez : hh+hhmm. Il se peut que les résultats ne soient pas fiables.
Fonctions associées
Si vous devez renvoyer le jour de la semaine comme un nombre (de 1 à 7), utilisez DOW( ) au lieu de CDOW( ).