Fonction GOMONTH( )

Renvoie la date qui correspond au nombre de mois indiqué avant ou après une date indiquée.

Syntaxe

GOMONTH(date/DateHeure; mois)

Paramètres

Nom Type Description
date/DateHeure

DateHeure

Le champ, l'expression, ou la valeur littérale à partir desquels calculer la date.

mois

numérique

Le nombre de mois avant ou après date/DateHeure.

Remarque

Vous pouvez indiquer une valeur de type DateHeure pour date/DateHeure, mais la portion de la valeur correspondant à l'heure sera ignorée.

Sortie

DateHeure. La valeur de date est générée à l'aide du format d'affichage de date Analytics actuel.

Exemples

Exemples basiques

Valeurs d'introduction littérales

Renvoie `20140415` affiché au format 15 avr 2014 en supposant que le format d'affichage actuel de la date dans Analytics soit JJ MMM AAAA :

GOMONTH(`20140115`; 3)

Renvoie `20131015` affiché au format 15 oct 2013 en supposant que le format d'affichage actuel de la date dans Analytics soit JJ MMM AAAA :

GOMONTH(`20140115`; -3)

Renvoie `20140430` affiché au format 30 avr 2014 en supposant que le format d'affichage actuel de la date dans Analytics soit JJ MMM AAAA (l'arrondi de date évite de renvoyer le 31 avr 2014, qui est une date incorrecte) :

GOMONTH(`20140330`; 1)
GOMONTH(`20140331`; 1)

Renvoie `20140501` affiché au format 01 mai 2014 en supposant que le format d'affichage de la date actuel dans Analytics soit JJ MMM AAAA :

GOMONTH(`20140401`; 1)

Valeurs d'introduction champ

Renvoie la date trois mois après chaque date dans le champ Date_facture :

GOMONTH(Date_facture; 3)

Renvoie la date trois mois après chaque date dans le champ Date_facture plus une période de grâce de 15 jours :

GOMONTH(Date_facture + 15; 3)

Remarques

Il peut parfois être difficile d'utiliser correctement les fonctions date et heure. Dans la fonction Aide, les rubriques donnent une description détaillée du fonctionnement de chaque fonction. Pour plus d'informations sur les aspects généraux à prendre en compte lors de l'utilisation de fonctions date et heure, consultez les rubriques suivantes :

Formats DateHeure

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.

Une valeur de date littérale doit utiliser l'un des formats suivants :

  • AAAAMMJJ
  • AAMMJJ

Vous devez saisir les valeurs de dates littérales entre guillemets inversés. Par exemple : `20141231`

Fonctionnement de la valeur mois

  • Valeur positive la date générée est plus récente que la date/DateHeure indiquée
  • Valeur négative la date générée est antérieure à la date/DateHeure indiquée.
  • Valeur omise ou '0' (zéro) la date générée est la même que la date/DateHeure

Arrondi de dates pour éviter les dates inexistantes

Si la combinaison de date/dateheure et mois génère une date inexistante, la fonction GOMONTH( ) utilise l'arrondi de date pour renvoyer la date correcte la plus proche à l'intérieur du même mois.

Renvoie `20140430` (30 avr 2014) car le 31 avr 2014 est une date incorrecte :

GOMONTH(`20140331`;1)

Fonctions associées

Utilisez la fonction EOMONTH( )si vous souhaitez renvoyer la date du dernier jour du mois, plutôt que la date exacte, qui correspond au nombre de mois indiqué avant ou après une date indiquée.