A field "calendar" created, through a pop-up, an element of selecting a date and/or time. The "calendar" returns the date and/or time as a value.

Definition

A field "calendar" created, through a pop-up, an element of selecting a date and/or time. The "calendar" returns the date and/or time as a value.
calendar

Settings

calendar_settings

Common Plugin Settings (Link to the article)

Construction

Format

write a code to specify the format of the date and/or time displayed after the selection on the pop-up. For example, if the format is "F d, Y" and the selected date is 12-03-1983, the value "March 12, 1983" is shown. If for the same date, the format is "d-m-y", the value "12-03-83" is displayed.

The following characters are recognized in the format parameter string:

Format
character
Description Example returned values
Day
d Day of the month, 2 digits with leading zeros 01 to 31
D A textual representation of a day, three letters Mon through Sun
j Day of the month without leading zeros 1 to 31
l (lowercase 'L') A full textual representation of the day of the week Sunday through Saturday
N ISO-8601 numeric representation of the day of the week (added in PHP 5.1.0) 1 (for Monday) through 7 (for Sunday)
S English ordinal suffix for the day of the month, 2 characters st, nd, rd or th. Works well with j
w Numeric representation of the day of the week 0 (for Sunday) through 6 (for Saturday)
z The day of the year (starting from 0) 0 through 365
Week
W ISO-8601 week number of year, weeks starting on Monday (added in PHP 4.1.0) Example: 42 (the 42nd week in the year)
Month
F A full textual representation of a month, such as January or March January through December
m Numeric representation of a month, with leading zeros 01 through
M A short textual representation of a month, three letters Jan through Dec
n Numeric representation of a month, without leading zeros 1 through 12
t Number of days in the given month 28 through 31
Year
L Whether it's a leap year 1 if it is a leap year, 0 otherwise.
o ISO-8601 year number. This has the same value as Y, except that if the ISO week number (W) belongs to the previous or next year, that year is used instead. (added in PHP 5.1.0) Examples: 1999 or 2003
Y A full numeric representation of a year, 4 digits Examples: 1999 or 2003
y A two digit representation of a year Examples: 99 or 03
Time
a Lowercase Ante meridiem and Post meridiem am or pm
A Uppercase Ante meridiem and Post meridiem AM or PM
B Swatch Internet time 000 through 999
g 12-hour format of an hour without leading zeros 1 through 12
G 24-hour format of an hour without leading zeros 0 through 23
h 12-hour format of an hour with leading zeros 01 through 12
H 24-hour format of an hour with leading zeros 00 through 23
i Minutes with leading zeros 00 to 59
s Seconds, with leading zeros 00 through 59

Date Range

Select an option to disable some dates on the calendar:
  • All (default): to enable all dates of the year,
  • Past: to disable "today" and the dates after "today". For example, if we If we assume that the date today is "January 2, 2012", and we select this option then "January 2, 2012" and all dates after "January 2, 2012" are disabled.

    calendar past setting
  • Past & Today: to disable the dates after "today",
  • Today & Future: to disable the dates before "today". For example, if we If we assume that the date today is "January 2, 2012", and we select this option then all dates before "January 2, 2012" are disabled.

    calendar future today
  • Future: to disable "today" and the dates before "today".

Storage Format

Select an option to choose the storage format of the date in the data base:
  • Datetime: to store a date under format yyyy:mm:dd hh:mm:ss,
  • Timestamp: to store a date as an integer representing the number of seconds since the Unix Epoch (January 1 1970 00:00:00 GMT).

Show Time

Select an option to display different time selector:
  • No: to hide a time selector,

    no time selector setting
  • 12(am/pm): to display a time selector with "am", "pm" prefixes. The hour range of this selector is 0 to 11,

    fr time selector
  • 24(hours): to display a time selector with a hour range from 0 to 23.

    en time selector
You can place the time selector at the "right bottom" or the "left bottom" of the "calendar" pop-up.

By default, the time selector is placed at the right bottom of the "calendar" pop-up.
time_selector_position
Use the "Default Hour - Min - Sec" setting if you want to set a time by default.

This setting appears when you select option "No" for "Show Time" setting.
Default_time_setting

Theme

Select an option to choose one theme for the "calendar" pop-up:
  • Gold:Calendar theme gold
  • Steel:Calendar steel theme
  • Win2k:calendar win2k theme

Show Week Numbers

Select Yes to display a week numbers at the left of the "calendar" pop-up.
week_numbers_setting

Size

Write the input size of this field.
calendar-inputs