import time
local = time.localtime (time.time())

The date and time information will be returned in a tuple containing 9 integers. For example, the tuple

(2007, 1, 20, 8, 23, 44, 5, 20, 0)

represents January 20, 2007 at 08:23:44, which is a Saturday, the 20th day of the year, and Daylight Savings time is NOT active.

The following code will let you extract each component of the tuple:

local[0] - gives you the 4-digit year (2007 in above example)
str(local[0])[2:] - gives you the last 2 digits of the year (07 in above example)
local[1] - gives you the month (1 in above example)
local[2] - gives you day of the month (20 in above example)
local[3] - gives you the hour (8 in above example)
local[4] - gives you the minute (23 in above example)
local[5] - gives you the second (44 in above example)
local[6] - gives you the weekday, where 0 represents Monday (5 in above example, which represents Saturday)
local[7] - gives you the Julian day of the year (20 in above example)
local[8] - tells you whether you are currently in Daylight Savings time, where 0 indicates "no" and 1 indicates "yes" (0 in above example)

With a little creative coding, you can get the date and time in any format you want. Remember that these are all integers, and as such, can be used in arithmetic operations. To create a date string, such as 1/20/2007, the integers must be changed to strings, like this:

str(local[1]) + "/" + str(local[2]) + "/" + str(local[0])

To generate that date using a 2-digit year (1/20/07), use the following:

str(local[1]) + "/" + str(local[2]) + "/" + str(local[0])[2:]

For toggle switches, a value of 0 turns the toggle on - if the switch is already on, there will be no change. A value of 1 used for one of the toggle switches turns the toggle off - again, if the switch is already off, there will be no change. Finally, a value of 2 for a toggle parameter toggles the state of the switch - if it's on, it will be turned off, and if it's off, it will be turned on.

Toggle parameters are coded like this - the ShowGrid command is used as an example, with the toggle parameter shown in red, turning the Grid ON:

# ShowGrid
App.Do( Environment, 'ShowGrid', {
        'ShowGrid': 0,
        'GeneralSettings': {
                'ExecutionMode': App.Constants.ExecutionMode.Default,
                'AutoActionMode': App.Constants.AutoActionMode.Match
                }
        })

In that same command, to turn the Grid OFF, code the ShowGrid parameter this way:

        'ShowGrid': 1,

And to toggle the Grid state, code the ShowGrid parameter this way:

        'ShowGrid': 2,

There are other ways to code the toggle parameter. To turn the Grid ON, you can use one of the following:

        'ShowGrid': App.Constants.Boolean.false,
        'ShowGrid': App.Constants.OnOff.On,
        'ShowGrid': App.Constants.ShowCommands.Show,
        'ShowGrid': App.Constants.EnterCommands.Enter,
        'ShowGrid': False,     ### only available in PSP 9 and later versions

To turn the Grid OFF, you can use one of these:

        'ShowGrid': App.Constants.Boolean.true,
        'ShowGrid': App.Constants.OnOff.Off,
        'ShowGrid': App.Constants.ShowCommands.Hide,
        'ShowGrid': App.Constants.EnterCommands.Exit,
        'ShowGrid': True,     ### only available in PSP 9 and later versions

And to toggle the state of the Grid switch, you can use:

        'ShowGrid': App.Constants.OnOff.Toggle,
        'ShowGrid': App.Constants.ShowCommands.Toggle,
        'ShowGrid': App.Constants.EnterCommands.Toggle,

The rest of this table lists the commands that control toggle switches, and the parameter used to control the state of the toggle switch. Unless otherwise noted, these commands work in all versions of PSP: