7 More Discussions You Might Find Interesting
1. High Performance Computing
In my company, it's fallen on me to serve as the admin of our new HPC cluster, a task that's very new to me. It's very important to me to lay a solid foundation and avoid any unnecessary pitfalls. So, can anyone recommend a succinct guide or list of do's-and-don'ts for adiminstering an HPC cluster?... (0 Replies)
Discussion started by: DBryan
0 Replies
2. Solaris
Hello Admins;
I need to get the certification in Oracle Solaris 10.
As far as I know, there is $300 fee for each part (1 & 2 ).
Does anybody know where we can get the discount coupons for these exams.
So that it would be cheaper than 300 bucks...
Thanks (6 Replies)
Discussion started by: snchaudhari2
6 Replies
3. What is on Your Mind?
A recent post where someone suggested redirecting with a clobber ">" to a file the same command was reading from prompted me to post this sysad good practice list. Some items are from times where I have learned things the hard way. I think this would be helpful so we can learn from each others... (8 Replies)
Discussion started by: ilikecows
8 Replies
4. Solaris
Hi all,
I wanted to know how to install oracle on solaris (b83)..
I also would like to know of a link that i can download oracle from?
please reply fast..
I need it for my exams day after tomorrow...
please reply (1 Reply)
Discussion started by: wrapster
1 Replies
5. AIX
Please help me in getting some fine docs ( other than redbooks)to learn AIX.
My mail ID: qsecofr400@gmail.com
Thanks in advance. (3 Replies)
Discussion started by: secofr
3 Replies
6. Solaris
solved issue (0 Replies)
Discussion started by: n0rus
0 Replies
7. UNIX for Dummies Questions & Answers
I am currently working on my Solaris 8.0 Certification ,and I've been working primarily with the Solaris Study Guide produced by Syngress & Osborne. It's a good study guide ,but I think that it does lack some clarity and detail! My question is ,are there any other Solaris Study Guides that could... (1 Reply)
Discussion started by: bilal_aa
1 Replies
DateTime::Format::Oracle(3pm) User Contributed Perl Documentation DateTime::Format::Oracle(3pm)
NAME
DateTime::Format::Oracle - Parse and format Oracle dates and timestamps
SYNOPSIS
use DateTime::Format::Oracle;
$ENV{'NLS_DATE_FORMAT'} = 'YYYY-MM-DD HH24:MI:SS';
my $dt = DateTime::Format::Oracle->parse_datetime('2003-01-16 23:12:01');
my $string = DateTime::Format::Oracle->format_datetime($dt);
DESCRIPTION
This module may be used to convert Oracle date and timestamp values into "DateTime" objects. It also can take a "DateTime" object and
produce a date string matching the "NLS_DATE_FORMAT".
Oracle has flexible date formatting via its "NLS_DATE_FORMAT" session variable. Date values will be returned from Oracle according to the
current value of that variable. Date values going into Oracle must also match the current setting of "NLS_DATE_FORMAT".
Timestamp values will match either the "NLS_TIMESTAMP_FORMAT" or "NLS_TIMESTAMP_TZ_FORMAT" session variables.
This module keeps track of these Oracle session variable values by examining environment variables of the same name. Each time one of
Oracle's formatting session variables is updated, the %ENV hash must also be updated.
METHODS
This class offers the following methods.
o nls_date_format
This method is used to determine the current value of Oracle's "NLS_DATE_FORMAT". It currently just reads the value from
$ENV{'NLS_DATE_FORMAT'}
or if that is not set, from the package variable $nls_date_format, which has a default value of "YYYY-MM-DD HH24:MI:SS". This is a
good default to have, but is not Oracle's default. Dates will fail to parse if Oracle's NLS_DATE_FORMAT and the value from this method
are not the same.
If you want to use the default from this module, you can do something like this after you connect to Oracle:
$dbh->do(
"alter session set nls_date_format = '" .
DateTime::Format::Oracle->nls_date_format .
"'"
);
o nls_timestamp_format
This method is used to determine the current value of Oracle's "NLS_TIMESTAMP_FORMAT". It currently just reads the value from
$ENV{'NLS_TIMESTAMP_FORMAT'}
or if that is not set, from the package variable $nls_timestamp_format, which has a default value of "YYYY-MM-DD HH24:MI:SS". This is
a good default to have, but is not Oracle's default. Dates will fail to parse if Oracle's NLS_TIMESTAMP_FORMAT and the value from this
method are not the same.
If you want to use the default from this module, you can do something like this after you connect to Oracle:
$dbh->do(
"alter session set nls_timestamp_format = '" .
DateTime::Format::Oracle->nls_timestamp_format .
"'"
);
o nls_timestamp_tz_format
This method is used to determine the current value of Oracle's "NLS_TIMESTAMP_TZ_FORMAT". It currently just reads the value from
$ENV{'NLS_TIMESTAMP_TZ_FORMAT'}
or if that is not set, from the package variable $nls_timestamp_tz_format, which has a default value of "YYYY-MM-DD HH24:MI:SS TZHTZM".
This is a good default to have, but is not Oracle's default. Dates will fail to parse if Oracle's NLS_TIMESTAMP_TZ_FORMAT and the
value from this method are not the same.
If you want to use the default from this module, you can do something like this after you connect to Oracle:
$dbh->do(
"alter session set nls_timestamp_tz_format = '" .
DateTime::Format::Oracle->nls_timestamp_tz_format .
"'"
);
o parse_datetime
Given a string containing a date and/or time representation matching "NLS_DATE_FORMAT", this method will return a new "DateTime"
object.
If given an improperly formatted string, this method may die.
o parse_date
Alias to "parse_datetime". Oracle's date datatype also holds time information.
o parse_timestamp
Given a string containing a date and/or time representation matching "NLS_TIMESTAMP_FORMAT", this method will return a new "DateTime"
object.
If given an improperly formatted string, this method may die.
o parse_timestamptz =item * parse_timestamp_with_time_zone
Given a string containing a date and/or time representation matching "NLS_TIMESTAMP_TZ_FORMAT", this method will return a new
"DateTime" object.
If given an improperly formatted string, this method may die.
o current_date_parser
The current "DateTime::Format::Builder" generated parsing method used by "parse_datetime" and "parse_date".
o current_timestamp_parser
The current "DateTime::Format::Builder" generated parsing method used by "parse_timestamp".
o current_timestamptz_parser
The current "DateTime::Format::Builder" generated parsing method used by "parse_timestamptz".
o format_datetime
Given a "DateTime" object, this method returns a string matching the current value of "NLS_DATE_FORMAT".
It is important to keep the value of $ENV{'NLS_DATE_FORMAT'} the same as the value of the Oracle session variable "NLS_DATE_FORMAT".
To determine the current value of Oracle's "NLS_DATE_FORMAT":
select NLS_DATE_FORMAT from NLS_SESSION_PARAMETERS
To reset Oracle's "NLS_DATE_FORMAT":
alter session set NLS_DATE_FORMAT='YYYY-MM-DD HH24:MI:SS'
It is generally a good idea to set "NLS_DATE_FORMAT" to an unambiguos value, with four-digit year, and hour, minute, and second.
o format_date
Alias to "format_datetime".
o format_timestamp
Given a "DateTime" object, this method returns a string matching the current value of "NLS_TIMESTAMP_FORMAT".
It is important to keep the value of $ENV{'NLS_TIMESTAMP_FORMAT'} the same as the value of the Oracle session variable
"NLS_TIMESTAMP_FORMAT".
To determine the current value of Oracle's "NLS_TIMESTAMP_FORMAT":
select NLS_TIMESTAMP_FORMAT from NLS_SESSION_PARAMETERS
To reset Oracle's "NLS_TIMESTAMP_FORMAT":
alter session set NLS_TIMESTAMP_FORMAT='YYYY-MM-DD HH24:MI:SS'
It is generally a good idea to set "NLS_TIMESTAMP_FORMAT" to an unambiguos value, with four-digit year, and hour, minute, and second.
o format_timestamptz =item * format_timestamp_with_time_zone
Given a "DateTime" object, this method returns a string matching the current value of "NLS_TIMESTAMP_TZ_FORMAT".
It is important to keep the value of $ENV{'NLS_TIMESTAMP_TZ_FORMAT'} the same as the value of the Oracle session variable
"NLS_TIMESTAMP_TZ_FORMAT".
To determine the current value of Oracle's "NLS_TIMESTAMP_TZ_FORMAT":
select NLS_TIMESTAMP_TZ_FORMAT from NLS_SESSION_PARAMETERS
To reset Oracle's "NLS_TIMESTAMP_TZ_FORMAT":
alter session set NLS_TIMESTAMP_TZ_FORMAT='YYYY-MM-DD HH24:MI:SS TZHTZM'
It is generally a good idea to set "NLS_TIMESTAMP_TZ_FORMAT" to an unambiguos value, with four-digit year, and hour, minute, and
second.
o current_date_format
The current generated method used by "format_datetime", "format_date", and "current_date_parser" to keep track of the "strptime"
translation of "NLS_DATE_FORMAT".
o current_timestamp_format
The current generated method used by "format_timestamp", "format_timestamp_with_time_zone", and "current_timestamp_parser" to keep
track of the "strptime" translation of "NLS_TIMESTAMP_FORMAT".
o current_timestamptz_format
The current generated method used by "format_timestamptz", "format_timestamp_with_time_zone", and "current_timestamp_parser" to keep
track of the "strptime" translation of "NLS_TIMESTAMP_FORMAT".
o oracle_to_posix
Given an "NLS_DATE_FORMAT", "NLS_TIMESTAMP_FORMAT", or "NLS_TIMESTAMP_TZ_FORMAT" value, this method returns a "DateTime"-compatible
"strptime" format value.
Translation is currently handled by "Convert::NLS_DATE_FORMAT".
LIMITATIONS
Oracle is more flexible with the case of names, such as the month, whereas "DateTime" generally returns names in "ucfirst" format.
MONTH -> FEBRUARY
Month -> February
month -> february
All translate to:
%B -> February
TIME ZONES
Oracle returns all dates and timestamps in a time zone similar to the "DateTime" floating time zone, except for 'timestamp with time zone'
columns.
INTERVAL ELEMENTS
I have not implemented "parse_duration", "format_duration", "parse_interval", nor "format_interval", and have no plans to do so.
If you need these features, unit tests, method implementations, and pointers to documentation are all welcome.
SUPPORT
Support for this module is provided via the datetime@perl.org email list. See http://lists.perl.org/ for more details.
TODO
Possibly read an environment variable to determine a time zone to use instead of 'floating'.
Test and document creating an instance via "new".
AUTHOR
Nathan Gray, <kolibrie@cpan.org>
ACKNOWLEDGEMENTS
I might have put this module off for another couple years without the lure of Jifty, Catalyst, and DBIx::Class pulling at me.
Thanks to Dan Horne for his RFC draft of this module.
COPYRIGHT & LICENSE
Copyright (C) 2006, 2008, 2011 Nathan Gray.
This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself, either Perl version 5.8.4 or,
at your option, any later version of Perl 5 you may have available.
SEE ALSO
Convert::NLS_DATE_FORMAT
datetime@perl.org mailing list
http://datetime.perl.org/
perl v5.12.4 2011-10-12 DateTime::Format::Oracle(3pm)