Date and Time API Functions - Versionsgeschichte

Cg: /* Printing */

2025-07-29T17:54:09Z

Printing

← Nächstältere Version		Version vom 29. Juli 2025, 17:54 Uhr
Zeile 305:		Zeile 305:
	:: like abofve, this generates a string representation as specified in formatString.<br>For example, "(1 hours + 10 minutes + 30 seconds) printStringFormat:'%h:%m:%s' " might generate a string like " '01:10:30' "<br>Valid format specifiers (in addition to time's format specifiers) are:		:: like abofve, this generates a string representation as specified in formatString.<br>For example, "(1 hours + 10 minutes + 30 seconds) printStringFormat:'%h:%m:%s' " might generate a string like " '01:10:30' "<br>Valid format specifiers (in addition to time's format specifiers) are:
	:::"%(Hd)" (hours in day = leftover hours when taking out the days),"%(Gyr)" (giga years),"%(Myr)" (mega years),"%(Kyr)" (kilo years), "%(yrR)" (years roundsd), "%(monR)" (months rounded), "%(wR)" (weeks rounded), "%(dR)" (days rounded), "%(dw) (days in week = rest days when taking out the weeks) and some others		:::"%(Hd)" (hours in day = leftover hours when taking out the days),"%(Gyr)" (giga years),"%(Myr)" (mega years),"%(Kyr)" (kilo years), "%(yrR)" (years roundsd), "%(monR)" (months rounded), "%(wR)" (weeks rounded), "%(dR)" (days rounded), "%(dw) (days in week = rest days when taking out the weeks) and some others
	::For a full list, see the [https://live.exept.de/ClassDoc/classDocOf:,~~AbstractTime:PrintBindingMirror~~ TimeDuration class documentation], or look into the source in the class browser.		::For a full list, see the [https://live.exept.de/ClassDoc/classDocOf:,TimeDuration TimeDuration class documentation], or look into the source in the class browser.

	:''aTimeDuration'' '''printOn:''' ''aStream'' '''format:''' ''formatString'' => void		:''aTimeDuration'' '''printOn:''' ''aStream'' '''format:''' ''formatString'' => void

Cg: /* Arithmetic */

2025-07-29T17:53:15Z

Arithmetic

@@ Zeile 299: / Zeile 299: @@
 :: a multiple
 :: E.g. "<code>10 minutes * 10</code>" => 100 minutes
 == TimeZone ==

Cg: /* Examples */

2025-04-01T20:32:42Z

Examples

← Nächstältere Version		Version vom 1. April 2025, 20:32 Uhr
Zeile 336:		Zeile 336:
	Printed on a machine in Germany with DST in effect.		Printed on a machine in Germany with DST in effect.

	TZTimestamp nowInTimeZone:'CEST' => 2023-07-07 14:58:06.329+02		TZTimestamp nowInTimeZone:'CEST' <small>=> 2023-07-07 14:58:06.329+02</small>
	TZTimestamp nowInTimeZone:'EET' => 2023-07-07 14:58:10.883+02		TZTimestamp nowInTimeZone:'EET' <small>=> 2023-07-07 14:58:10.883+02</small>
	TZTimestamp nowInTimeZone:'EEST' => 2023-07-07 15:58:24.235+03		TZTimestamp nowInTimeZone:'EEST' <small>=> 2023-07-07 15:58:24.235+03</small>

	TZTimestamp now => 2023-07-07 14:58:33.203+02		TZTimestamp now <small>=> 2023-07-07 14:58:33.203+02</small>
	Timestamp now => 2023-07-07 14:58:46.155		Timestamp now <small>=> 2023-07-07 14:58:46.155</small>
	UtcTimestamp now => 2023-07-07 12:58:52.851Z		UtcTimestamp now <small>=> 2023-07-07 12:58:52.851Z</small>
	Timestamp now asTZTimestampInZone:'JST' => 2023-07-07 21:58:54.341+09		Timestamp now asTZTimestampInZone:'JST' <small>=> 2023-07-07 21:58:54.341+09</small>

	UtcTimestamp now printStringIso8601 => '2023-07-07T16:07:27.977Z'		UtcTimestamp now printStringIso8601 <small>=> '2023-07-07T16:07:27.977Z'</small>
	TZTimestamp now printStringIso8601 => '2023-07-07T18:08:07.644+02'		TZTimestamp now printStringIso8601 <small>=> '2023-07-07T18:08:07.644+02'</small>
	Timestamp now printStringIso8601 => '2023-07-07T18:08:35.425'		Timestamp now printStringIso8601 <small>=> '2023-07-07T18:08:35.425'</small>

	Time now => 14:59:00		Time now <small>=> 14:59:00</small>
	Date today => 07-07-2023		Date today <small>=> 07-07-2023</small>

	Timestamp now utcOffset => -7200		Timestamp now utcOffset <small>=> -7200</small>
	(TZTimestamp now) utcOffset => -7200		(TZTimestamp now) utcOffset <small>=> -7200</small>
	(TZTimestamp nowInTimeZone:'EEST') utcOffset => -10800		(TZTimestamp nowInTimeZone:'EEST') utcOffset <small>=> -10800</small>

	Timestamp readFrom:'2023-07-07T16:07:27.977Z' => (UtcTimestamp 2023-07-07 16:07:27.977Z)		Timestamp readFrom:'2023-07-07T16:07:27.977Z' <small>=> (UtcTimestamp 2023-07-07 16:07:27.977Z)</small>
	Timestamp readFrom:'2023-07-07T18:08:07.644+02' => (TZTimestamp 2023-07-07 18:08:07.644+02)		Timestamp readFrom:'2023-07-07T18:08:07.644+02' <small>=> (TZTimestamp 2023-07-07 18:08:07.644+02)</small>
	Timestamp readFrom:'2023-07-07T18:08:07.644' => (Timestamp 2023-07-07 18:08:07.644)		Timestamp readFrom:'2023-07-07T18:08:07.644' <small>=> (Timestamp 2023-07-07 18:08:07.644)</small>

	Timestamp now + 10 days => 2023-07-17 18:13:31.514		Timestamp now + 10 days <small>=> 2023-07-17 18:13:31.514</small>

Cg: /* Useful Queries */

2025-04-01T20:30:25Z

Useful Queries

← Nächstältere Version		Version vom 1. April 2025, 20:30 Uhr
Zeile 100:		Zeile 100:
	<div style="margin-left: 2em;">		<div style="margin-left: 2em;">
	Date abbreviatedDayNamesForLanguage: 'en'		Date abbreviatedDayNamesForLanguage: 'en'
	=> #('mon' 'tue' 'wed' 'thu' 'fri' 'sat' 'sun')		<small>=> #('mon' 'tue' 'wed' 'thu' 'fri' 'sat' 'sun')</small>
	Date abbreviatedDayNamesForLanguage: 'de'		Date abbreviatedDayNamesForLanguage: 'de'
	=> #('Mo' 'Di' 'Mi' 'Do' 'Fr' 'Sa' 'So')		<small>=> #('Mo' 'Di' 'Mi' 'Do' 'Fr' 'Sa' 'So')</small>
	Date dsyNamesForLanguage: 'fr'		Date dsyNamesForLanguage: 'fr'
	=> #('lundi' 'mardi' 'mercredi' 'vendredi' 'jeudi' 'samedi' 'dimanche')		<small> => #('lundi' 'mardi' 'mercredi' 'vendredi' 'jeudi' 'samedi' 'dimanche')</small>
	</div>		</div>
	:Date '''nameOfDay:''' ''dayIndex'' language: ''langCode''=> String		:Date '''nameOfDay:''' ''dayIndex'' language: ''langCode''=> String

Cg: /* Arithmetic */

2023-07-07T16:40:42Z

Arithmetic

← Nächstältere Version		Version vom 7. Juli 2023, 16:40 Uhr
Zeile 290:		Zeile 290:
	=== Arithmetic ===		=== Arithmetic ===
	:''timeDuration1'' + ''timeDuration2'' => TimeDuration		:''timeDuration1'' + ''timeDuration2'' => TimeDuration
	:: a longer time duration.~~<br>E.g. "<code>1 days + 10 hours</code>"~~		:: a longer time duration.
			:: E.g. "<code>1 days + 10 hours</code>"

	:''timeDuration1'' - ''timeDuration2'' => TimeDuration		:''timeDuration1'' - ''timeDuration2'' => TimeDuration
	:: a shorter time duration. Result may bring you back in time (i.e. be negative)		:: a shorter time duration. Result may bring you back in time (i.e. be negative)

	:''timeDuration1'' * ''~~timeDuration2~~'' => TimeDuration		:''timeDuration1'' * ''number'' => TimeDuration
			:: a multiple
	:: ~~a multiple <br>~~E.g. "<code>10 minutes * 10</code>" => 100 minutes		:: E.g. "<code>10 minutes * 10</code>" => 100 minutes

	== TimeZone ==		== TimeZone ==

Cg: /* Printing */

2023-07-07T16:39:45Z

Printing

← Nächstältere Version		Version vom 7. Juli 2023, 16:39 Uhr
Zeile 254:		Zeile 254:
	:: generates a string representation as specified in formatString.<br>For example, " Timestamp now printStringFormat:'%h:%m:%s' " might generate a string like " '20:48:47' "<br>Valid format characters are:		:: generates a string representation as specified in formatString.<br>For example, " Timestamp now printStringFormat:'%h:%m:%s' " might generate a string like " '20:48:47' "<br>Valid format characters are:
	:::"%h" (hour 24 padded),"%m" (minutes),"%s" (seconds),"%i" (millis),"%j" (micros),<br>"%(day)" (day-nr in month), "%(month)" (month-nr), "%(year)" (year),<br>"%H" (hour 24 unpadded), "%M" (minutes unpadded), "%S" (seconds unpadded),<br>"%(milli)" (millis), "%(milli1)" (millis, 1 digit), "%(milli3)" (millis, 3 digits),<br>"%(micro)" (micros), "%(micro6)" (micros, 6 digits),<br>"%(nano)" (nanos), "%(nano9)" (nanos, 9 digits),<br>"%(pico)" (picos), "%(pico12)" (picos, 12 digits),<br>"%(weekDay)" (1 to 7), "%(dayName)" (in current language), "%(monthName)" (in current language), "%(shortDayName)" (in current language), "%(shortMonthName)" (in current language).		:::"%h" (hour 24 padded),"%m" (minutes),"%s" (seconds),"%i" (millis),"%j" (micros),<br>"%(day)" (day-nr in month), "%(month)" (month-nr), "%(year)" (year),<br>"%H" (hour 24 unpadded), "%M" (minutes unpadded), "%S" (seconds unpadded),<br>"%(milli)" (millis), "%(milli1)" (millis, 1 digit), "%(milli3)" (millis, 3 digits),<br>"%(micro)" (micros), "%(micro6)" (micros, 6 digits),<br>"%(nano)" (nanos), "%(nano9)" (nanos, 9 digits),<br>"%(pico)" (picos), "%(pico12)" (picos, 12 digits),<br>"%(weekDay)" (1 to 7), "%(dayName)" (in current language), "%(monthName)" (in current language), "%(shortDayName)" (in current language), "%(shortMonthName)" (in current language).
	::For a full list, see the [https://live.exept.de/ClassDoc/classDocOf:,AbstractTime#AbstractTime_category_printing%20&%20storing AbstractTime class documentation], ~~orlook~~ into the source in the browser.		::For a full list, see the [https://live.exept.de/ClassDoc/classDocOf:,AbstractTime#AbstractTime_category_printing%20&%20storing AbstractTime class documentation], or look into the source in the class browser.

	:''aTimestamp'' '''printOn:''' ''aStream'' '''format:''' ''formatString'' => void		:''aTimestamp'' '''printOn:''' ''aStream'' '''format:''' ''formatString'' => void

Cg: /* Printing */

2023-07-07T16:39:15Z

Printing

← Nächstältere Version		Version vom 7. Juli 2023, 16:39 Uhr
Zeile 252:		Zeile 252:

	:''aTimestamp'' '''printStringFormat:''' ''formatString'' => String		:''aTimestamp'' '''printStringFormat:''' ''formatString'' => String
			:: generates a string representation as specified in formatString.<br>For example, " Timestamp now printStringFormat:'%h:%m:%s' " might generate a string like " '20:48:47' "<br>Valid format characters are:
	:: ~~generates a string representation as specified in formatString.<br>For example, " Timestamp now printStringFormat~~:~~'%h:%m:%s' " might generate a string like " '20:48:47' "<br>Valid format characters are<br>~~"%h" (hour 24 padded),"%m" (minutes),"%s" (seconds),"%i" (millis),"%j" (micros),<br>"%(day)" (day-nr in month), "%(month)" (month-nr), "%(year)" (year),<br>"%H" (hour 24 unpadded), "%M" (minutes unpadded), "%S" (seconds unpadded),<br>"%(milli)" (millis), "%(milli1)" (millis, 1 digit), "%(milli3)" (millis, 3 digits),<br>"%(micro)" (micros), "%(micro6)" (micros, 6 digits),<br>"%(nano)" (nanos), "%(nano9)" (nanos, 9 digits),<br>"%(pico)" (picos), "%(pico12)" (picos, 12 digits),<br>"%(weekDay)" (1 to 7), "%(dayName)" (in current language), "%(monthName)" (in current language), "%(shortDayName)" (in current language), "%(shortMonthName)" (in current language). ~~For a full list, see the [https://live.exept.de/ClassDoc/classDocOf:,AbstractTime#AbstractTime_category_printing%20&%20storing AbstractTime class documentation].~~		:::"%h" (hour 24 padded),"%m" (minutes),"%s" (seconds),"%i" (millis),"%j" (micros),<br>"%(day)" (day-nr in month), "%(month)" (month-nr), "%(year)" (year),<br>"%H" (hour 24 unpadded), "%M" (minutes unpadded), "%S" (seconds unpadded),<br>"%(milli)" (millis), "%(milli1)" (millis, 1 digit), "%(milli3)" (millis, 3 digits),<br>"%(micro)" (micros), "%(micro6)" (micros, 6 digits),<br>"%(nano)" (nanos), "%(nano9)" (nanos, 9 digits),<br>"%(pico)" (picos), "%(pico12)" (picos, 12 digits),<br>"%(weekDay)" (1 to 7), "%(dayName)" (in current language), "%(monthName)" (in current language), "%(shortDayName)" (in current language), "%(shortMonthName)" (in current language).
			::For a full list, see the [https://live.exept.de/ClassDoc/classDocOf:,AbstractTime#AbstractTime_category_printing%20&%20storing AbstractTime class documentation], orlook into the source in the browser.

	:''aTimestamp'' '''printOn:''' ''aStream'' '''format:''' ''formatString'' => void		:''aTimestamp'' '''printOn:''' ''aStream'' '''format:''' ''formatString'' => void

Cg: /* Printing */

2023-07-07T16:37:33Z

Printing

← Nächstältere Version		Version vom 7. Juli 2023, 16:37 Uhr
Zeile 256:		Zeile 256:
	:''aTimestamp'' '''printOn:''' ''aStream'' '''format:''' ''formatString'' => void		:''aTimestamp'' '''printOn:''' ''aStream'' '''format:''' ''formatString'' => void
	::same as above, but the string is sent to aStream.		::same as above, but the string is sent to aStream.

	:''aTimestamp'' '''printStringFormat:''' ''formatString'' => String
	::same as above, but the string is not sent to any stream, but returned as result.

	== TimeDuration ==		== TimeDuration ==

Cg: /* Printing */

2023-07-07T16:37:07Z

Printing

← Nächstältere Version		Version vom 7. Juli 2023, 16:37 Uhr
Zeile 237:		Zeile 237:

	:''aTimestamp'' '''printRFC1123FormatOn:''' ''aStream'' => void		:''aTimestamp'' '''printRFC1123FormatOn:''' ''aStream'' => void
	::append the RFC1123 representation to a stream.<br>E.g. " Timestamp now printRFC1123FormatOn: Transcript ".		::append the RFC1123 representation to a stream.<br>E.g. "<code>Timestamp now printRFC1123FormatOn: Transcript</code>".

	:''aTimestamp'' '''printStringIso8601''' => String		:''aTimestamp'' '''printStringIso8601''' => String
Zeile 243:		Zeile 243:

	:''aTimestamp'' '''printIso8601FormatOn:''' ''aStream'' => void		:''aTimestamp'' '''printIso8601FormatOn:''' ''aStream'' => void
	::append the Iso8601 representation to a stream.<br>E.g. " Timestamp now printIso8601FormatOn: Transcript ".		::append the Iso8601 representation to a stream.<br>E.g. "<code>Timestamp now printIso8601FormatOn: Transcript</code>".

	:''aTimestamp'' '''printStringIso8601Compressed''' => String		:''aTimestamp'' '''printStringIso8601Compressed''' => String
Zeile 249:		Zeile 249:

	:''aTimestamp'' '''printIso8601CompressedOn:''' ''aStream'' => void		:''aTimestamp'' '''printIso8601CompressedOn:''' ''aStream'' => void
	::append the compressed Iso8601 representation to a stream.<br>E.g. " Timestamp now printIso8601CompressedOn: Transcript ".		::append the compressed Iso8601 representation to a stream.<br>E.g. "<code>Timestamp now printIso8601CompressedOn: Transcript</code>".

	:''aTimestamp'' '''printStringFormat:''' ''formatString'' => String		:''aTimestamp'' '''printStringFormat:''' ''formatString'' => String
Zeile 256:		Zeile 256:
	:''aTimestamp'' '''printOn:''' ''aStream'' '''format:''' ''formatString'' => void		:''aTimestamp'' '''printOn:''' ''aStream'' '''format:''' ''formatString'' => void
	::same as above, but the string is sent to aStream.		::same as above, but the string is sent to aStream.

			:''aTimestamp'' '''printStringFormat:''' ''formatString'' => String
			::same as above, but the string is not sent to any stream, but returned as result.

	== TimeDuration ==		== TimeDuration ==

Cg: /* Useful Queries */

2023-07-07T16:34:32Z

Useful Queries

← Nächstältere Version		Version vom 7. Juli 2023, 16:34 Uhr
Zeile 92:		Zeile 92:

	==== Useful Queries ====		==== Useful Queries ====
	The class side provides information which os not related to any particular date (as ''static functions'' in C or Java nomenclature)		:The class side provides information which is not related to any particular date (i.e. ''static functions'' in C or Java nomenclature)

	:Date '''dayNamesForLanguage:''' ''langCode'' => Collection of Strings		:Date '''dayNamesForLanguage:''' ''langCode'' => Collection of Strings