Softanza
StartFrançais
Softanza
StartFrançais
Reference · stzDate

ToString()

human-readable formatting

also written: Date · Content

Basic examples (2)

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

run on 2026-10-02 04:22 inside the library at commit 0e72e2e2c; taken from 04_creating_a_date_objectfrom_list_of_numbers.ring(opens in a new tab)

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

run on 2026-10-02 04:22 inside the library at commit 0e72e2e2c; taken from 05_createing_a_date_object_from_a_hashlist_in_any_ord.ring(opens in a new tab)

Scope (5)

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

run on 2026-10-02 04:22 inside the library at commit 0e72e2e2c; taken from 08_adding_days_to_a_date.ring(opens in a new tab)

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

run on 2026-10-02 04:22 inside the library at commit 0e72e2e2c; taken from 23_using_named_formats.ring(opens in a new tab)

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

run on 2026-10-02 04:22 inside the library at commit 0e72e2e2c; taken from 22_formatting_dates_in_different_styles.ring(opens in a new tab)

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()
Output
04/04/2024
15/05/2024
15/03/2025

run on 2026-10-02 04:22 inside the library at commit 0e72e2e2c; taken from 00_date_narrated.ring(opens in a new tab)

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()
Output
15/03/2024
Friday
15
March
3
2024
75
1

run on 2026-10-02 04:22 inside the library at commit 0e72e2e2c; taken from 00_date_narrated.ring(opens in a new tab)

The extensions of this method

Each extension, and whether it exists for this method; an extension that exists combines with the others (FindSTCS).

Extension
Exists
What it adds · The names
Q
no
does what the method does, then returns the object, so the call can be chained
QQ
no
chains on the next, more specific type of object (the Q ladder)
QQQ
no
chains on the most specific type of object (the Q ladder)
QRT
no
returns the result as an object of the requested type
CS
no
takes a case-sensitivity flag
ST
no
takes the position to start from (StartingAt)
IB
no
takes bounds that are included (IncludingBounds)
XT
yes
the extended form: more parameters than the base method · ToStringXT
XTT
no
yet another extension: a further extended form, after XT
Z
no
includes the position in what it returns
ZZ
no
returns positions as sections, [start, end]
W
no
selects by a condition
WF
no
selects by a condition, with the expressive keywords (@NextItem, @PreviousItem...)
D
no
takes a direction, forward or backward (Directional)
F
no
takes a function (the condition or the update is given as a function); the forms document also uses F for the future form, which defers the action
Many
no
works on a collection of items instead of one (the plural form)
Except
no
takes exceptions, what to leave out (the exceptional form)
U
no
returns the result without duplication

Every example is a test file of the library, run inside the library for this page; only those whose output kept every promise their file wrote are shown.

See also