NAME

Spreadsheet::ParseExcel::Utility - Utility function for Spreadsheet::ParseExcel

SYNOPSIS

use strict;
#Declare
use Spreadsheet::ParseExcel::Utility qw(ExcelFmt ExcelLocaltime LocaltimeExcel);

#Convert localtime ->Excel Time
my $iBirth = LocaltimeExcel(11, 10, 12, 23, 2, 64);
                           # = 1964-3-23 12:10:11
print $iBirth, "\n";       # 23459.5070717593

#Convert Excel Time -> localtime
my @aBirth = ExcelLocaltime($iBirth, undef);
print join(":", @aBirth), "\n";   # 11:10:12:23:2:64:1:0

#Formatting
print ExcelFmt('yyyy-mm-dd', $iBirth), "\n"; #1964-3-23
print ExcelFmt('m-d-yy', $iBirth), "\n";     # 3-23-64
print ExcelFmt('#,##0', $iBirth), "\n";      # 23,460
print ExcelFmt('#,##0.00', $iBirth), "\n";   # 23,459.51
print ExcelFmt('"My Birthday is (m/d):" m/d', $iBirth), "\n";
                                  # My Birthday is (m/d): 3/23

DESCRIPTION

Spreadsheet::ParseExcel::Utility exports utility functions concerned with Excel format setting.

Functions

This module can export 3 functions: ExcelFmt, ExcelLocaltime and LocaltimeExcel.

ExcelFmt

$sTxt = ExcelFmt($sFmt, $iData [, $i1904]);

$sFmt is a format string for Excel. $iData is the target value. If $flg1904 is true, this functions assumes that epoch is 1904. $sTxt is the result.

For more detail and examples, please refer sample/chkFmt.pl in this distribution.

ex.

ExcelLocaltime

($iSec, $iMin, $iHour, $iDay, $iMon, $iYear, $iwDay, $iMSec) = ExcelLocaltime($iExTime [, $flg1904]);

ExcelLocaltime converts time information in Excel format into Perl localtime format. $iExTime is a time of Excel. If $flg1904 is true, this functions assumes that epoch is 1904. $iSec, $iMin, $iHour, $iDay, $iMon, $iYear, $iwDay are same as localtime. $iMSec means 1/1,000,000 seconds(ms).

LocaltimeExcel

$iExTime = LocaltimeExcel($iSec, $iMin, $iHour, $iDay, $iMon, $iYear [,$iMSec] [,$flg1904])

LocaltimeExcel converts time information in Perl localtime format into Excel format . $iSec, $iMin, $iHour, $iDay, $iMon, $iYear are same as localtime.

If $flg1904 is true, this functions assumes that epoch is 1904. $iExTime is a time of Excel.

AUTHOR

Kawai Takanori (Hippo2000) kwitknr@cpan.org

http://member.nifty.ne.jp/hippo2000/            (Japanese)
http://member.nifty.ne.jp/hippo2000/index_e.htm (English)

SEE ALSO

Spreadsheet::ParseExcel, Spreadsheet::WriteExcel

COPYRIGHT

This module is part of the Spreadsheet::ParseExcel distribution.