Date Format Strings

JavaScript is not currently enabled, but is required for full CodeSonar manual search and browse functionality.

If you are viewing this file in your hub's Web GUI, enable JavaScript in your browser: you will also need it for GUI functionality.

If you opened this file directly from disk, your browser may be directly suppressing JavaScript functionality: certain browsers perform this suppression on local files (but not files delivered by web servers) for security reasons.

If you access the manual through the hub's Web GUI, the functionality will not be suppressed because the hub is a web server.
Alternatively, your browser may allow you to explicitly disable the security setting that suppresses functionality. See the CodeSonar FAQ for more information.

CodeSonar^® 9.2p0

CONFIDENTIAL

CodeSecure Inc

General

Date Format Strings

CodeSonar uses date format strings to specify how the Web GUI should display and interpret dates.

Users with sufficient permissions can view and edit the list of currently-used data format strings in the Content tab of the Settings page.
Other users can view the list of currently-used date format strings on the Advanced Search page.

Structure
Relative Date Format Strings

Structure

A date format string uses a combination of regular text and format specifiers to precisely define the form that output should take, or the way that input should be interpreted. For example, the format string

%m/%d/%y

is interpreted as "month as a decimal number, followed by a slash, followed by day of the month as a decimal number, followed by a slash, followed by year (without century) as a decimal number".

If Date Display Format is set to this string, the CodeSonar GUI will display all dates as MM/DD/YY.
If the Date Parse Formats list includes this string, CodeSonar will interpret user-specified dates of the form aa/bb/cc to mean month aa, day bb, year cc (unless there is another date format string, higher on the list, that matches aa/bb/cc).

A format specifier consists of a single character introduced by a % character. The following format specifiers are available (from Python time module).

%a	Weekday name according to the locale, abbreviated.
%A	Weekday name according to the locale, full.
%b	Month name according to the locale, abbreviated.
%B	Month name according to the locale, full.
%c	Preferred date and time format according to the locale.
%d	Day of the month as a decimal number in the range 01 to31.
%H	Hour (24-hour clock) as a decimal number in the range 00 to 23.
%I	Hour (12-hour clock) as a decimal number in the range 01 to 12.
%j	Day of the year as a decimal number in the range 001 to 366.
%m	Month as a decimal number in the range 01 to 12.
%M	Minute as a decimal number in the range 00 to 59.
%p	AM or PM (or local equivalent).
%S	Second as a decimal number in the range 00 to 61.
%U	Week number of the year as a decimal number in the range 00 to 53, with Sunday considered the first day in the week. All days in a new year preceding the first Sunday are considered to be in week 0.
%w	Weekday as a decimal number in the range 0 to 6, where 0 is Sunday.
%W	Week number of the year as a decimal number in the range 00 to 53, with Monday considered the first day in the week. All days in a new year preceding the first Monday are considered to be in week 0.
%x	Preferred date representation according to the locale (no time).
%X	Preferred time representation according to the locale (no date).
%y	Year, excluding century, as a decimal number in the range 00 to 99.
%Y	Year, including century, as a decimal number.
%Z	Local time zone name or abbreviation (empty if no time zone exists).
%%	The "%" character.

Relative Date Format Strings

Relative date format strings differ from regular date format strings in several important respects.

The format specifiers are different, as shown in the table below, and a relative date format string can only contain one format specifier.
All matches to relative date format strings are treated by CodeSonar as meaning "in the last num unit", where num is the number that matches the specifier in the format string and unit depends on the specifier used.

For example,

the format string
since %S seconds ago
will match user input such as "since 1000000 seconds ago", "since 5 seconds ago", and so on.
each of the following format strings will match a different set of input strings, but all of those matches will be interpreted as "in the last num day(s)"
- last %d day
- Letzten %d Tage
- la la la la la %d
- last %d months (see below)

Important Note: CodeSonar does not recognize the meaning of words (like "since", "past", "minutes", and so forth) in a specified relative date format string, it merely tries to match them against strings entered by users. The only part of the format string with semantic value is the format specifier.

The following format specifiers can be used in relative date format strings.

%S	seconds
%M	minutes
%H	hours
%d	days
%W	weeks
%m	months
%Y	years

Sometimes users will enter slightly different strings depending on the range of the search. For example, English users will want to search for "past 1 month" rather than "past 1 months". Other languages may have special cases for other numbers. For these special cases, the format string may contain the specific number that must be matched. For example, the format string

last %1d day

matches "last 1 day", but not "last 2 day" or "last 12 day".

To report problems with this documentation, please visit https://support.codesecure.com/.