now - fonction de script et fonction de graphique

Cette fonction renvoie un horodatage de l'heure actuelle. La fonction renvoie des valeurs au format de variable système TimeStamp. La valeur timer_mode par défaut est 1.

now([ timer_mode])

double

La fonction now() peut être utilisée dans le script de chargement ou dans des objets graphiques.

Arguments
Argument	Description
timer_mode	Admet les valeurs suivantes : 0 (heure du dernier chargement de données terminé) 1 (heure d'appel de la fonction) 2 (heure d'ouverture de l'application) Note InformationsSi vous utilisez la fonction dans un script de chargement de données, timer_mode=0 calcule l'heure du dernier chargement de données terminé tandis que timer_mode=1 génère l'heure de l'appel de la fonction lors du chargement de données actif.

La fonction now() réduit les performances, risquant d'entraîner des problèmes de défilement si la fonction est utilisée dans des expressions de tables. Si son utilisation n'est pas strictement nécessaire, nous recommandons d'utiliser la fonction today() à la place. Si l'utilisation de now() est nécessaire dans une disposition, nous recommandons d'utiliser les paramètres hors défaut now(0) ou now(2), si possible, car ils ne demandent pas de recalculs constants.

Cas d'utilisation

La fonction now() est couramment utilisée comme composant d'une expression. Par exemple, elle peut être utilisée pour calculer le temps restant du cycle de vie d'un produit. La fonction now() est alors utilisée à la place de la fonction today() lorsque l'expression nécessite l'utilisation d'une fraction d'un jour.

Le tableau suivant explique le résultat renvoyé par la fonction now() suivant différentes valeurs pour l'argument timer_mode :

Exemples de fonction
Valeur de timer_mode	Résultat en cas d'utilisation dans un script de chargement	Résultat en cas d'utilisation dans un objet graphique
0	Renvoie un horodatage, au format de la variable système TimeStamp, du dernier chargement de données réussi précédant le dernier chargement de données.	Renvoie un horodatage, au format de la variable système TimeStamp, du dernier chargement de données.
1	Renvoie un horodatage, au format de la variable système TimeStamp, du dernier chargement de données.	Renvoie un horodatage, au format de la variable système TimeStamp, de l'appel de la fonction.
2	Renvoie un horodatage, au format de la variable système TimeStamp, correspondant au début de la session de l'utilisateur dans l'application. Cette valeur ne sera pas mise à jour, sauf si l'utilisateur charge de nouveau le script.	Renvoie l'horodatage, au format de la variable système TimeStamp, correspondant au début de la session de l'utilisateur dans l'application. Cette valeur sera actualisée une fois qu'une nouvelle session commencera ou lorsque les données de l'application seront de nouveau chargées.

Paramètres régionaux

Sauf indication contraire, les exemples de cette rubrique utilisent le format de date suivant : MM/JJ/AAAA. Le format de date est indiqué dans l'instruction SET DateFormat de votre script de chargement de données. Le format de date par défaut peut être différent dans votre système en raison de vos paramètres régionaux et d'autres facteurs. Vous pouvez modifier les formats utilisés dans les exemples ci-dessous en fonction de vos besoins. Ou vous pouvez modifier les formats utilisés dans votre script de chargement pour qu'ils correspondent à ceux de ces exemples. Pour plus d'informations, voir Modification des paramètres régionaux des applications et des scripts.

Les paramètres régionaux par défaut des applications sont basés sur le profil utilisateur. Ces paramètres de format régionaux ne sont pas liés à la langue affichée dans l'interface utilisateur Qlik Cloud. Qlik Cloud sera affiché dans la même langue que celle du navigateur que vous utilisez.

Si vous êtes un créateur d'applications, vous pouvez définir la région par défaut des applications que vous créez. Pour plus d'informations, voir Sélection des paramètres régionaux de votre choix pour la création d'applications et de scripts dans Qlik Cloud Analytics.

Exemple 1 – génération d'objets via un script de chargement

Vue d'ensemble

Ouvrez l'éditeur de chargement de données et ajoutez le script de chargement ci-dessous à un nouvel onglet.

Cet exemple crée trois variables avec la fonction now(). Chaque variable utilise l'une des options timer_mode pour démontrer leur effet.

Pour que les variables démontrent leur objectif, chargez le script, puis, après une courte période, chargez-le une deuxième fois. Cela a pour résultat d'afficher des valeurs différentes dans les variables now(0) et now(1), ce qui permet de démontrer correctement leur objectif.

Script de chargement

LET vPreviousDataLoad = now(0);
LET vCurrentDataLoad = now(1);
LET vApplicationOpened = now(2);

Résultats

Une fois les données chargées pour la deuxième fois, créez trois zones de texte en suivant les instructions ci-dessous.

Commencez par créer une zone de texte pour les données précédemment chargées.

Procédez comme suit :

À l'aide de l'objet graphique Text et image, créez une zone de texte.
Ajoutez la mesure suivante à l'objet :

=vPreviousDataLoad
Sous Aspect, sélectionnez Show titles et ajoutez le titre 'Previous Reload Time' à l'objet.

Créez ensuite une zone de texte pour les données en cours de chargement.

Procédez comme suit :

À l'aide de l'objet graphique Text et image, créez une zone de texte.
Ajoutez la mesure suivante à l'objet :

=vCurrentDataLoad
Sous Aspect, sélectionnez Show titles et ajoutez le titre 'Current Reload Time' à l'objet.

Créez une dernière zone de texte à afficher lors du démarrage de la session de l'utilisateur dans l'application.

Procédez comme suit :

À l'aide de l'objet graphique Text et image, créez une zone de texte.
Ajoutez la mesure suivante à l'objet :

=vApplicationOpened
Sous Aspect, sélectionnez Show titles et ajoutez le titre 'User Session Started' à l'objet.

Diagramme montrant ce à quoi ressemblerait les trois zones de texte générées après l'utilisation de la fonction now() pour charger les variables via le script de chargement. — Variables de script de chargement now()

L'image ci-dessus montre des exemples de valeur pour chacune des variables créées. Par exemple, les valeurs pourraient être comme suit :

Heure du chargement précédent : 6/22/2022 8:54:03 AM
Heure du chargement actuel : 6/22/2022 9:02:08 AM
Début de la session utilisateur : 6/22/2022 8:40:40 AM

Exemple 2 – génération d'objets sans script de chargement

Vue d'ensemble

Dans cet exemple, vous allez créer trois objets graphiques utilisant la fonction now() sans chargement de variables ni de données dans l'application. Chaque objet graphique utilise l'une des options timer_mode pour démontrer leur effet.

Pour cet exemple, il n'existe aucun script de chargement.

Procédez comme suit :

Ouvrez l'éditeur de chargement de données.
Sans modifier le script de chargement existant, cliquez sur Charger les données.
Peu de temps après, chargez le script une deuxième fois.

Résultats

Une fois les données chargées pour la deuxième fois, créez trois zones de texte.

Commencez par créer une zone de texte pour le dernier chargement de données.

Procédez comme suit :

À l'aide de l'objet graphique Text et image, créez une zone de texte.
Ajoutez la mesure suivante.

=now(0)
Sous Aspect, sélectionnez Afficher les titres et ajoutez le titre 'Dernier chargement de données' à l'objet.

Créez ensuite une zone de texte affichant l'heure actuelle.

Procédez comme suit :

À l'aide de l'objet graphique Text et image, créez une zone de texte.
Ajoutez la mesure suivante :

=now(1)
Sous Aspect, sélectionnez Afficher les titres et ajoutez le titre 'Heure actuelle' à l'objet.

Créez une dernière zone de texte à afficher lors du démarrage de la session de l'utilisateur dans l'application.

Procédez comme suit :

À l'aide de l'objet graphique Text et image, créez une zone de texte.
Ajoutez la mesure suivante :

=now(2)
Sous Aspect, sélectionnez Afficher les titres et ajoutez le titre 'Début de la session utilisateur' à l'objet.

Diagramme montrant ce à quoi pourrait ressembler chacune des trois zones de texte générées après l'utilisation de la fonction now() pour créer uniquement des objets graphiques, sans chargement de données dans l'application. — Exemples d'objet graphique now()

L'image ci-dessus montre des exemples de valeur pour chacun des objets créés. Par exemple, les valeurs pourraient être comme suit :

Dernier chargement de données : 6/22/2022 9:02:08 AM
Heure actuelle : 6/22/2022 9:25:16 AM
Début de la session utilisateur : 6/22/2022 8:40:40 AM

L'objet graphique 'Dernier chargement de données' utilise une valeur timer_mode égale à 0. Cela renvoie l'horodatage du dernier chargement de données réussi.

L'objet graphique 'Date actuelle' utilise une valeur timer_mode égale à 1. Cela renvoie la date actuelle conformément à l'horloge système. Si la feuille ou l'objet est actualisé, cette valeur sera mise à jour.

L'objet graphique 'Début de la session utilisateur' utilise une valeur timer_mode égale à 2. Cela renvoie l'horodatage de l'ouverture de l'application et du début de la session utilisateur.

Exemple 3 – scénario

Vue d'ensemble

Ouvrez l'éditeur de chargement de données et ajoutez le script de chargement ci-dessous à un nouvel onglet.

Le script de chargement contient :

Ensemble de données constitué de l'inventaire d'une opération de minage de cryptomonnaie, chargé dans une table appelée Inventory.
Données avec les champs suivants : id, purchase_date et wph (watts par heure).

L'utilisateur souhaite un tableau qui affiche, par id, le coût total encouru par chaque rig de minage au cours du mois jusqu'à ce jour, en termes de consommation d'énergie.

Cette valeur doit se mettre à jour à chaque actualisation de l'objet graphique. Le coût actuel de l'électricité est de 0,0678 $ parr kWH.

Script de chargement

SET DateFormat='MM/DD/YYYY';

Inventory:
Load
*
Inline 
[
id,purchase_date,wph
8188,1/7/2022,1123
8189,1/19/2022,1432
8190,2/28/2022,1227
8191,2/5/2022,1322
8192,3/16/2022,1273
8193,4/1/2022,1123
8194,5/7/2022,1342
8195,5/16/2022,2342
8196,6/15/2022,1231
8197,6/26/2022,1231
8198,7/9/2022,1123
8199,7/22/2022,1212
8200,7/23/2022,1223
8201,7/27/2022,1232
8202,8/2/2022,1232
8203,8/8/2022,1211
8204,8/19/2022,1243
8205,9/26/2022,1322
8206,10/14/2022,1133
8207,10/29/2022,1231
];

Résultats

Chargez les données et ouvrez une feuille. Créez une table et ajoutez ce champ comme dimension : id.

Créez la mesure suivante :

=(now(1)-monthstart(now(1)))*24*wph/1000*0.0678

Si l'objet graphique a été actualisé le 6/22/2022 à 10:39:05 AM, il renvoie les résultats suivants :

Tableau de résultats
id	=(now(1)-monthstart(now(1)))24wph/1000*0.0678
8188	$39.18
8189	$49.97
8190	$42.81
8191	$46.13
8192	$44.42
8193	$39.18
8194	$46.83
8195	$81.72
8196	$42.95
8197	$42.95
8198	$39.18
8199	$42.29
8200	$42.67
8201	$42.99
8202	$42.99
8203	$42.25
8204	$43.37
8205	$46.13
8206	$39.53

L'utilisateur souhaite que les résultats de l'objet soient actualisés à chaque actualisation de l'objet. D'où l'argument timer_mode fourni pour les instances de la fonction now() dans l'expression. L'horodatage du début du mois, identifié en utilisant la fonction now() comme argument d'horodatage de la fonction monthstart(), est soustrait de l'heure actuelle identifiée par la fonction now(). Cela donne le temps total écoulé jusqu'ici pour ce mois, en jours.

Cette valeur est multipliée par 24 (le nombre d'heures dans une journée), puis par la valeur du champ wph.

Pour convertir les watts par heure en kilowatts par heure, le résultat est divisé par 1 000 avant de finir par être multiplié par le tarif de kWH appliqué.

Cette page vous a-t-elle aidé ?

Si vous rencontrez des problèmes sur cette page ou dans son contenu – une faute de frappe, une étape manquante ou une erreur technique – dites-nous comment nous améliorer !

Laissez vos commentaires ici