1*cdf0e10cSrcweir<?xml version="1.0" encoding="UTF-8"?>
2*cdf0e10cSrcweir
3*cdf0e10cSrcweir
4*cdf0e10cSrcweir
5*cdf0e10cSrcweir<!--
6*cdf0e10cSrcweir ***********************************************************************
7*cdf0e10cSrcweir *
8*cdf0e10cSrcweir * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
9*cdf0e10cSrcweir *
10*cdf0e10cSrcweir * Copyright 2000, 2010 Oracle and/or its affiliates.
11*cdf0e10cSrcweir *
12*cdf0e10cSrcweir * OpenOffice.org - a multi-platform office productivity suite
13*cdf0e10cSrcweir *
14*cdf0e10cSrcweir * This file is part of OpenOffice.org.
15*cdf0e10cSrcweir *
16*cdf0e10cSrcweir * OpenOffice.org is free software: you can redistribute it and/or modify
17*cdf0e10cSrcweir * it under the terms of the GNU Lesser General Public License version 3
18*cdf0e10cSrcweir * only, as published by the Free Software Foundation.
19*cdf0e10cSrcweir *
20*cdf0e10cSrcweir * OpenOffice.org is distributed in the hope that it will be useful,
21*cdf0e10cSrcweir * but WITHOUT ANY WARRANTY; without even the implied warranty of
22*cdf0e10cSrcweir * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
23*cdf0e10cSrcweir * GNU Lesser General Public License version 3 for more details
24*cdf0e10cSrcweir * (a copy is included in the LICENSE file that accompanied this code).
25*cdf0e10cSrcweir *
26*cdf0e10cSrcweir * You should have received a copy of the GNU Lesser General Public License
27*cdf0e10cSrcweir * version 3 along with OpenOffice.org.  If not, see
28*cdf0e10cSrcweir * <http://www.openoffice.org/license.html>
29*cdf0e10cSrcweir * for a copy of the LGPLv3 License.
30*cdf0e10cSrcweir *
31*cdf0e10cSrcweir ************************************************************************
32*cdf0e10cSrcweir -->
33*cdf0e10cSrcweir
34*cdf0e10cSrcweir
35*cdf0e10cSrcweir		<helpdocument version="1.0">
36*cdf0e10cSrcweir<meta>
37*cdf0e10cSrcweir<topic id="textscalc01func_datexml" indexer="include" status="PUBLISH">
38*cdf0e10cSrcweir<title id="tit" xml-lang="en-US">DATE</title>
39*cdf0e10cSrcweir<filename>/text/scalc/01/func_date.xhp</filename>
40*cdf0e10cSrcweir</topic>
41*cdf0e10cSrcweir</meta>
42*cdf0e10cSrcweir<body>
43*cdf0e10cSrcweir<bookmark xml-lang="en-US" branch="index" id="bm_id3155511"><bookmark_value>DATE function</bookmark_value>
44*cdf0e10cSrcweir</bookmark>
45*cdf0e10cSrcweir<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_DATUM" id="bm_id3149022" localize="false"/><paragraph role="heading" id="hd_id3155511" xml-lang="en-US" level="2" l10n="U" oldref="3"><variable id="date"><link href="text/scalc/01/func_date.xhp">DATE</link>
46*cdf0e10cSrcweir</variable></paragraph>
47*cdf0e10cSrcweir<paragraph role="paragraph" id="par_id3153551" xml-lang="en-US" l10n="CHG" oldref="4"><ahelp hid="HID_FUNC_DATUM">This function calculates a date specified by year, month, day and displays it in the cell's formatting.</ahelp> The default format of a cell containing the DATE function is the date format, but you can format the cells with any other number format.</paragraph>
48*cdf0e10cSrcweir<paragraph role="heading" id="hd_id3148590" xml-lang="en-US" level="3" l10n="U" oldref="5">Syntax</paragraph>
49*cdf0e10cSrcweir<paragraph role="code" id="par_id3150474" xml-lang="en-US" l10n="U" oldref="6">DATE(Year; Month; Day)</paragraph>
50*cdf0e10cSrcweir<paragraph role="paragraph" id="par_id3152815" xml-lang="en-US" l10n="CHG" oldref="7">
51*cdf0e10cSrcweir<emph>Year</emph> is an integer between 1583 and 9957 or between 0 and 99.</paragraph>
52*cdf0e10cSrcweir<paragraph role="paragraph" id="par_id3153222" xml-lang="en-US" l10n="U" oldref="174">In <item type="menuitem"><switchinline select="sys"><caseinline select="MAC">%PRODUCTNAME - Preferences</caseinline><defaultinline>Tools - Options</defaultinline></switchinline> - $[officename] - General </item>you can set from which year a two-digit number entry is recognized as 20xx.</paragraph>
53*cdf0e10cSrcweir<paragraph role="paragraph" id="par_id3155817" xml-lang="en-US" l10n="CHG" oldref="8">
54*cdf0e10cSrcweir<emph>Month</emph> is an integer indicating the month.</paragraph>
55*cdf0e10cSrcweir<paragraph role="paragraph" id="par_id3153183" xml-lang="en-US" l10n="CHG" oldref="9">
56*cdf0e10cSrcweir<emph>Day</emph> is an integer indicating the day of the month.</paragraph>
57*cdf0e10cSrcweir<paragraph role="paragraph" id="par_id3156260" xml-lang="en-US" l10n="CHG" oldref="10">If the values for month and day are out of bounds, they are carried over to the next digit. If you enter <item type="input">=DATE(00;12;31)</item> the result will be 12/31/00. If, on the other hand, you enter <item type="input">=DATE(00;13;31)</item> the result will be 1/31/01.</paragraph>
58*cdf0e10cSrcweir<paragraph role="heading" id="hd_id3147477" xml-lang="en-US" level="3" l10n="U" oldref="12">Example</paragraph>
59*cdf0e10cSrcweir<paragraph role="paragraph" id="par_id3152589" xml-lang="en-US" l10n="CHG" oldref="16">
60*cdf0e10cSrcweir<item type="input">=DATE(00;1;31)</item> yields 1/31/00 if the cell format setting is MM/DD/YY.</paragraph>
61*cdf0e10cSrcweir</body>
62*cdf0e10cSrcweir</helpdocument>
63