Time field: Difference between revisions

From Memento Database Wiki
Jump to navigation Jump to search
(Created page with "A Time field may contain a value that is used to represent a particular time of day -- specifically, the value stored is the same as that used by Unix and Linux systems to rep...")
 
mNo edit summary
(4 intermediate revisions by the same user not shown)
Line 1: Line 1:
A Time field may contain a value that is used to represent a particular time of day -- specifically, the value stored is the same as that used by Unix and Linux systems to represent dates, which is the number of seconds since 00:00:00 of the current day.
{{Stamp|2018-09-27|4.5.5|1.1.0}}
A Time field may contain any time of day.
 
In Calculation fields, the value used is that used by Unix and Linux systems to represent times, which is the number of seconds since 00:00:00 of the current day. In JavaScript fields, the value used is based on that used by Unix and Linux systems to represent times, but is instead, the number on milliseconds since 00:00:00.000 of the current day.


This value allows time arithmetic to work readily, by merely doing integer arithmetic with the value.
This value allows time arithmetic to work readily, by merely doing integer arithmetic with the value.


When a time value is interpreted for import, expert, or display in hours, minutes, and seconds, the current locale is used. The format for import and export can be specified in program settings.
When a time value is interpreted for import, export, or display in hours, minutes, and seconds, the current locale is used. The format for import and export can be specified in program settings.


== Name and Hint ==
{{FieldNameHint}}
Standard across all [[Field Type|'''field types''']].


== Advanced Parameters ==
== Advanced Parameters ==
; Default Value : By default, there is no default value. Alternatively, the default may be set to the current time as of entry or edit of the field within an entry.
; Default Value : By default, there is no default value. Alternatively, the default may be set to the current time as of entry or edit of the field within an entry.


; Required : Make entry of a value mandatory before saving an entry
{{Specific|The Time formats parameter|mobile}}
; Time formats: The format may be specified explicitly. Selecting ''Time formats'' causes a card to appear in which these properties may be changed:
:; Language: The language/locale may be set.
:; Short time: The user may select among a number of choices for the short form of a time.
:; Long time: The user may select among a number of choices for the long form of a time.
 
{{FieldRequired}}


== Display Options ==
== Display Options ==
; Display in the list as : Select among the following roles for the current field:
{{FieldRoleRNDS}}
:* As a Regular field
:* As an Entry Name
:* As an Entry Description
:* As an Entry Status


; Used in calendar as : The field may be set to be used as a duration in the calendar.
; Used in calendar as : The field may be set to be used as a duration in the calendar.


; Display field name in Entry Edit Card? : By default, yes.
{{FieldOnCard}}
 
{{FieldFont}}


; Font : Choices are:
{{FieldDepend}}
:* Family: Regular, Light, Condensed, Thin, Medium. By default, Regular.
:* Style: Normal, Bold, Italic, Bold Italic. By default, Normal.
:* Size: By default, 18. Direct entry to change.
:* Color: By default, White. Palette of 20 colors, backed up by a continuously variable color chooser.


; Dependencies : Ability to add one or more visibility dependencies upon fields with qualifying types.
[[Category:Spec]]

Revision as of 06:10, 27 September 2018

« Page as of 2018-09-27, editions Mobile 4.5.5, Desktop 1.1.0 »

A Time field may contain any time of day.

In Calculation fields, the value used is that used by Unix and Linux systems to represent times, which is the number of seconds since 00:00:00 of the current day. In JavaScript fields, the value used is based on that used by Unix and Linux systems to represent times, but is instead, the number on milliseconds since 00:00:00.000 of the current day.

This value allows time arithmetic to work readily, by merely doing integer arithmetic with the value.

When a time value is interpreted for import, export, or display in hours, minutes, and seconds, the current locale is used. The format for import and export can be specified in program settings.

Name
Textual, case-insensitive field identifier that can include spaces; it's best to avoid characters that can be used as operators, though (standard across all field types)
Hint
Textual, case-insensitive field identifier that can include spaces

Advanced Parameters

Default Value
By default, there is no default value. Alternatively, the default may be set to the current time as of entry or edit of the field within an entry.
« The Time formats parameter applies to the mobile {{{3}}} edition only »
Time formats
The format may be specified explicitly. Selecting Time formats causes a card to appear in which these properties may be changed:
Language
The language/locale may be set.
Short time
The user may select among a number of choices for the short form of a time.
Long time
The user may select among a number of choices for the long form of a time.
Required
Make entry of a value mandatory before saving an entry

Display Options

Display in the list as
Select among the following roles for the current field in the entries list:
  • As a Regular field
  • As an Entry Name
  • As an Entry Description
  • As an Entry Status
Used in calendar as
The field may be set to be used as a duration in the calendar.
The field name
Display the name of the field in the card entry (By default, On). By this, it is meant that the field name will or will not be displayed on either the Entry View card or the Entry Edit card.
Font
Choices are:
  • Family: Regular, Light, Condensed, Thin, Medium. By default, Regular.
  • Style: Normal, Bold, Italic, Bold Italic. By default, Normal.
  • Size: By default, 18. Direct entry to change.
  • Color: By default, White. Palette of 20 colors, backed up by a continuously variable color chooser.
Dependencies
Ability to add one or more visibility dependencies upon fields with qualifying types.