InitialValue property

DateTimeField.InitialValue — Number

Special value available in formulas:

Item

DateTimeField

The field this property is part of, enabling multiple checked items in the app designer to share the same formula and be updated all at once.

Consider the fields Field1 and Field2, which should only be considered to be valid if their values are greater than 4. Without using the Item value, the Valid property of Field1 would need to use the formula Field1 > 4Field1 > 4 and the Valid property of Field2 would need to use the formula Field2 > 4Field2 > 4.

Using Item, both formulas can read Item > 4Item > 4. This is useful if you have many fields and you want to be able to update their formulas all at once. To do so, click their check boxes in Calcapp Creator and make sure that a checked field is selected. Then, when you update a formula for one checked field, you update all the other checked fields too, which is a great timesaver.

Use Item in exactly the same way you'd use the regular name. Field1.VisibleField1,Visible and Item.VisibleItem,Visible are equivalent, for instance.

The initial value, displayed before the user has entered an explicit value.

Initial values of date and time fields must be assigned through a formula.

When a field is reset through a reset button or the RESET function, its value is set to the initial value. (Reset buttons can also be configured to assign blank values.)

The formula associated with this property is evaluated just before the screen housing the field is shown. In other words, the formula can reference values of fields that have been shown previously.

Examples

NOW()NOW()

Sets the initial value to the current date and time.

Sets the initial value to the current date. The time is set to midnight.

DATE(1981, 5, 14)DATE(1981; 5; 14)

Sets the initial value to the date May 14, 1981.

TIME(6, 0, 0)TIME(6; 0; 0)

Sets the initial value to the time 6:00 AM.

DATE(1981, 5, 14) + TIME(6, 0, 0)DATE(1981; 5; 14) + TIME(6; 0; 0)

Sets the initial value to May 14, 1981, at 6:00 AM.

IF(MainScreen!Date <= TODAY(), MainScreen!Date)IF(MainScreen!Date <= TODAY(); MainScreen!Date)

Sets the initial value to the value of the Date field, which appears as part of the screen MainScreen, but only if it does not represent a date in the future. Otherwise, the initial value is set to a blank value.