Skip to content

"show time" setting for date field #655

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 3 commits into from
Jun 5, 2023
Merged

"show time" setting for date field #655

Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
71a301c
"show time" setting for date field
intoeetive May 10, 2023
b431006
Update date.md
matthewjohns0n Jun 2, 2023
883bead
Update date.md
matthewjohns0n Jun 2, 2023
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
16 changes: 14 additions & 2 deletions docs/fieldtypes/date.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -15,13 +15,25 @@ The Date field allows for quick entry of dates via the publish form. When the fi

## Field Settings

### Localized or Fixed?
### Date Localization

On the publish form, along with a field to enter a date, you will also see an option to select whether you want the date localized or fixed:
Choose how the field data should be localized. The options are
- _Always localized_ (the date displayed on the front-end will be converted into the logged-in member's timezone. An example use case is the start of an online event, when attenders need to know their local time)
- _Alway fixed_ (the date on the front-end will be displayed in the site's configured timezone. An example use case is the start of an in-person event, when attenders need to know the time as it is in the event's timezone)
- _Ask each time_

### Include time?
When turned off, only date will be displayed, otherwise the editor can also enter the time into the same field.

## Publish form

On the publish form (when `Date Localization` setting is set to `Ask each time`), along with a field to enter a date, you will also see an option to select whether you want the date localized or fixed:

- **Localized:** A date that is localized will be translated into the logged-in member's current timezone. For instance, if you enter a date of _10/21/2015 4:29 PM_ and you're in Pacific Daylight Time, a member in Eastern Daylight Time will see the date as _10/21/2015 7:29 PM_. Or, for logged out members, the date will be localized on the front-end according to the site's configured timezone.
- **Fixed:** A fixed date will NOT be localized to a member's timezone, or the site's configured timezone. The date will appear as it does in the control panel everywhere by all members.

NOTE: **Note:** These options are only available when using Date as a field and not as a Grid column.

At the bottom of the calendar popup you will also see a "Today" button that can be used to automatically set the date to the current date.

## Template Tag
Expand Down