DATEv3
The DATEv3 algorithm is a format-preserving tokenization scheme designed for handling date values. It tokenizes dates while preserving their original format, including the delimiters used. It supports a wide range of date formats and allows for specific parts of the date (such as year, month, or day) to be kept in their original form.
Supported Formats
Following date formats are supported:
| DDMMMMYYYY | DDMMMYYYY | MMDDYYYY |
| MMMMDDYYYY | MMMDDYYYY | DDMMYYYY |
| MMMDDYY | YYYYMMDD | DDMMMYY |
| YYMMDD | MMYYYY | DDMMYY |
| MMDDYY | MMYY |
Supported Delimiters
Following delimiters are supported:
| / (slash) | . (period) |
| - (hyphen) | (space) |
Date3 Parameters
Protect/reveal using DATEv3 algorithm requires the following parameters:
| Parameter | Description |
|---|---|
| Start and End Year | Defines the valid range of date. Both must be specified as 4-digit numbers. — The minimum value of start year is 1000 — The maximum value of end year is 9999. For example, a valid range is 1990–2023. |
| Date Format | The arrangements of date, month, and year in a specific format, see Date Format. |
| Tweak | The tweak data is a required parameter, and its length must be between 16 and 64 characters, inclusive. |
Important Notes
-
Input data must start with a date that follows the format specified in the protection policy, using a supported delimiter.
-
If input data contains any of the supported date formats separated by any of the supported delimiters, the client tokenizes input data while preserving its format along with the delimiter. For example, if the input date is 2023-01-15 (in YYYYMMDD format), the delimiter (-) is preserved in the tokenized value (2054-08-22).
-
Make sure the input data is separated by a delimiter. More than one delimiter is not allowed in the input value.
-
The value of end year must be greater than or equal to start year.
-
A range of up to 999 years is supported between the start and end years. This ensures the tokenization tables remain efficient and easy to manage.
-
When preserving or revealing parts of the date (DATE, YEAR, MONTH), a maximum of two parts can be preserved/revealed.
-
If the input value contains characters and special symbols, the client will tokenize the dates that conforms to the formats specified in the protection policy. If no dates matching these formats are found, the client will throw an error.
-
If multiple dates are provided in input data, the first matched format with supported delimiter will be tokenized/detokenized.
