Time

Description

When you update data in the DataWindow painter, DataWindow Designer builds a SQL UPDATE statement in the background. The Time parameter determines how DataWindow Designer specifies a time datatype when it builds the SQL UPDATE statement.

Applies to

ODBC
O84 Oracle 8.x and Oracle8i
O90 Oracle9i
O10 Oracle 10g

Syntax

The syntax you use to specify the Time parameter differs slightly depending on the database.

The Database Profile Setup dialog box inserts special characters (quotes and backslashes) where needed, so you can specify just the time format.

In code, you must use the following syntax:

ODBC syntax DataWindow Designer parses the backslash followed by two single quotes (\'') as a single quote when it builds the SQL UPDATE statement:

Time=' \''time_format\'' '

Oracle syntax DataWindow Designer parses each set of four consecutive single quotes ('''') as a single quote when it builds the SQL UPDATE statement:

Time=' ''''time_format'''' '

Parameter	Description
' \'' ' ''''	ODBC syntax Type a single quote, followed by one space, followed by a backslash, followed by two single quotes. There is no space between the two single quotes and the beginning of the time format. Oracle syntax Type a single quote, followed by one space, followed by four single quotes. There is no space between the four single quotes and the beginning of the time format.
time_format	The time format you want DataWindow Designer to use when it builds a SQL UPDATE statement to update a data source in the DataWindow painter. For more on display formats, see the User’s Guide.
\'' ' '''' '	ODBC syntax Type a backslash, followed by two single quotes, followed by one space, followed by a single quote. There is no space between the end of the time format and the backslash. Oracle syntax Type four single quotes, followed by one space, followed by a single quote. There is no space between the end of the time format and the four single quotes.

Parameter

Description

' \''

' ''''

ODBC syntax Type a single quote, followed by one space, followed by a backslash, followed by two single quotes. There is no space between the two single quotes and the beginning of the time format.

Oracle syntax Type a single quote, followed by one space, followed by four single quotes. There is no space between the four single quotes and the beginning of the time format.

time_format

The time format you want DataWindow Designer to use when it builds a SQL UPDATE statement to update a data source in the DataWindow painter.

For more on display formats, see the User’s Guide.

\'' '

'''' '

ODBC syntax Type a backslash, followed by two single quotes, followed by one space, followed by a single quote. There is no space between the end of the time format and the backslash.

Oracle syntax Type four single quotes, followed by one space, followed by a single quote. There is no space between the end of the time format and the four single quotes.

Default

The default value for Time depends on the DBMS you are accessing:

DBMS	Date default value
ODBC	If no value is specified for the Time parameter, DataWindow Designer looks for a time format in the section for your ODBC driver in the PBODB110 initialization file. If no time format is found in the PBODB110 initialization file, DataWindow Designer uses the ODBC time format escape sequence.
Oracle	The default Oracle date format For information, see your Oracle documentation.

DBMS

Date default value

ODBC

If no value is specified for the Time parameter, DataWindow Designer looks for a time format in the section for your ODBC driver in the PBODB110 initialization file. If no time format is found in the PBODB110 initialization file, DataWindow Designer uses the ODBC time format escape sequence.

Oracle

The default Oracle date format

For information, see your Oracle documentation.

Examples

About these examples

Assume you are updating a table named Workhours by setting the Start column to 08:30. This time is represented by the following DataWindow Designer time format:

hh:mm

Example 1 (ODBC syntax)

To specify that DataWindow Designer should use this format for the time datatype when it builds the SQL UPDATE statement:

Database profile Type the following in the Time Format box on the Syntax page in the Database Profile Setup dialog box:
```
hh:mm
```

Application Type the following in code:

SQLCA.DbParameter="Time=' \''hh:mm\'' '"

What happens DataWindow Designer builds the following SQL UPDATE statement to update the table:

UPDATE WORKHOURS

SET START='08:30'

Example 2 (Oracle syntax)

To specify that DataWindow Designer should use this format for the time datatype when it builds the SQL UPDATE statement:

Database profile Type hh:mm in the Time Format box on the Syntax page in the Database Profile Setup dialog box.

Application Type the following in code:

SQLCA.DbParameter="Time=' ''''hh:mm'''' '"

What happens DataWindow Designer builds the following SQL UPDATE statement to update the table:

UPDATE WORKHOURS

SET START='08:30'

Time

Description

Applies to

Syntax

Default

Examples

About these examples

Example 1 (ODBC syntax)

Example 2 (Oracle syntax)

See also