gYearMonth

EXESS_MAX_YEAR_MONTH_LENGTH

15U

The maximum length of a gYearMonth string from exess_write_year_month()

struct ExessYearMonth

A month in a Gregorian year.

int16_t year

Year: any positive or negative value.

uint8_t month

Month: [1, 12].

ExessTimezone zone

Timezone offset in quarter hours.

ExessResult exess_read_year_month(const char *str, ExessYearMonth *out)

Read a gYearMonth string after any leading whitespace.

Parameters:

  • str – String to read.

  • out – Parsed value, or zero on error.

Returns:

The count of characters read, and a status.

ExessResult exess_write_year_month(ExessYearMonth value, size_t buf_size, char *buf)

Write a canonical gYearMonth string.

The output is always in canonical form, like 2001-04.

Parameters:

  • value – Value to write.

  • buf_size – Size of buf in bytes.

  • buf – Output buffer, or null to only measure.

Returns:

ExessStatus.EXESS_SUCCESS on success, ExessStatus.EXESS_NO_SPACE if the buffer is too small, or ExessStatus.EXESS_BAD_VALUE if the value is invalid.