Des aides temporelles dans $util.time

Note

Nous prenons désormais principalement en charge le runtime APPSYNC_JS et sa documentation. Pensez à utiliser le runtime APPSYNC_JS et ses guides ici.

La variable $util.time contient les méthodes datetime pour aider à générer les horodatages, à convertir d'un format datetime à l'autre et à analyser les chaînes datetime. La syntaxe des formats datetime est basée sur DateTimeFormatterlaquelle vous pouvez vous référer pour obtenir de la documentation supplémentaire. Nous fournissons quelques exemples ci-dessous, ainsi qu'une liste des méthodes et des descriptions disponibles.

Temps et utilités

Liste des heures et des outils

$util.time.nowISO8601() : String

Renvoie une représentation String (chaîne) d'UTC au format ISO8601.

$util.time.nowEpochSeconds() : long

Renvoie le nombre de secondes entre l'époque Unix 1970-01-01T00:00:00Z et maintenant.

$util.time.nowEpochMilliSeconds() : long

Renvoie le nombre de millisecondes entre l'époque Unix 1970-01-01T00:00:00Z et maintenant.

$util.time.nowFormatted(String) : String

Renvoie une chaîne de l'horodatage actuel (UTC) à l'aide du format spécifié à partir d'un type d'entrée String (chaîne).

$util.time.nowFormatted(String, String) : String

Renvoie une chaîne de l'horodatage actuel pour un fuseau horaire à l'aide du format et du fuseau spécifiés à partir de types d'entrée String (chaîne).

$util.time.parseFormattedToEpochMilliSeconds(String, String) : Long

Analyse un horodatage transmis sous forme de chaîne avec un format, puis renvoie l'horodatage en millisecondes depuis l'époque.

$util.time.parseFormattedToEpochMilliSeconds(String, String, String) : Long

Analyse un horodatage transmis sous forme de chaîne avec un format et un fuseau horaire, puis renvoie l'horodatage en millisecondes depuis l'époque.

$util.time.parseISO8601ToEpochMilliSeconds(String) : Long

Analyse un horodatage ISO8601 transmis sous forme de chaîne, puis renvoie l'horodatage en millisecondes depuis l'époque.

$util.time.epochMilliSecondsToSeconds(long) : long

Convertit une époque Unix en millisecondes en une époque Unix en secondes.

$util.time.epochMilliSecondsToISO8601(long) : String

Convertit un horodatage en millisecondes d'époque en un horodatage ISO8601.

$util.time.epochMilliSecondsToFormatted(long, String) : String

Convertit l'horodatage d'une époque en millisecondes, transmis sous sa forme la plus longue, en un horodatage formaté selon le format fourni en UTC.

$util.time.epochMilliSecondsToFormatted(long, String, String) : String

Convertit un horodatage en millisecondes d'époque, transmis sous forme de long, en un horodatage formaté selon le format fourni dans le fuseau horaire fourni.

Exemples de fonctions autonomes

$util.time.nowISO8601()                                            : 2018-02-06T19:01:35.749Z
$util.time.nowEpochSeconds()                                       : 1517943695
$util.time.nowEpochMilliSeconds()                                  : 1517943695750
$util.time.nowFormatted("yyyy-MM-dd HH:mm:ssZ")                    : 2018-02-06 19:01:35+0000
$util.time.nowFormatted("yyyy-MM-dd HH:mm:ssZ", "+08:00")          : 2018-02-07 03:01:35+0800
$util.time.nowFormatted("yyyy-MM-dd HH:mm:ssZ", "Australia/Perth") : 2018-02-07 03:01:35+0800

Exemples de conversion

#set( $nowEpochMillis = 1517943695758 )
$util.time.epochMilliSecondsToSeconds($nowEpochMillis)                                     : 1517943695
$util.time.epochMilliSecondsToISO8601($nowEpochMillis)                                     : 2018-02-06T19:01:35.758Z
$util.time.epochMilliSecondsToFormatted($nowEpochMillis, "yyyy-MM-dd HH:mm:ssZ")           : 2018-02-06 19:01:35+0000
$util.time.epochMilliSecondsToFormatted($nowEpochMillis, "yyyy-MM-dd HH:mm:ssZ", "+08:00") : 2018-02-07 03:01:35+0800

Exemples d'analyse syntaxique

$util.time.parseISO8601ToEpochMilliSeconds("2018-02-01T17:21:05.180+08:00")                          : 1517476865180
$util.time.parseFormattedToEpochMilliSeconds("2018-02-02 01:19:22+0800", "yyyy-MM-dd HH:mm:ssZ")     : 1517505562000
$util.time.parseFormattedToEpochMilliSeconds("2018-02-02 01:19:22", "yyyy-MM-dd HH:mm:ss", "+08:00") : 1517505562000

Utilisation avec des scalaires AWS AppSync définis

Les formats suivants sont compatibles avec AWSDate, AWSDateTime, et AWSTime.

$util.time.nowFormatted("yyyy-MM-dd[XXX]", "-07:00:30")               : 2018-07-11-07:00
$util.time.nowFormatted("yyyy-MM-dd'T'HH:mm:ss[XXXXX]", "-07:00:30")  : 2018-07-11T15:14:15-07:00:30