date.1 (2010 09)

ManualsBrandsHP ManualsSoftwareHP-UX Manpages

date(1) date(1)

NAME

date - display or set the date and time

SYNOPSIS

date [-u]

date [-u] +format

date [-u][mmddhhmm[[cc]yy]]

date [-a [-]sss[

.fff ]]

DESCRIPTION

The

date command displays or sets the current HP-UX system clock date and time. Since the HP-UX

system operates in Coordinated Universal Time (UTC), date

automatically converts to and from local

standard or daylight/summer time, based on your

TZ environment variable. See Environment Variables

in EXTERNAL INFLUENCES below.

Options

date recognizes the following option:

-u Input and output values in Coordinated Universal Time (UTC), functionally equivalent to

Greenwich Mean Time (GMT), instead of in local time.

-a [-]sss[.fff]

Slowly adjust the time by sss.fff seconds (fff represents fractions of a second). This adjust-

ment can be positive or negative. The system’s clock will be sped up or slowed down until it

has drifted by the number of seconds speciﬁed.

Formats

The

date command has two forms for displaying the date and time and one form for setting them.

date [-u]

Display the current date and time. The output is the same as for the

%c formatting direc-

tive for all languages except the C default language. See Formatting Directives and EXAM-

PLES below.

date [-u] +format

Display the current date and time according to formatting directives speciﬁed in format ,

which is a string of zero or more formatting directives and ordinary characters. If it con-

tains blanks, enclose it in apostrophes or quotation marks.

See Formatting Directives below.

All ordinary characters are copied unchanged into the output string.

The output string is always terminated with a newline character.

+ is speciﬁed and format is omitted, only a newline is output.

date [-u][mmddhhmm[[cc]yy]]

Set the HP-UX system clock to the date and time speciﬁed. You require the superuser

privilege.

If you include the

-u option, the speciﬁed date and time is assumed to be in Coordinated

Universal Time (UTC).

The numeric argument is interpreted left to right in two-digit pairs as follows:

mm Month number [

01-12].

dd Day number in the month [01-31].

hh Hour number (24-hour system) [00-23].

mm Minute number [00-59].

cc Century minus one [19-20].

yy Last two digits of the year number [70-99, 00-37 (1970-1999, 2000-2037)]. If

omitted, the current year is used.

If you attempt to set the date backwards,

date generates the warning,

HP-UX 11i Version 3: September 2010 − 1 − Hewlett-Packard Company 1

Summary of content (6 pages)

PAGE 1
date(1) date(1) NAME date - display or set the date and time SYNOPSIS date [-u] date [-u] +format date [-u] [mmddhhmm[[cc]yy]] date [-a [-]sss[.fff]] DESCRIPTION The date command displays or sets the current HP-UX system clock date and time. Since the HP-UX system operates in Coordinated Universal Time (UTC), date automatically converts to and from local standard or daylight/summer time, based on your TZ environment variable. See Environment Variables in EXTERNAL INFLUENCES below.
PAGE 2
date(1) date(1) do you really want to run time backwards?[yes/no] Type yes or the equivalent for your locale to set the clock backwards; anything else to cancel the command. When date is used to set the date, a pair of date change records is written to the file /var/adm/wtmps. (UNIX Standard only, see standards (5).) No warning is generated if date is set backwards.
PAGE 3
date(1) date(1) %w Weekday as a one-digit decimal number [0-6 (Sunday-Saturday)]. For example, 3. %W Week number of the year (Monday as the first day of the week) as a two-digit decimal number [00-53]. All days that precede the first Monday in the year are considered to be in week 00. For example, 02. %x Current date representation. For example, 01/12/94. %X Current time representation. For example, 19:45:58. %y Year without century as a two-digit decimal number [00-99]. For example, 93.
PAGE 4
date(1) date(1) %Oy Year (offset from %C) in alternate representation. Field Width and Precision An optional field width and precision specification can immediately follow the initial % of a formatting directive in the following order: [-0]width The decimal digit string width specifies a minimum field width in which the result of the conversion is right- or left-justified. The default is right-justified with space padding on the left.
PAGE 5
date(1) date(1) The character c is not a valid format directive, field width specifier, or precision specifier. do you really want to run time backwards?[yes/no] The date/time you specified is earlier than the current clock value. Type yes (or the equivalent for your locale) to set the clock backwards; anything else to cancel the command. no permission You need the superuser privilege to change the date. EXAMPLES Date in Different Languages Display the date.
PAGE 6
date(1) date(1) SEE ALSO locale(1), stime(2), ctime(3C), strftime(3C), tztab(4), environ(5), lang(5), langinfo(5), standards(5). STANDARDS CONFORMANCE date: SVID2, SVID3, XPG2, XPG3, XPG4, POSIX.