Softanza
DémarrerEnglish
Softanza
DémarrerEnglish
Référence · stzDate

ToString()

human-readable formatting

aussi écrite: Date · Content

Exemples de base (2)

Softanza
o1 = new stzDate([ 2024, 10, 10 ])
? o1.Date()
Sortie
10/10/2024

exécuté le 2026-10-02 04:22 dans la bibliothèque au commit 0e72e2e2c ; tiré de 04_creating_a_date_objectfrom_list_of_numbers.ring(s'ouvre dans un nouvel onglet)

Softanza
o1 = new stzDate([ :Day = 12, :Month = 10, :Year = 2024 ])
? o1.Date()
Sortie
12/10/2024

exécuté le 2026-10-02 04:22 dans la bibliothèque au commit 0e72e2e2c ; tiré de 05_createing_a_date_object_from_a_hashlist_in_any_ord.ring(s'ouvre dans un nouvel onglet)

Portée (5)

Softanza
oDate = StzDateQ("01/01/2025")
oDate.AddDays(30)
? oDate.Date()
Sortie
31/01/2025

exécuté le 2026-10-02 04:22 dans la bibliothèque au commit 0e72e2e2c ; tiré de 08_adding_days_to_a_date.ring(s'ouvre dans un nouvel onglet)

Softanza
oDate = StzDateQ("25/12/2024")
? oDate.ToStringXT(:Long)
? oDate.ToStringXT(:Compact)
Sortie
Wednesday, December 25, 2024
25122024

exécuté le 2026-10-02 04:22 dans la bibliothèque au commit 0e72e2e2c ; tiré de 23_using_named_formats.ring(s'ouvre dans un nouvel onglet)

Softanza
oDate = StzDateQ("15/07/2024")
? oDate.ToEuropean()
? oDate.ToAmerican()
? oDate.ToISO8601()
? oDate.ToStringXT("dddd, MMMM d, yyyy") # Custom format
Sortie
15/07/2024
07/15/2024
2024-07-15
Monday, July 15, 2024

exécuté le 2026-10-02 04:22 dans la bibliothèque au commit 0e72e2e2c ; tiré de 22_formatting_dates_in_different_styles.ring(s'ouvre dans un nouvel onglet)

Softanza
o = StzDateQ("15/03/2024")
o.AddDays(20)
# +20 days crosses into April -> 04/04/2024
? o.Date()
p = StzDateQ("15/03/2024")
p.AddMonths(2)
# +2 months -> 15/05/2024
? p.Date()
q = StzDateQ("15/03/2024")
q.AddYears(1)
# +1 year -> 15/03/2025
? q.Date()
Sortie
04/04/2024
15/05/2024
15/03/2025

exécuté le 2026-10-02 04:22 dans la bibliothèque au commit 0e72e2e2c ; tiré de 00_date_narrated.ring(s'ouvre dans un nouvel onglet)

Softanza
o = StzDateQ("15/03/2024")
# Date() round-trips the string
? o.Date()
# Day() is the weekday name Friday
? o.Day()
# DayNumber() is 15
? o.DayNumber()
# Month() is March
? o.Month()
# MonthNumber() is 3
? o.MonthNumber()
# Year() is 2024
? o.Year()
# DayOfYear() is 75 (leap-year Jan31+Feb29+15)
? o.DayOfYear()
# 2024 IsLeapYear
? o.IsLeapYear()
Sortie
15/03/2024
Friday
15
March
3
2024
75
1

exécuté le 2026-10-02 04:22 dans la bibliothèque au commit 0e72e2e2c ; tiré de 00_date_narrated.ring(s'ouvre dans un nouvel onglet)

Les extensions de cette méthode

Chaque extension, et si elle existe pour cette méthode ; une extension qui existe se compose avec les autres (FindSTCS).

Extension
Existe
Ce qu'elle ajoute · Les noms
Q
non
fait ce que fait la méthode, puis rend l'objet, pour que l'appel puisse s'enchaîner
QQ
non
enchaîne sur le type d'objet suivant, plus précis (l'échelle des Q)
QQQ
non
enchaîne sur le type d'objet le plus précis (l'échelle des Q)
QRT
non
rend le résultat comme un objet du type demandé
CS
non
prend un indicateur de sensibilité à la casse
ST
non
prend la position de départ (StartingAt)
IB
non
prend des bornes incluses (IncludingBounds)
XT
oui
la forme étendue : plus de paramètres que la méthode de base · ToStringXT
XTT
non
encore une extension : une forme étendue de plus, après XT
Z
non
inclut la position dans ce qu'elle rend
ZZ
non
rend les positions comme des sections, [début, fin]
W
non
choisit selon une condition
WF
non
choisit selon une condition, avec les mots-clés expressifs (@NextItem, @PreviousItem...)
D
non
prend une direction, en avant ou en arrière (Directional)
F
non
prend une fonction (la condition ou la mise à jour est donnée comme une fonction) ; le document des formes emploie aussi F pour la forme future, qui diffère l'action
Many
non
travaille sur une collection d'éléments au lieu d'un seul (la forme plurielle)
Except
non
prend des exceptions, ce qu'il faut laisser de côté (la forme exceptionnelle)
U
non
rend le résultat sans doublon

Chaque exemple est un fichier de test de la bibliothèque, exécuté dans la bibliothèque pour cette page ; seuls ceux dont la sortie a tenu toutes les promesses écrites par leur fichier sont montrés. Les explications, les titres et le code sont ceux de la bibliothèque, en anglais.

Voir aussi