Internationalization
Corteza allows you to fully translate most aspect of the system. From the user interface to custom Low Code configurations such as modules and their fields.
Additionally, Corteza adjusts value formatting based on the locale, such as custom temporal and numerical strings. Value formatting uses the native ECMAScript internationalization API.
Structure overview
corteza-js/src/formatting/datetime.ts
The corteza-js/src/formatting/datetime.ts
file defines the functions which should be used when localizing temporal values such as dates and timestamps.
The current implementation defines three functions which should be used for different applications.
-
fullDateTime
: outputs locally formatted date and time, no seconds. -
date
: outputs locally formatted date without time. -
time
: outputs locally formatted time.
Usage
import { fmt } from '@cortezaproject/corteza-js'
// ...
fmt.fullDateTime(sampleDate, optionalDateTimeFormat)
fmt.date(sampleDate, optionalDateTimeFormat)
fmt.time(sampleTime, optionalDateTimeFormat)
If you wish to test the output for different locales, you will need to change the locale in your browser settings. Corteza will respond to the change and use the newly assigned locale.
Modify formatting
To modify the default formatting, pass in the Intl.DateTimeFormat
object as the last argument to the function call.
fmt.fullDateTime(sampleDate, {
day: "numeric",
month: "numeric",
year: "numeric",
hour: "numeric",
minute: "numeric",
})
Refer to the |
Custom format reference
dateStyle
:-
full
-
long
-
medium
-
short
timeStyle
:-
full
-
long
-
medium
-
short
year
:-
numeric
(example output:2012
) -
2-digit
(example output:12
)
month
:-
numeric
(example output:2
) -
2-digit
(example output:02
) -
long
(example output:March
) -
short
(example output:Mar
) -
narrow
(example output:M
)
day
:-
numeric
(example output:1
) -
2-digit
(example output:01
)
minute
:-
numeric
-
2-digit
second
:-
numeric
-
2-digit