Skip to main content

Privacera Documentation

Table of Contents

Encryption API date input formats

Dates supplied to the Privacera or Bouncy Castle API must be in one of the formats listed in this topic.


  • yyyy or uuuu is 4-digit year. uuuu is a year format that does not need the specification of the era CE (Common Era) or BCE (Before Common Era). A positive number indicates CE, while a negative number indicates BCE.

  • MM is the 2-digit, zero-padded month of yyyy or uuuu.

  • dd is the 2-digit, zero-padded day of MM.

  • HH is the 2-digit, zero-padded 24-hour clock hour of dd.

  • mm is the 2-digit, zero-padded minute of HH.

  • ss is the 2-digit, zero-padded second of mm.

  • SSS is the 3-digit, zero-padded microsecond of ss.

  • The literal T is the time indicator and the literal Z is the indicator for time zone offset, as described in W3C's Time & date: Essential concepts.


    The time zone offset is not encrypted.

  • The string literals AM and PM are before noon and afternoon in the analog 12-hour clock.

Supported day-first date input formats

Day-first formats begin with the numeric, zero-padded day:

  • dd/mm/uuuu

  • dd/mm/uuuuHH:mm:ss:SSS

Supported month-first date input formats

Month-first formats begin with the numeric, zero-padded month:

  • mm/dd/uuuu HH:mm:ss,SSS

  • mm/dd/uuuu HH:mm:ss,SSSZ

  • mm/dd/uuuu HH:mm:ss.SSS

  • mm/dd/uuuu HH:mm:ss.SSSZ

  • mm/dd/uuuu HH:mm:ss

  • mm/dd/uuuu HH:mm:ss AM

  • mm/dd/uuuu HH:mm:ss PM

  • mm/dd/uuuu HH:mm:ssZ

  • mm/dd/uuuu HH:mm

  • mm/dd/uuuu HH:mmZ

  • mm/dd/uuuu

  • mm/dd/uuuuTHH:mm:ss,SSS

  • mm/dd/uuuuTHH:mm:ss,SSSZ

  • mm/dd/uuuuTHH:mm:ss.SSS

  • mm/dd/uuuuTHH:mm:ss.SSSZ

  • mm/dd/uuuuTHH:mm:ss

  • mm/dd/uuuuTHH:mm:ssZ

  • mm/dd/uuuuTHH:mm

  • mm/dd/uuuuTHH:mmZ

Supported year-first date input formats

Year-first formats begin with the year:

  • uuuu-mm-dd

  • uuuu-mm-dd AM

  • uuuu-mm-dd PM

  • uuuu-mm-dd HH:mm AM

  • uuuu-mm-dd HH:mm PM

  • uuuu-mm-dd HH:mm:ss,SSS

  • uuuu-mm-dd HH:mm:ss.SSS

  • uuuu-mm-dd HH:mm:ss,SSS AM

  • uuuu-mm-dd HH:mm:ss,SSS PM

  • uuuu-mm-dd HH:mm:ss.SSS AM

  • uuuu-mm-dd HH:mm:ss.SSS PM

  • uuuu-mm-dd HH:mm:ss

  • uuuu-mm-dd HH:mm

  • uuuu-mm-ddTHH:mm:ss,SSS

  • uuuu-mm-ddTHH:mm:ss,SSSZ

  • uuuu-mm-ddTHH:mm:ss.SSS

  • uuuu-mm-ddTHH:mm:ss.SSSZ

  • uuuu-mm-ddTHH:mm:ss

  • uuuu-mm-ddTHH:mm:ssZ

  • uuuu-mm-ddTHH:mm

  • uuuu-mm-ddTHH:mmZ

  • uuuu/mm/dd HH:mm:ss,SSS

  • uuuu/mm/dd HH:mm:ss.SSS

  • uuuu/mm/dd HH:mm:ss

  • uuuu/mm/dd HH:mm

  • uuuu/mm/dd

  • uuuu/mm/ddTHH:mm:ss,SSS

  • uuuu/mm/ddTHH:mm:ss,SSSZ

  • uuuu/mm/ddTHH:mm:ss.SSS

  • uuuu/mm/ddTHH:mm:ss.SSSZ

  • uuuu/mm/ddTHH:mm:ss

  • uuuu/mm/ddTHH:mm:ssZ

  • uuuu/mm/ddTHH:mm

  • uuuu/mm/ddTHH:mmZ

Examples of supported date input formats

  • 1900-01-01

  • 1912/01/02

  • 1912-01-02 03:10:50

  • 1912/01/02 03:10:50

  • 1912-01-02 03:10:50.000

  • 1912/01/02 03:10:50.000

  • 1950/02/03T05:20:30.213+1000

  • 2099-12-31T05:20:30.213+1000

Supported date ranges

The range of dates supported by DateTime is from 1900/01/01 to 2099/12/31, inclusive.


This range is irrespective of delimiters in the input. It specifies only the lower and upper limits of the values of year, month, and day, and does not apply to any specific hour, day, or minute.