diff options
| author | Norbert Thiebaud <nthiebaud@gmail.com> | 2012-09-01 09:51:27 -0500 |
|---|---|---|
| committer | Norbert Thiebaud <nthiebaud@gmail.com> | 2012-10-16 11:07:30 -0500 |
| commit | 61173c1b58efa79c0ba6b08348d2796a249d0186 (patch) | |
| tree | 00ebf544db18942e2a1ecfc5e5fa16931127d38f /source/text/scalc/01 | |
| parent | 3dc2e7497f1798ae4ff6c5c8c562666bc10a393c (diff) | |
move help structure one directory up
Change-Id: Ie970e39fbb6795a92d9fdd13510409d7dcd071bc
Diffstat (limited to 'source/text/scalc/01')
182 files changed, 23555 insertions, 0 deletions
diff --git a/source/text/scalc/01/01120000.xhp b/source/text/scalc/01/01120000.xhp new file mode 100644 index 0000000000..5b342277a9 --- /dev/null +++ b/source/text/scalc/01/01120000.xhp @@ -0,0 +1,60 @@ +<?xml version="1.0" encoding="UTF-8"?> + + + +<!-- + *********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************ + --> + + + <helpdocument version="1.0"> +<meta> +<topic id="textscalc0101120000xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Page Preview</title> +<filename>/text/scalc/01/01120000.xhp</filename> +</topic> +</meta> +<body> +<section id="seitenansicht"> +<bookmark xml-lang="en-US" branch="hid/.uno:PrintPreview" id="bm_id2822117" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/.uno:PrintPreview" id="bm_id3146060" localize="false"/><paragraph role="heading" id="hd_id1918698" xml-lang="en-US" level="1" l10n="NEW"><link href="text/scalc/01/01120000.xhp">Page Preview</link></paragraph> +<paragraph role="paragraph" id="par_id3831598" xml-lang="en-US" l10n="NEW"><ahelp hid=".uno:PrintPreview">Displays a preview of the printed page or closes the preview.</ahelp></paragraph> +</section> +<section id="howtoget"> + <embed href="text/shared/00/00000401.xhp#ansicht"/> +</section> +<paragraph role="paragraph" id="par_id3145847" xml-lang="en-US" l10n="NEW">Use the icons on the <emph>Page Preview Bar</emph> to scroll through the pages of the document or to print the document.</paragraph> +<paragraph role="paragraph" id="par_id9838862" xml-lang="en-US" l10n="NEW">You can also press <switchinline select="sys"><caseinline select="MAC">Command</caseinline><defaultinline>Ctrl</defaultinline></switchinline>+Page Up and <switchinline select="sys"><caseinline select="MAC">Command</caseinline><defaultinline>Ctrl</defaultinline></switchinline>+Page Down keys to scroll through the pages.</paragraph> +<paragraph role="note" id="par_id7211828" xml-lang="en-US" l10n="NEW">You cannot edit your document while you are in the page preview.</paragraph> +<bookmark xml-lang="en-US" branch="hid/.uno:ClosePreview" id="bm_id9368395" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/.uno:ClosePreview" id="bm_id2166814" localize="false"/><paragraph role="paragraph" id="par_id460829" xml-lang="en-US" l10n="NEW"><ahelp hid="." visibility="hidden">To exit the page preview, click the <emph>Close Preview</emph> button.</ahelp></paragraph> +<section id="relatedtopics"> +<paragraph role="paragraph" id="par_id3155829" xml-lang="en-US" l10n="C"><link href="text/scalc/main0210.xhp" name="Page View Object Bar">Page View Object Bar</link></paragraph> +</section> +</body> +</helpdocument> diff --git a/source/text/scalc/01/02110000.xhp b/source/text/scalc/01/02110000.xhp new file mode 100644 index 0000000000..502a41198a --- /dev/null +++ b/source/text/scalc/01/02110000.xhp @@ -0,0 +1,199 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> + +<!-- +*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************ + --> + + +<meta> +<topic id="textscalc0102110000xml" indexer="include"> +<title id="tit" xml-lang="en-US">Navigator</title> +<filename>/text/scalc/01/02110000.xhp</filename> +</topic> +</meta> +<body> +<section id="navigator"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3150791"><bookmark_value>Navigator;for sheets</bookmark_value> +<bookmark_value>navigating;in spreadsheets</bookmark_value> +<bookmark_value>displaying; scenario names</bookmark_value> +<bookmark_value>scenarios;displaying names</bookmark_value> +</bookmark><comment>mw made "navigating..." a two level entry and deleted "navigating;data range"</comment> +<bookmark xml-lang="en-US" branch="hid/.uno:Navigator" id="bm_id8227797" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/.uno:Navigator" id="bm_id3145171" localize="false"/> +<paragraph role="heading" id="hd_id3150791" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/scalc/01/02110000.xhp" name="Navigator">Navigator</link></paragraph> +<paragraph role="paragraph" id="par_id3156422" xml-lang="en-US" l10n="U" oldref="2"><ahelp hid=".uno:Navigator">Activates and deactivates the Navigator.</ahelp> The Navigator is a <link href="text/shared/00/00000005.xhp#andocken" name="dockable window">dockable window</link>.</paragraph> +</section> +<section id="howtoget"> +<embed href="text/shared/00/00000402.xhp#navigator"/> +</section> +<embed href="text/shared/guide/navigator.xhp#navigator"/> +<paragraph role="paragraph" id="par_id3145271" xml-lang="en-US" l10n="CHG" oldref="40">Choose <emph>View - Navigator</emph> to display the Navigator.</paragraph> +<bookmark xml-lang="en-US" branch="hid/SC_HID_SC_NAVIPI_COL" id="bm_id3163713" localize="false"/> +<paragraph role="heading" id="hd_id3159155" xml-lang="en-US" level="2" l10n="U" oldref="4">Column</paragraph> +<paragraph role="paragraph" id="par_id3146984" xml-lang="en-US" l10n="CHG" oldref="5"><ahelp hid="HID_SC_NAVIPI_COL">Enter the column letter. Press Enter to reposition the cell cursor to the specified column in the same row.</ahelp></paragraph> +<bookmark xml-lang="en-US" branch="hid/SC_HID_SC_NAVIPI_ROW" id="bm_id3156286" localize="false"/> +<paragraph role="heading" id="hd_id3147126" xml-lang="en-US" level="2" l10n="U" oldref="6">Row</paragraph> +<paragraph role="paragraph" id="par_id3149958" xml-lang="en-US" l10n="CHG" oldref="7"><ahelp hid="HID_SC_NAVIPI_ROW">Enter a row number. Press Enter to reposition the cell cursor to the specified row in the same column.</ahelp></paragraph> +<bookmark xml-lang="en-US" branch="hid/SC_HID_SC_NAVIPI_DATA" id="bm_id3149123" localize="false"/> +<paragraph role="heading" id="hd_id3150717" xml-lang="en-US" level="2" l10n="U" oldref="8">Data Range</paragraph> +<paragraph role="paragraph" id="par_id3150752" xml-lang="en-US" l10n="U" oldref="10"><ahelp hid="HID_SC_NAVIPI_DATA">Specifies the current data range denoted by the position of the cell cursor.</ahelp></paragraph> +<table id="tbl_id3154754"> +<tablerow> +<tablecell> +<paragraph role="paragraph" id="par_id3159264" xml-lang="en-US" l10n="E"> +<image id="img_id3147338" src="cmd/sc_grid.png" width="0.2228in" height="0.2228in"><alt id="alt_id3147338" xml-lang="en-US">Icon</alt> + </image></paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3146919" xml-lang="en-US" l10n="U" oldref="9">Data Range</paragraph> +</tablecell> +</tablerow> +</table> + +<bookmark xml-lang="en-US" branch="hid/SC_HID_SC_NAVIPI_UP" id="bm_id3155111" localize="false"/> +<paragraph role="heading" id="hd_id3148488" xml-lang="en-US" level="2" l10n="U" oldref="14">Start</paragraph> +<paragraph role="paragraph" id="par_id3150086" xml-lang="en-US" l10n="U" oldref="16"><ahelp hid="HID_SC_NAVIPI_UP">Moves to the cell at the beginning of the current data range, which you can highlight using the <emph>Data Range</emph> button.</ahelp></paragraph> +<table id="tbl_id3150306"> +<tablerow> +<tablecell> +<paragraph role="paragraph" id="par_id3152994" xml-lang="en-US" l10n="E"> +<image id="img_id3150515" src="sw/imglst/sc20186.png" width="0.2228in" height="0.2228in"><alt id="alt_id3150515" xml-lang="en-US">Icon</alt> + </image></paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3154372" xml-lang="en-US" l10n="U" oldref="15">Start</paragraph> +</tablecell> +</tablerow> +</table> + +<bookmark xml-lang="en-US" branch="hid/SC_HID_SC_NAVIPI_DOWN" id="bm_id3156449" localize="false"/> +<paragraph role="heading" id="hd_id3146982" xml-lang="en-US" level="2" l10n="U" oldref="17">End</paragraph> +<paragraph role="paragraph" id="par_id3152985" xml-lang="en-US" l10n="U" oldref="19"><ahelp hid="HID_SC_NAVIPI_DOWN">Moves to the cell at the end of the current data range, which you can highlight using the <emph>Data Range</emph> button.</ahelp></paragraph> +<table id="tbl_id3152901"> +<tablerow> +<tablecell> +<paragraph role="paragraph" id="par_id3159170" xml-lang="en-US" l10n="E"> +<image id="img_id3148871" src="sw/imglst/sc20175.png" width="0.2228in" height="0.2228in"><alt id="alt_id3148871" xml-lang="en-US">Icon</alt> + </image></paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3147072" xml-lang="en-US" l10n="U" oldref="18">End</paragraph> +</tablecell> +</tablerow> +</table> + +<bookmark xml-lang="en-US" branch="hid/SC_HID_SC_NAVIPI_ROOT" id="bm_id3155269" localize="false"/> +<paragraph role="heading" id="hd_id3150107" xml-lang="en-US" level="2" l10n="U" oldref="20">Toggle</paragraph> +<paragraph role="paragraph" id="par_id3159098" xml-lang="en-US" l10n="U" oldref="22"><ahelp hid="HID_SC_NAVIPI_ROOT">Toggles the content view. Only the selected Navigator element and its subelements are displayed.</ahelp> Click the icon again to restore all elements for viewing.</paragraph> +<table id="tbl_id3153973"> +<tablerow> +<tablecell> +<paragraph role="paragraph" id="par_id3152869" xml-lang="en-US" l10n="E"> +<image id="img_id3149126" src="sw/imglst/sc20244.png" width="0.2228in" height="0.2228in"><alt id="alt_id3149126" xml-lang="en-US">Icon</alt> + </image></paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3159229" xml-lang="en-US" l10n="U" oldref="21">Toggle</paragraph> +</tablecell> +</tablerow> +</table> + +<bookmark xml-lang="en-US" branch="hid/SC_HID_SC_NAVIPI_ZOOM" id="bm_id3154654" localize="false"/> +<paragraph role="heading" id="hd_id3149381" xml-lang="en-US" level="2" l10n="U" oldref="11">Contents</paragraph> +<paragraph role="paragraph" id="par_id3150051" xml-lang="en-US" l10n="U" oldref="13"><ahelp hid="HID_SC_NAVIPI_ZOOM">Allows you to hide/show the contents.</ahelp></paragraph> +<table id="tbl_id3153811"> +<tablerow> +<tablecell> +<paragraph role="paragraph" id="par_id3155597" xml-lang="en-US" l10n="E"> +<image id="img_id3154738" src="sw/imglst/sc20233.png" width="0.2228in" height="0.2228in"><alt id="alt_id3154738" xml-lang="en-US">Icon</alt> + </image></paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3150955" xml-lang="en-US" l10n="U" oldref="12">Contents</paragraph> +</tablecell> +</tablerow> +</table> + +<bookmark xml-lang="en-US" branch="hid/SC_HID_SC_NAVIPI_SCEN" id="bm_id3145115" localize="false"/> +<paragraph role="heading" id="hd_id3147244" xml-lang="en-US" level="2" l10n="U" oldref="23">Scenarios</paragraph> +<paragraph role="paragraph" id="par_id3153955" xml-lang="en-US" l10n="U" oldref="25"><ahelp hid="HID_SC_NAVIPI_SCEN">Displays all available scenarios. Double-click a name to apply that scenario.</ahelp> The result is shown in the sheet. For more information, choose <link href="text/scalc/01/06050000.xhp" name="Tools - Scenarios"><emph>Tools - Scenarios</emph></link>.</paragraph> +<table id="tbl_id3147405"> +<tablerow> +<tablecell> +<paragraph role="paragraph" id="par_id3148745" xml-lang="en-US" l10n="E"> +<image id="img_id3159256" src="sc/imglst/navipi/na07.png" width="0.2228in" height="0.2228in"><alt id="alt_id3159256" xml-lang="en-US">Icon</alt> + </image></paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3166466" xml-lang="en-US" l10n="U" oldref="24">Scenarios</paragraph> +</tablecell> +</tablerow> +</table> + +<paragraph role="paragraph" id="par_idN10A6C" xml-lang="en-US" l10n="NEW">If the Navigator displays scenarios, you can access the following commands when you right-click a scenario entry:</paragraph> +<bookmark xml-lang="en-US" branch="hid/SC_HID_SC_SCENARIO_DELETE" id="bm_id1900997" localize="false"/> +<paragraph role="heading" id="par_idN10A77" xml-lang="en-US" level="3" l10n="NEW">Delete</paragraph> +<paragraph role="paragraph" id="par_idN10A7B" xml-lang="en-US" l10n="NEW"><ahelp hid="HID_SC_SCENARIO_DELETE">Deletes the selected scenario.</ahelp></paragraph> +<bookmark xml-lang="en-US" branch="hid/SC_HID_SC_SCENARIO_EDIT" id="bm_id4495376" localize="false"/> +<paragraph role="heading" id="par_idN10A92" xml-lang="en-US" level="3" l10n="NEW">Properties</paragraph> +<paragraph role="paragraph" id="par_idN10A96" xml-lang="en-US" l10n="NEW"><ahelp hid="HID_SC_SCENARIO_EDIT">Opens the <link href="text/scalc/01/06050000.xhp">Edit scenario</link> dialog, where you can edit the scenario properties.</ahelp></paragraph> +<bookmark xml-lang="en-US" branch="hid/SC_HID_SC_NAVIPI_DROP" id="bm_id3157871" localize="false"/> +<paragraph role="heading" id="hd_id3150037" xml-lang="en-US" level="2" l10n="U" oldref="26">Drag Mode</paragraph> +<paragraph role="paragraph" id="par_id3157876" xml-lang="en-US" l10n="CHG" oldref="28"><ahelp hid="HID_SC_NAVIPI_DROP">Opens a submenu for selecting the drag mode. You decide which action is performed when dragging and dropping an object from the Navigator into a document. Depending on the mode you select, the icon indicates whether a hyperlink, link or a copy is created.</ahelp></paragraph> +<table id="tbl_id3153118"> +<tablerow> +<tablecell> +<paragraph role="paragraph" id="par_id3149947" xml-lang="en-US" l10n="E"> +<image id="img_id3159119" src="cmd/sc_chainframes.png" width="0.2228in" height="0.2228in"><alt id="alt_id3159119" xml-lang="en-US">Icon</alt> + </image></paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3150656" xml-lang="en-US" l10n="U" oldref="27">Drag Mode</paragraph> +</tablecell> +</tablerow> +</table> + +<bookmark xml-lang="en-US" branch="hid/SC_HID_SC_DROPMODE_URL" id="bm_id3146876" localize="false"/> +<paragraph role="heading" id="hd_id3149009" xml-lang="en-US" level="3" l10n="U" oldref="29">Insert as Hyperlink</paragraph> +<paragraph role="paragraph" id="par_id3146938" xml-lang="en-US" l10n="U" oldref="30"><ahelp hid="HID_SC_DROPMODE_URL">Inserts a hyperlink when you drag-and-drop an object from the Navigator into a document.</ahelp> You can later click the created hyperlink to set the cursor and the view to the respective object. </paragraph> +<paragraph role="note" id="par_id3880733" xml-lang="en-US" l10n="NEW">If you insert a hyperlink that links to an open document, you need to save the document before you can use the hyperlink.<comment>UFI: fixes bugtraq 5009354</comment></paragraph> +<bookmark xml-lang="en-US" branch="hid/SC_HID_SC_DROPMODE_LINK" id="bm_id3150740" localize="false"/> +<paragraph role="heading" id="hd_id3154682" xml-lang="en-US" level="3" l10n="U" oldref="31">Insert as Link</paragraph> +<paragraph role="paragraph" id="par_id3150746" xml-lang="en-US" l10n="U" oldref="32"><ahelp hid="HID_SC_DROPMODE_LINK">Creates a link when you drag-and-drop an object from the Navigator into a document.</ahelp></paragraph> +<bookmark xml-lang="en-US" branch="hid/SC_HID_SC_DROPMODE_COPY" id="bm_id3154846" localize="false"/> +<paragraph role="heading" id="hd_id3145824" xml-lang="en-US" level="3" l10n="U" oldref="33">Insert as Copy</paragraph> +<paragraph role="paragraph" id="par_id3147471" xml-lang="en-US" l10n="U" oldref="34"><ahelp hid="HID_SC_DROPMODE_COPY">Generates a copy when you drag-and-drop an object from the Navigator into a document.</ahelp></paragraph> +<bookmark xml-lang="en-US" branch="hid/SC_HID_SC_NAVIPI_ENTRIES" id="bm_id3150695" localize="false"/> +<paragraph role="heading" id="hd_id3147423" xml-lang="en-US" level="2" l10n="U" oldref="38">Objects</paragraph> +<paragraph role="paragraph" id="par_id3150700" xml-lang="en-US" l10n="U" oldref="39"><ahelp hid="HID_SC_NAVIPI_ENTRIES">Displays all objects in your document.</ahelp></paragraph> +<bookmark xml-lang="en-US" branch="hid/SC_HID_SC_NAVIPI_DOC" id="bm_id3152785" localize="false"/> +<paragraph role="heading" id="hd_id3150860" xml-lang="en-US" level="2" l10n="U" oldref="35">Documents</paragraph> +<paragraph role="paragraph" id="par_id3153929" xml-lang="en-US" l10n="U" oldref="36"><ahelp hid="HID_SC_NAVIPI_DOC">Displays the names of all open documents.</ahelp> To switch to another open document in the Navigator, click the document name. The status (active, inactive) of the document is shown in brackets after the name. You can switch the active document in the <emph>Window</emph> menu.</paragraph> +</body> +</helpdocument> diff --git a/source/text/scalc/01/02120000.xhp b/source/text/scalc/01/02120000.xhp new file mode 100644 index 0000000000..b3078506af --- /dev/null +++ b/source/text/scalc/01/02120000.xhp @@ -0,0 +1,53 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> + +<!-- +*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************ + --> + + +<meta> + <topic id="textscalc0102120000xml" indexer="include" status="PUBLISH"> + <title xml-lang="en-US" id="tit">Headers & Footers</title> + <filename>/text/scalc/01/02120000.xhp</filename> + </topic> + </meta> + <body> +<bookmark xml-lang="en-US" branch="hid/.uno:EditHeaderAndFooter" id="bm_id6105651" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/.uno:EditHeaderAndFooter" id="bm_id3149960" localize="false"/><comment>mw deleted two index entries</comment> +<paragraph xml-lang="en-US" id="hd_id3145251" role="heading" level="1" l10n="U" oldref="1">Headers & Footers</paragraph> + <paragraph xml-lang="en-US" id="par_id3151073" role="paragraph" l10n="U" oldref="2"><variable id="kopfundfusszeilentext"><ahelp hid=".uno:EditHeaderAndFooter">Allows you to define and format headers and footers.</ahelp> +</variable></paragraph> + <paragraph xml-lang="en-US" id="par_id3153415" role="paragraph" l10n="CHG" oldref="3">The<emph> Headers/Footers </emph>dialog contains the tabs for defining headers and footers. There will be separate tabs for the left and right page headers and footers if the <emph>Same content left/right</emph> option was not marked in the <link href="text/scalc/01/05070000.xhp" name="Page Style">Page Style</link> dialog.</paragraph> + <section id="howtoget"> + <embed href="text/scalc/00/00000402.xhp#kopffuss"/> + </section> + <embed href="text/scalc/01/02120100.xhp#kopfzeile"/> + <embed href="text/shared/00/00000001.xhp#zurueck"/> + </body> +</helpdocument>
\ No newline at end of file diff --git a/source/text/scalc/01/02120100.xhp b/source/text/scalc/01/02120100.xhp new file mode 100644 index 0000000000..137ffd7635 --- /dev/null +++ b/source/text/scalc/01/02120100.xhp @@ -0,0 +1,201 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> + +<!-- +*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************ + --> + + +<meta> + <topic id="textscalc0102120100xml" indexer="include" status="PUBLISH"> + <title xml-lang="en-US" id="tit">Header/Footer</title> + <filename>/text/scalc/01/02120100.xhp</filename> + </topic> + </meta> + <body> + <section id="kopfzeile"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3153360"><bookmark_value>page styles; headers</bookmark_value> + <bookmark_value>page styles; footers</bookmark_value> + <bookmark_value>headers; defining</bookmark_value> + <bookmark_value>footers; defining</bookmark_value> + <bookmark_value>file names in headers/footers</bookmark_value> + <bookmark_value>changing;dates, automatically</bookmark_value> + <bookmark_value>dates;updating automatically</bookmark_value> + <bookmark_value>automatic date updates</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_SCPAGE_HFED_HR" id="bm_id3149655" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/SC_HID_SCPAGE_HFED_FR" id="bm_id3150541" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/SC_HID_SCPAGE_HFED_HL" id="bm_id3148799" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/SC_HID_SCPAGE_HFED_FL" id="bm_id3156422" localize="false"/> +<paragraph xml-lang="en-US" id="hd_id3153360" role="heading" level="1" l10n="U" oldref="1"><link href="text/scalc/01/02120100.xhp" name="Header/Footer">Header/Footer</link></paragraph> + <paragraph xml-lang="en-US" id="par_id3150768" role="paragraph" l10n="U" oldref="2"><ahelp hid="HID_SCPAGE_HFED_FL">Defines or formats a header or footer for a Page Style.</ahelp></paragraph> + </section> + <section id="howtoget"> + <embed href="text/scalc/00/00000402.xhp#bkopfzeile"/> + </section> +<bookmark xml-lang="en-US" branch="hid/SC_HID_SC_HF_HRL" id="bm_id3156444" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/SC_HID_SC_HF_HLL" id="bm_id3152578" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/SC_HID_SC_HF_FRL" id="bm_id3155854" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/SC_HID_SC_HF_FLL" id="bm_id3153726" localize="false"/> +<paragraph xml-lang="en-US" id="hd_id3145748" role="heading" level="2" l10n="U" oldref="3">Left Area</paragraph> + <paragraph xml-lang="en-US" id="par_id3147434" role="paragraph" l10n="U" oldref="4"><ahelp hid="HID_SC_HF_FLL">Enter the text to be displayed at the left side of the header or footer.</ahelp></paragraph> +<bookmark xml-lang="en-US" branch="hid/SC_HID_SC_HF_HRC" id="bm_id3159153" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/SC_HID_SC_HF_HLC" id="bm_id3159156" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/SC_HID_SC_HF_FRC" id="bm_id3145273" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/SC_HID_SC_HF_FLC" id="bm_id3153951" localize="false"/> +<paragraph xml-lang="en-US" id="hd_id3148648" role="heading" level="2" l10n="U" oldref="5">Center Area</paragraph> + <paragraph xml-lang="en-US" id="par_id3163710" role="paragraph" l10n="CHG" oldref="6"><ahelp hid=".">Enter the text to be displayed at the center of the header or footer.</ahelp></paragraph> +<bookmark xml-lang="en-US" branch="hid/SC_HID_SC_HF_HRR" id="bm_id3153159" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/SC_HID_SC_HF_HLR" id="bm_id3149413" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/SC_HID_SC_HF_FRR" id="bm_id3148457" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/SC_HID_SC_HF_FLR" id="bm_id3155418" localize="false"/> +<paragraph xml-lang="en-US" id="hd_id3154942" role="heading" level="2" l10n="U" oldref="7">Right Area</paragraph> + <paragraph xml-lang="en-US" id="par_id3147126" role="paragraph" l10n="U" oldref="8"><ahelp hid="HID_SC_HF_FLR">Enter the text to be displayed at the right side of the header or footer.</ahelp></paragraph> +<bookmark xml-lang="en-US" branch="hid/SC_HID_SC_HF_HR_DEFINED" id="bm_id0609200910173918" localize="false"/> +<paragraph xml-lang="en-US" id="par_idN10811" role="heading" level="2" l10n="NEW">Header/Footer</paragraph> + <paragraph xml-lang="en-US" id="par_idN10815" role="paragraph" l10n="NEW"><ahelp hid=".">Select a predefined header or footer from the list.</ahelp></paragraph> +<bookmark xml-lang="en-US" branch="hid/SC_HID_SC_HF_TEXT" id="bm_id3144766" localize="false"/> +<paragraph xml-lang="en-US" id="hd_id3154729" role="heading" level="2" l10n="U" oldref="9">Text attributes</paragraph> + <paragraph xml-lang="en-US" id="par_id3150717" role="paragraph" l10n="U" oldref="10"><ahelp hid="HID_SC_HF_TEXT">Opens a dialog to assign formats to new or selected text.</ahelp> The <emph>Text Attributes </emph>dialog contains the tab pages <link href="text/shared/01/05020100.xhp" name="Font">Font</link>, <link href="text/shared/01/05020200.xhp" name="Font Effects">Font Effects</link> and <link href="text/shared/01/05020500.xhp" name="Font Position">Font Position</link>.</paragraph> + <table id="tbl_id3149018"> + <tablerow> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3159266" role="paragraph" l10n="E"> +<image id="img_id3156386" src="sc/res/text.png" width="0.1874in" height="0.1665in"><alt xml-lang="en-US" id="alt_id3156386">Icon</alt> + </image></paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3155336" role="paragraph" l10n="U" oldref="25">Text Attributes</paragraph> + </tablecell> + </tablerow> + </table> + +<bookmark xml-lang="en-US" branch="hid/SC_HID_SC_HF_FILE" id="bm_id3154020" localize="false"/> +<paragraph xml-lang="en-US" id="hd_id3145792" role="heading" level="2" l10n="U" + oldref="11">File Name </paragraph> + <paragraph xml-lang="en-US" id="par_id3150206" role="paragraph" l10n="CHG" oldref="12"><ahelp hid="HID_SC_HF_FILE">Inserts a file name placeholder in the selected area.</ahelp> Click to insert the title. Long-click <comment>UFI: this is still a long-click</comment>to select either title, file name or path/file name from the submenu. If a title has not be assigned (see <emph>File - Properties</emph>), the file name will be inserted instead.</paragraph> + <table id="tbl_id3149529"> + <tablerow> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3150369" role="paragraph" l10n="E"> +<image id="img_id3150518" src="res/folderop.png" width="0.1665in" height="0.1252in"><alt xml-lang="en-US" id="alt_id3150518">Icon</alt> + </image></paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3154487" role="paragraph" l10n="U" oldref="26">File Name</paragraph> + </tablecell> + </tablerow> + </table> + +<bookmark xml-lang="en-US" branch="hid/SC_HID_SC_HF_TABLE" id="bm_id3149408" localize="false"/> +<paragraph xml-lang="en-US" id="hd_id3155812" role="heading" level="2" l10n="U" + oldref="13">Sheet Name</paragraph> + <paragraph xml-lang="en-US" id="par_id3148842" role="paragraph" l10n="U" oldref="14"><ahelp hid="HID_SC_HF_TABLE">Inserts a placeholder in the selected header/footer area, which is replaced by the sheet name in the header/footer of the actual document.</ahelp></paragraph> + <table id="tbl_id3159174"> + <tablerow> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3146870" role="paragraph" l10n="E"> +<image id="img_id3148870" src="sc/res/table.png" width="0.2228in" height="0.2228in"><alt xml-lang="en-US" id="alt_id3148870">Icon</alt> + </image></paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3147071" role="paragraph" l10n="U" oldref="27">Sheet Name</paragraph> + </tablecell> + </tablerow> + </table> + +<bookmark xml-lang="en-US" branch="hid/SC_HID_SC_HF_PAGE" id="bm_id3153288" localize="false"/> +<paragraph xml-lang="en-US" id="hd_id3144768" role="heading" level="2" l10n="U" + oldref="15">Page</paragraph> + <paragraph xml-lang="en-US" id="par_id3154960" role="paragraph" l10n="U" oldref="16"><ahelp hid="HID_SC_HF_PAGE">Inserts a placeholder in the selected header/footer area, which is replaced by page numbering. This allows continuous page numbering in a document.</ahelp></paragraph> + <table id="tbl_id3153246"> + <tablerow> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3151304" role="paragraph" l10n="E"> +<image id="img_id3155386" src="sc/res/page.png" width="0.2228in" height="0.2228in"><alt xml-lang="en-US" id="alt_id3155386">Icon</alt> + </image></paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3150048" role="paragraph" l10n="U" oldref="28">Page</paragraph> + </tablecell> + </tablerow> + </table> + +<bookmark xml-lang="en-US" branch="hid/SC_HID_SC_HF_PAGES" id="bm_id3153012" localize="false"/> +<paragraph xml-lang="en-US" id="hd_id3146962" role="heading" level="2" l10n="U" + oldref="17">Pages</paragraph> + <paragraph xml-lang="en-US" id="par_id3153812" role="paragraph" l10n="U" oldref="18"><ahelp hid="HID_SC_HF_PAGES">Inserts a placeholder in the selected header/footer area, which is replaced by the total number of pages in the document.</ahelp></paragraph> + <table id="tbl_id3154737"> + <tablerow> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3149315" role="paragraph" l10n="E"> +<image id="img_id3155757" src="sc/res/pages.png" width="0.2228in" height="0.2228in"><alt xml-lang="en-US" id="alt_id3155757">Icon</alt> + </image></paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3147499" role="paragraph" l10n="U" oldref="29">Pages</paragraph> + </tablecell> + </tablerow> + </table> + +<bookmark xml-lang="en-US" branch="hid/SC_HID_SC_HF_DATE" id="bm_id3150438" localize="false"/> +<paragraph xml-lang="en-US" id="hd_id3149050" role="heading" level="2" l10n="U" + oldref="19">Date</paragraph> + <paragraph xml-lang="en-US" id="par_id3153960" role="paragraph" l10n="U" oldref="20"><ahelp hid="HID_SC_HF_DATE">Inserts a placeholder in the selected header/footer area, which is replaced by the current date which will be repeated in the header/footer on each page of the document.</ahelp></paragraph> + <table id="tbl_id3147406"> + <tablerow> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3147299" role="paragraph" l10n="E"> +<image id="img_id3150394" src="sc/res/date.png" width="0.2228in" height="0.2228in"><alt xml-lang="en-US" id="alt_id3150394">Icon</alt> + </image></paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3150540" role="paragraph" l10n="U" oldref="30">Date</paragraph> + </tablecell> + </tablerow> + </table> + +<bookmark xml-lang="en-US" branch="hid/SC_HID_SC_HF_TIME" id="bm_id3147412" localize="false"/> +<paragraph xml-lang="en-US" id="hd_id3147610" role="heading" level="2" l10n="U" + oldref="21">Time</paragraph> + <paragraph xml-lang="en-US" id="par_id3145638" role="paragraph" l10n="U" oldref="22"><ahelp hid="HID_SC_HF_TIME">Inserts a placeholder in the selected header/footer area, which is replaced by the current time in the header/footer on each page of the document.</ahelp></paragraph> + <table id="tbl_id3157875"> + <tablerow> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3153122" role="paragraph" l10n="E"> +<image id="img_id3146884" src="sc/res/time.png" width="0.2228in" height="0.2228in"><alt xml-lang="en-US" id="alt_id3146884">Icon</alt> + </image></paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3157904" role="paragraph" l10n="U" oldref="31">Time</paragraph> + </tablecell> + </tablerow> + </table> + + </body> +</helpdocument>
\ No newline at end of file diff --git a/source/text/scalc/01/02140000.xhp b/source/text/scalc/01/02140000.xhp new file mode 100644 index 0000000000..fb482cc712 --- /dev/null +++ b/source/text/scalc/01/02140000.xhp @@ -0,0 +1,78 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> + +<!-- +*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************ + --> + + +<meta> + <topic id="textscalc0102140000xml" indexer="include" status="PUBLISH"> + <title xml-lang="en-US" id="tit">Fill</title> + <filename>/text/scalc/01/02140000.xhp</filename> + </topic> + </meta> + <body> + <section id="ausfuellen"> +<bookmark xml-lang="en-US" branch="hid/.uno:FillCellsMenu" id="bm_id2939237" localize="false"/> +<bookmark xml-lang="en-US" branch="index" id="bm_id8473769"><bookmark_value>filling;selection lists</bookmark_value> + <bookmark_value>selection lists;filling cells</bookmark_value> +</bookmark><comment>MW inserted 2 index entries</comment> +<paragraph xml-lang="en-US" id="hd_id3153876" role="heading" level="1" l10n="U" oldref="1"><link href="text/scalc/01/02140000.xhp" name="Fill">Fill</link></paragraph> + <paragraph xml-lang="en-US" id="par_id3156285" role="paragraph" l10n="CHG" oldref="2"><ahelp hid=".">Automatically fills cells with content.</ahelp></paragraph> + </section> + <section id="howtoget"> + <embed href="text/scalc/00/00000402.xhp#bausfullen"/> + </section> + <paragraph xml-lang="en-US" id="par_id3147343" role="note" l10n="CHG" oldref="9">The $[officename] Calc context menus have <link href="text/scalc/01/02140000.xhp" name="other options">additional options</link> for filling the cells.</paragraph> + <embed href="text/scalc/01/02140100.xhp#unten"/> + <embed href="text/scalc/01/02140200.xhp#rechts"/> + <embed href="text/scalc/01/02140300.xhp#oben"/> + <embed href="text/scalc/01/02140400.xhp#links"/> + <paragraph xml-lang="en-US" id="hd_id3149207" role="heading" level="2" l10n="U" oldref="7"><link href="text/scalc/01/02140500.xhp" name="Sheet">Sheet</link></paragraph> + <embed href="text/scalc/01/02140500.xhp#tabellenfuellentext"/> + <paragraph xml-lang="en-US" id="hd_id3155111" role="heading" level="2" l10n="U" oldref="8"><link href="text/scalc/01/02140600.xhp" name="Rows">Series</link></paragraph> + <embed href="text/scalc/01/02140600.xhp#reihenfuellentext"/> + <paragraph xml-lang="en-US" id="par_id3152994" role="paragraph" l10n="U" oldref="3"> +<emph>Filling cells using context menus:</emph> +</paragraph> + <list type="unordered"> + <listitem> + <paragraph xml-lang="en-US" id="par_id3145384" role="listitem" l10n="U" oldref="4">Call the <link href="text/shared/00/00000005.xhp#kontextmenue" name="context menu">context menu</link> when positioned in a cell and choose <emph>Selection List</emph>.</paragraph> + </listitem> + <listitem> +<bookmark xml-lang="en-US" branch="hid/.uno:DataSelect" id="bm_id4369249" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/.uno:DataSelect" id="bm_id3155810" localize="false"/> +<paragraph xml-lang="en-US" id="par_id3156450" role="listitem" l10n="U" oldref="5"><ahelp hid=".uno:DataSelect">A list box containing all text found in the current column is displayed.</ahelp> The text is sorted alphabetically and multiple entries are listed only once.</paragraph> + </listitem> + <listitem> + <paragraph xml-lang="en-US" id="par_id3148699" role="listitem" l10n="U" oldref="6">Click one of the listed entries to copy it to the cell.</paragraph> + </listitem> + </list> + </body> +</helpdocument>
\ No newline at end of file diff --git a/source/text/scalc/01/02140100.xhp b/source/text/scalc/01/02140100.xhp new file mode 100644 index 0000000000..74a0296bc3 --- /dev/null +++ b/source/text/scalc/01/02140100.xhp @@ -0,0 +1,53 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--><helpdocument version="1.0"> +<meta> +<topic id="textscalc0102140100xml" indexer="include" status="PUBLISH"> +<title xml-lang="en-US" id="tit">Down</title> +<filename>/text/scalc/01/02140100.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2003-10-31T00:00:00">converted from old format - fpe</lastedited> +</history> +</meta> +<body> + + + <section id="unten"> + <bookmark xml-lang="en-US" branch="hid/.uno:FillDown" id="bm_id8608585" localize="false"/><!-- HID added by script --> +<bookmark branch="hid/.uno:FillDown" xml-lang="en-US" id="bm_id3145173"/><paragraph id="hd_id3150792" role="heading" level="1" oldref="1" l10n="U" xml-lang="en-US"><link href="text/scalc/01/02140100.xhp" name="Down">Down</link></paragraph> + <paragraph l10n="U" role="paragraph" id="par_id3153969" xml-lang="en-US" oldref="2"><ahelp hid=".uno:FillDown" visibility="visible">Fills a selected range of at least two rows with the contents of the top cell of the range.</ahelp></paragraph> + </section> + <section id="howtoget"> + <embed href="text/scalc/00/00000402.xhp#bausunten"/> +</section> + <paragraph role="paragraph" id="par_id3145787" l10n="U" xml-lang="en-US" oldref="3">If a selected range has only one column, the contents of the top cell are copied to all others. If several columns are selected, the contents of the corresponding top cell will be copied down.</paragraph> + </body> +</helpdocument> diff --git a/source/text/scalc/01/02140200.xhp b/source/text/scalc/01/02140200.xhp new file mode 100644 index 0000000000..3e12e4e481 --- /dev/null +++ b/source/text/scalc/01/02140200.xhp @@ -0,0 +1,53 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--><helpdocument version="1.0"> +<meta> +<topic id="textscalc0102140200xml" indexer="include" status="PUBLISH"> +<title xml-lang="en-US" id="tit">Right</title> +<filename>/text/scalc/01/02140200.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2003-10-31T00:00:00">converted from old format - fpe</lastedited> +</history> +</meta> +<body> + + + <section id="rechts"> + <bookmark xml-lang="en-US" branch="hid/.uno:FillRight" id="bm_id9676564" localize="false"/><!-- HID added by script --> +<bookmark branch="hid/.uno:FillRight" xml-lang="en-US" id="bm_id3149456"/><paragraph id="hd_id3153896" role="heading" level="1" oldref="1" l10n="U" xml-lang="en-US"><link href="text/scalc/01/02140200.xhp" name="Right">Right</link></paragraph> + <paragraph l10n="U" role="paragraph" id="par_id3153361" xml-lang="en-US" oldref="2"><ahelp hid=".uno:FillRight" visibility="visible">Fills a selected range of at least two columns with the contents of the left most cell.</ahelp></paragraph> + </section> + <section id="howtoget"> + <embed href="text/scalc/00/00000402.xhp#bausrechts"/> +</section> + <paragraph role="paragraph" id="par_id3154684" l10n="U" xml-lang="en-US" oldref="3">If a range of only one row is selected, the contents of the far left cell are copied to all the other selected cells. If you have selected several rows, each of the far left cells is copied into those cells to the right.</paragraph> + </body> +</helpdocument> diff --git a/source/text/scalc/01/02140300.xhp b/source/text/scalc/01/02140300.xhp new file mode 100644 index 0000000000..354f340a99 --- /dev/null +++ b/source/text/scalc/01/02140300.xhp @@ -0,0 +1,53 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--><helpdocument version="1.0"> +<meta> +<topic id="textscalc0102140300xml" indexer="include" status="PUBLISH"> +<title xml-lang="en-US" id="tit">Up</title> +<filename>/text/scalc/01/02140300.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2003-10-31T00:00:00">converted from old format - fpe</lastedited> +</history> +</meta> +<body> + + + <section id="oben"> + <bookmark xml-lang="en-US" branch="hid/.uno:FillUp" id="bm_id8879597" localize="false"/><!-- HID added by script --> +<bookmark branch="hid/.uno:FillUp" xml-lang="en-US" id="bm_id3149456"/><paragraph id="hd_id3147264" role="heading" level="1" oldref="1" l10n="U" xml-lang="en-US"><link href="text/scalc/01/02140300.xhp" name="Up">Up</link></paragraph> + <paragraph l10n="U" role="paragraph" id="par_id3150793" xml-lang="en-US" oldref="2"><ahelp hid=".uno:FillUp" visibility="visible">Fills a selected range of at least two rows with the contents of the bottom most cell.</ahelp></paragraph> + </section> + <section id="howtoget"> + <embed href="text/scalc/00/00000402.xhp#bausoben"/> +</section> + <paragraph role="paragraph" id="par_id3150447" l10n="U" xml-lang="en-US" oldref="3">If a selected range has only one column, the content of the bottom most cell is copied into the selected cells. If several columns are selected, the contents of the bottom most cells are copied into those selected above.</paragraph> + </body> +</helpdocument> diff --git a/source/text/scalc/01/02140400.xhp b/source/text/scalc/01/02140400.xhp new file mode 100644 index 0000000000..95537323f5 --- /dev/null +++ b/source/text/scalc/01/02140400.xhp @@ -0,0 +1,53 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--><helpdocument version="1.0"> +<meta> +<topic id="textscalc0102140400xml" indexer="include" status="PUBLISH"> +<title xml-lang="en-US" id="tit">Left</title> +<filename>/text/scalc/01/02140400.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2003-10-31T00:00:00">converted from old format - fpe</lastedited> +</history> +</meta> +<body> + + + <section id="links"> + <bookmark xml-lang="en-US" branch="hid/.uno:FillLeft" id="bm_id3332954" localize="false"/><!-- HID added by script --> +<bookmark branch="hid/.uno:FillLeft" xml-lang="en-US" id="bm_id3149456"/><paragraph id="hd_id3153896" role="heading" level="1" oldref="1" l10n="U" xml-lang="en-US"><link href="text/scalc/01/02140400.xhp" name="Left">Left</link></paragraph> + <paragraph l10n="U" role="paragraph" id="par_id3150793" xml-lang="en-US" oldref="2"><ahelp hid=".uno:FillLeft" visibility="visible">Fills a selected range of at least two columns with the contents of the far right cell.</ahelp></paragraph> + </section> + <section id="howtoget"> + <embed href="text/scalc/00/00000402.xhp#bauslinks"/> +</section> + <paragraph role="paragraph" id="par_id3156280" l10n="U" xml-lang="en-US" oldref="3">If a selected range has only one row, the content of the far right cell is copied into all other cells of the range. If several rows are selected, the far right cells are copied into the cells to the left.</paragraph> + </body> +</helpdocument> diff --git a/source/text/scalc/01/02140500.xhp b/source/text/scalc/01/02140500.xhp new file mode 100644 index 0000000000..071232e6d1 --- /dev/null +++ b/source/text/scalc/01/02140500.xhp @@ -0,0 +1,64 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> +<helpdocument version="1.0"> +<meta> +<topic id="textscalc0102140500xml" indexer="include" status="PUBLISH"> +<title xml-lang="en-US" id="tit">Fill Sheet</title> +<filename>/text/scalc/01/02140500.xhp</filename> +</topic> +</meta> +<body> + + + <bookmark xml-lang="en-US" branch="hid/.uno:FillTable" id="bm_id3912388" localize="false"/><!-- HID added by script --> +<bookmark branch="hid/.uno:FillTable" xml-lang="en-US" id="bm_id3148664"/><paragraph role="heading" level="1" id="hd_id3153897" l10n="U" xml-lang="en-US" oldref="1">Fill Sheet</paragraph> + <paragraph l10n="CHG" role="paragraph" id="par_id3150791" xml-lang="en-US" oldref="2"><variable id="tabellenfuellentext"><ahelp hid=".uno:FillTable" visibility="visible">Specifies the options for transferring sheets or ranges of a certain sheet.</ahelp></variable></paragraph> + <section id="howtoget"> + <embed href="text/scalc/00/00000402.xhp#baustab"/> +</section> + <paragraph xml-lang="en-US" role="paragraph" id="par_id3150767" l10n="U" oldref="3">In contrast to copying an area to the clipboard, you can filter certain information and calculate values. This command is only visible if you have selected two sheets in the document. To select multiple sheets, click each sheet tab while pressing <switchinline select="sys"> <caseinline select="MAC">Command</caseinline> <defaultinline>Ctrl</defaultinline> </switchinline> or Shift.</paragraph> + <paragraph role="heading" level="2" id="hd_id3155131" l10n="CHG" xml-lang="en-US" oldref="4">Filling a Sheet</paragraph> + <list type="unordered"> + <listitem> + <paragraph role="listitem" id="par_id3146119" l10n="CHG" xml-lang="en-US" oldref="5">Select the entire sheet by clicking the empty gray box in the upper left of the sheet. You can also select an area of the sheet to be copied.</paragraph> + </listitem> + <listitem> + <paragraph xml-lang="en-US" role="listitem" id="par_id3153726" l10n="U" oldref="6">Press <switchinline select="sys"> <caseinline select="MAC">Command</caseinline><defaultinline>Ctrl</defaultinline></switchinline> and click the tab of the sheet where you want to insert the contents.</paragraph> + </listitem> + <listitem> + <paragraph xml-lang="en-US" oldref="7" l10n="U" role="listitem" id="par_id3147436">Select the command <emph>Edit - Fill - Sheet</emph>. In the dialog which appears, the check box <emph>Numbers</emph> must be selected (or <emph>Paste All</emph>) if you want to combine operations with the values. You can also choose the desired operation here.</paragraph> + </listitem> + <listitem> + <paragraph xml-lang="en-US" role="listitem" id="par_id3154942" l10n="U" oldref="8">Click <emph>OK</emph>.</paragraph> + </listitem> + </list> + <paragraph xml-lang="en-US" role="paragraph" id="par_id3156283" l10n="U" oldref="9">This dialog is similar to the <link href="text/shared/01/02070000.xhp" name="Paste Contents">Paste Contents</link> dialog, where you can find additional tips.</paragraph> + </body> +</helpdocument> diff --git a/source/text/scalc/01/02140600.xhp b/source/text/scalc/01/02140600.xhp new file mode 100644 index 0000000000..e5d3f7c432 --- /dev/null +++ b/source/text/scalc/01/02140600.xhp @@ -0,0 +1,109 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textscalc0102140600xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Fill Series</title> +<filename>/text/scalc/01/02140600.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2005-08-17T11:59:40">FPE: Inserted link for AutoFill</lastedited> +</history> +</meta> +<body> +<bookmark xml-lang="en-US" branch="hid/.uno:FillSeries" id="bm_id709198" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/.uno:FillSeries" id="bm_id3150791" localize="false"/> +<paragraph role="heading" id="hd_id3148664" xml-lang="en-US" level="1" l10n="U" oldref="1">Fill Series</paragraph> +<paragraph role="paragraph" id="par_id3148797" xml-lang="en-US" l10n="U" oldref="2"><variable id="reihenfuellentext"><ahelp hid=".uno:FillSeries">Automatically generate series with the options in this dialog. Determine direction, increment, time unit and series type.</ahelp> +</variable></paragraph> +<paragraph role="note" id="par_id3146976" xml-lang="en-US" l10n="U" oldref="41">Before filling a series, first select the cell range.</paragraph> +<section id="howtoget"> + <embed href="text/scalc/00/00000402.xhp#bausreihe"/> +</section> +<paragraph role="paragraph" id="par_id3145748" xml-lang="en-US" l10n="U" oldref="3">To automatically continue a series using the assumed completion rules, choose the <emph>AutoFill</emph> option after opening the <emph>Fill Series</emph> dialog.</paragraph> +<paragraph role="heading" id="hd_id3147435" xml-lang="en-US" level="2" l10n="U" oldref="4">Direction</paragraph> +<paragraph role="paragraph" id="par_id3154729" xml-lang="en-US" l10n="U" oldref="5">Determines the direction of series creation.</paragraph> +<bookmark xml-lang="en-US" branch="hid/sc:RadioButton:RID_SCDLG_FILLSERIES:BTN_BOTTOM" id="bm_id3147124" localize="false"/> +<paragraph role="heading" id="hd_id3145253" xml-lang="en-US" level="3" l10n="U" oldref="6">Down</paragraph> +<paragraph role="paragraph" id="par_id3155418" xml-lang="en-US" l10n="U" oldref="7"><ahelp hid="SC:RADIOBUTTON:RID_SCDLG_FILLSERIES:BTN_BOTTOM">Creates a downward series in the selected cell range for the column using the defined increment to the end value.</ahelp></paragraph> +<bookmark xml-lang="en-US" branch="hid/sc:RadioButton:RID_SCDLG_FILLSERIES:BTN_RIGHT" id="bm_id3153415" localize="false"/> +<paragraph role="heading" id="hd_id3155738" xml-lang="en-US" level="3" l10n="U" oldref="8">Right</paragraph> +<paragraph role="paragraph" id="par_id3149402" xml-lang="en-US" l10n="U" oldref="9"><ahelp hid="SC:RADIOBUTTON:RID_SCDLG_FILLSERIES:BTN_RIGHT">Creates a series running from left to right within the selected cell range using the defined increment to the end value.</ahelp></paragraph> +<bookmark xml-lang="en-US" branch="hid/sc:RadioButton:RID_SCDLG_FILLSERIES:BTN_TOP" id="bm_id3155067" localize="false"/> +<paragraph role="heading" id="hd_id3146972" xml-lang="en-US" level="3" l10n="U" oldref="10">Up</paragraph> +<paragraph role="paragraph" id="par_id3153711" xml-lang="en-US" l10n="U" oldref="11"><ahelp hid="SC:RADIOBUTTON:RID_SCDLG_FILLSERIES:BTN_TOP">Creates an upward series in the cell range of the column using the defined increment to the end value.</ahelp></paragraph> +<bookmark xml-lang="en-US" branch="hid/sc:RadioButton:RID_SCDLG_FILLSERIES:BTN_LEFT" id="bm_id3147341" localize="false"/> +<paragraph role="heading" id="hd_id3153764" xml-lang="en-US" level="3" l10n="U" oldref="12">Left</paragraph> +<paragraph role="paragraph" id="par_id3156382" xml-lang="en-US" l10n="U" oldref="13"><ahelp hid="SC:RADIOBUTTON:RID_SCDLG_FILLSERIES:BTN_LEFT">Creates a series running from right to left in the selected cell range using the defined increment to the end value.</ahelp></paragraph> +<paragraph role="heading" id="hd_id3147344" xml-lang="en-US" level="2" l10n="U" oldref="14">Series Type</paragraph> +<paragraph role="paragraph" id="par_id3149257" xml-lang="en-US" l10n="U" oldref="15">Defines the series type. Choose between <emph>Linear, Growth, Date </emph>and <emph>AutoFill</emph>.</paragraph> +<bookmark xml-lang="en-US" branch="hid/sc:RadioButton:RID_SCDLG_FILLSERIES:BTN_ARITHMETIC" id="bm_id3150298" localize="false"/> +<paragraph role="heading" id="hd_id3148488" xml-lang="en-US" level="3" l10n="U" oldref="16">Linear</paragraph> +<paragraph role="paragraph" id="par_id3159238" xml-lang="en-US" l10n="U" oldref="17"><ahelp hid="SC:RADIOBUTTON:RID_SCDLG_FILLSERIES:BTN_ARITHMETIC">Creates a linear number series using the defined increment and end value.</ahelp></paragraph> +<bookmark xml-lang="en-US" branch="hid/sc:RadioButton:RID_SCDLG_FILLSERIES:BTN_GEOMETRIC" id="bm_id3150784" localize="false"/> +<paragraph role="heading" id="hd_id3149210" xml-lang="en-US" level="3" l10n="U" oldref="18">Growth</paragraph> +<paragraph role="paragraph" id="par_id3150364" xml-lang="en-US" l10n="U" oldref="19"><ahelp hid="SC:RADIOBUTTON:RID_SCDLG_FILLSERIES:BTN_GEOMETRIC">Creates a growth series using the defined increment and end value.</ahelp></paragraph> +<bookmark xml-lang="en-US" branch="hid/sc:RadioButton:RID_SCDLG_FILLSERIES:BTN_DATE" id="bm_id3155378" localize="false"/> +<paragraph role="heading" id="hd_id3149528" xml-lang="en-US" level="3" l10n="U" oldref="20">Date</paragraph> +<paragraph role="paragraph" id="par_id3150887" xml-lang="en-US" l10n="U" oldref="21"><ahelp hid="SC:RADIOBUTTON:RID_SCDLG_FILLSERIES:BTN_DATE">Creates a date series using the defined increment and end date.</ahelp></paragraph> +<bookmark xml-lang="en-US" branch="hid/sc:RadioButton:RID_SCDLG_FILLSERIES:BTN_AUTOFILL" id="bm_id3152985" localize="false"/> +<paragraph role="heading" id="hd_id3150202" xml-lang="en-US" level="3" l10n="U" oldref="22">AutoFill</paragraph> +<paragraph role="paragraph" id="par_id3156288" xml-lang="en-US" l10n="U" oldref="23"><ahelp hid="SC:RADIOBUTTON:RID_SCDLG_FILLSERIES:BTN_AUTOFILL">Forms a series directly in the sheet.</ahelp> The AutoFill function takes account of customized lists. For example, by entering <emph>January</emph> in the first cell, the series is completed using the list defined under <emph><switchinline select="sys"><caseinline select="MAC">%PRODUCTNAME - Preferences</caseinline><defaultinline>Tools - Options</defaultinline></switchinline> - %PRODUCTNAME Calc - Sort Lists</emph>.</paragraph> +<paragraph role="paragraph" id="par_id3155811" xml-lang="en-US" l10n="U" oldref="24">AutoFill tries to complete a value series by using a defined pattern. The series 1,3,5 is automatically completed with 7,9,11,13, and so on. Date and time series are completed accordingly; for example, after 01.01.99 and 15.01.99, an interval of 14 days is used.</paragraph> +<paragraph role="paragraph" id="par_id2956483" xml-lang="en-US" l10n="NEW" localize="false"> +<embedvar href="text/scalc/guide/calc_series.xhp#calc_series"/> +</paragraph> +<paragraph role="heading" id="hd_id3148700" xml-lang="en-US" level="2" l10n="U" oldref="25">Unit of Time</paragraph> +<paragraph role="paragraph" id="par_id3153308" xml-lang="en-US" l10n="U" oldref="26">In this area you can specify the desired unit of time. This area is only active if the <emph>Date</emph> option has been chosen in the <emph>Series type</emph> area.</paragraph> +<bookmark xml-lang="en-US" branch="hid/sc:RadioButton:RID_SCDLG_FILLSERIES:BTN_DAY" id="bm_id3153913" localize="false"/> +<paragraph role="heading" id="hd_id3148868" xml-lang="en-US" level="3" l10n="U" oldref="27">Day</paragraph> +<paragraph role="paragraph" id="par_id3148605" xml-lang="en-US" l10n="U" oldref="28"><ahelp hid="SC:RADIOBUTTON:RID_SCDLG_FILLSERIES:BTN_DAY">Use the <emph>Date</emph> series type and this option to create a series using seven days.</ahelp></paragraph> +<bookmark xml-lang="en-US" branch="hid/sc:RadioButton:RID_SCDLG_FILLSERIES:BTN_DAY_OF_WEEK" id="bm_id3145074" localize="false"/> +<paragraph role="heading" id="hd_id3144771" xml-lang="en-US" level="3" l10n="U" oldref="29">Weekday</paragraph> +<paragraph role="paragraph" id="par_id3150108" xml-lang="en-US" l10n="U" oldref="30"><ahelp hid="SC:RADIOBUTTON:RID_SCDLG_FILLSERIES:BTN_DAY_OF_WEEK">Use the <emph>Date</emph> series type and this option to create a series of five day sets.</ahelp></paragraph> +<bookmark xml-lang="en-US" branch="hid/sc:RadioButton:RID_SCDLG_FILLSERIES:BTN_MONTH" id="bm_id3159204" localize="false"/> +<paragraph role="heading" id="hd_id3154957" xml-lang="en-US" level="3" l10n="U" oldref="31">Month</paragraph> +<paragraph role="paragraph" id="par_id3149126" xml-lang="en-US" l10n="U" oldref="32"><ahelp hid="SC:RADIOBUTTON:RID_SCDLG_FILLSERIES:BTN_MONTH">Use the <emph>Date</emph> series type and this option to form a series from the names or abbreviations of the months.</ahelp></paragraph> +<bookmark xml-lang="en-US" branch="hid/sc:RadioButton:RID_SCDLG_FILLSERIES:BTN_YEAR" id="bm_id3146777" localize="false"/> +<paragraph role="heading" id="hd_id3152870" xml-lang="en-US" level="3" l10n="U" oldref="33">Year</paragraph> +<paragraph role="paragraph" id="par_id3151300" xml-lang="en-US" l10n="U" oldref="34"><ahelp hid="SC:RADIOBUTTON:RID_SCDLG_FILLSERIES:BTN_YEAR">Use the <emph>Date</emph> series type and this option to create a series of years.</ahelp></paragraph> +<bookmark xml-lang="en-US" branch="hid/sc:Edit:RID_SCDLG_FILLSERIES:ED_START_VALUES" id="bm_id3145357" localize="false"/> +<paragraph role="heading" id="hd_id3154762" xml-lang="en-US" level="2" l10n="U" oldref="35">Start Value</paragraph> +<paragraph role="paragraph" id="par_id3149381" xml-lang="en-US" l10n="U" oldref="36"><ahelp hid="SC:EDIT:RID_SCDLG_FILLSERIES:ED_START_VALUES">Determines the start value for the series.</ahelp> Use numbers, dates or times.</paragraph> +<bookmark xml-lang="en-US" branch="hid/sc:Edit:RID_SCDLG_FILLSERIES:ED_END_VALUES" id="bm_id3153557" localize="false"/> +<paragraph role="heading" id="hd_id3153013" xml-lang="en-US" level="2" l10n="U" oldref="37">End Value</paragraph> +<paragraph role="paragraph" id="par_id3153487" xml-lang="en-US" l10n="U" oldref="38"><ahelp hid="SC:EDIT:RID_SCDLG_FILLSERIES:ED_END_VALUES">Determines the end value for the series.</ahelp> Use numbers, dates or times.</paragraph> +<bookmark xml-lang="en-US" branch="hid/sc:Edit:RID_SCDLG_FILLSERIES:ED_INCREMENT" id="bm_id3151196" localize="false"/> +<paragraph role="heading" id="hd_id3149312" xml-lang="en-US" level="2" l10n="U" oldref="39">Increment</paragraph> +<paragraph role="paragraph" id="par_id3154739" xml-lang="en-US" l10n="U" oldref="40">The term "increment" denotes the amount by which a given value increases.<ahelp hid="SC:EDIT:RID_SCDLG_FILLSERIES:ED_INCREMENT"> Determines the value by which the series of the selected type increases by each step.</ahelp> Entries can only be made if the linear, growth or date series types have been selected.</paragraph> +</body> +</helpdocument> diff --git a/source/text/scalc/01/02150000.xhp b/source/text/scalc/01/02150000.xhp new file mode 100644 index 0000000000..6f1bc4e4fa --- /dev/null +++ b/source/text/scalc/01/02150000.xhp @@ -0,0 +1,77 @@ +<?xml version="1.0" encoding="UTF-8"?> + + + +<!-- + *********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************ + --> + + + <helpdocument version="1.0"> +<meta> +<topic id="textscalc0102150000xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Deleting Contents</title> +<filename>/text/scalc/01/02150000.xhp</filename> +</topic> +</meta> +<body> +<bookmark xml-lang="en-US" branch="index" id="bm_id3143284"><bookmark_value>deleting; cell contents</bookmark_value> +<bookmark_value>cells; deleting contents</bookmark_value> +<bookmark_value>spreadsheets; deleting cell contents</bookmark_value> +<bookmark_value>cell contents; deleting</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/.uno:Delete" id="bm_id5511579" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/.uno:Delete" id="bm_id3145382" localize="false"/><paragraph role="heading" id="hd_id3143284" xml-lang="en-US" level="1" l10n="U" oldref="1">Deleting Contents</paragraph> +<paragraph role="paragraph" id="par_id3149456" xml-lang="en-US" l10n="CHG" oldref="2"><variable id="inhalteloeschentext"><ahelp hid=".uno:Delete">Specifies the contents to be deleted from the active cell or from a selected cell range.</ahelp> +</variable> If several sheets are selected, all selected sheets will be affected.</paragraph> +<section id="howtoget"> + <embed href="text/scalc/00/00000402.xhp#binhalt"/> +</section> +<paragraph role="tip" id="par_id3159154" xml-lang="en-US" l10n="U" oldref="21">This dialog is also called by pressing Backspace after the cell cursor has been activated on the sheet.</paragraph> +<paragraph role="tip" id="par_id3145367" xml-lang="en-US" l10n="U" oldref="22">Pressing Delete deletes content without calling the dialog or changing formats.</paragraph> +<paragraph role="tip" id="par_id3153951" xml-lang="en-US" l10n="U" oldref="23">Use <emph>Cut</emph> on the Standard bar to delete contents and formats without the dialog.</paragraph> +<paragraph role="heading" id="hd_id3148575" xml-lang="en-US" level="2" l10n="U" oldref="3">Selection</paragraph> +<paragraph role="paragraph" id="par_id3149665" xml-lang="en-US" l10n="U" oldref="4">This area lists the options for deleting contents.</paragraph> +<bookmark xml-lang="en-US" branch="hid/sc:CheckBox:RID_SCDLG_DELCONT:BTN_DELALL" id="bm_id3144766" localize="false"/><paragraph role="heading" id="hd_id3146975" xml-lang="en-US" level="3" l10n="U" oldref="5">Delete All</paragraph> +<paragraph role="paragraph" id="par_id3154729" xml-lang="en-US" l10n="U" oldref="6"><ahelp hid="SC_CHECKBOX_RID_SCDLG_DELCONT_BTN_DELALL">Deletes all content from the selected cell range.</ahelp></paragraph> +<bookmark xml-lang="en-US" branch="hid/sc:CheckBox:RID_SCDLG_DELCONT:BTN_DELSTRINGS" id="bm_id3147394" localize="false"/><paragraph role="heading" id="hd_id3156286" xml-lang="en-US" level="3" l10n="CHG" oldref="7">Text<comment>i50439</comment></paragraph> +<paragraph role="paragraph" id="par_id3154015" xml-lang="en-US" l10n="CHG" oldref="8"><ahelp hid="SC_CHECKBOX_RID_SCDLG_DELCONT_BTN_DELSTRINGS">Deletes text only. Formats, formulas, numbers and dates are not affected.</ahelp></paragraph> +<bookmark xml-lang="en-US" branch="hid/sc:CheckBox:RID_SCDLG_DELCONT:BTN_DELNUMBERS" id="bm_id3156276" localize="false"/><paragraph role="heading" id="hd_id3153840" xml-lang="en-US" level="3" l10n="U" oldref="9">Numbers</paragraph> +<paragraph role="paragraph" id="par_id3148405" xml-lang="en-US" l10n="U" oldref="10"><ahelp hid="SC_CHECKBOX_RID_SCDLG_DELCONT_BTN_DELNUMBERS">Deletes numbers only. Formats and formulas remain unchanged.</ahelp></paragraph> +<bookmark xml-lang="en-US" branch="hid/sc:CheckBox:RID_SCDLG_DELCONT:BTN_DELDATETIME" id="bm_id3154757" localize="false"/><paragraph role="heading" id="hd_id3155764" xml-lang="en-US" level="3" l10n="U" oldref="11">Date & time</paragraph> +<paragraph role="paragraph" id="par_id3149567" xml-lang="en-US" l10n="U" oldref="12"><ahelp hid="SC_CHECKBOX_RID_SCDLG_DELCONT_BTN_DELDATETIME">Deletes date and time values. Formats, text, numbers and formulas remain unchanged.</ahelp></paragraph> +<bookmark xml-lang="en-US" branch="hid/sc:CheckBox:RID_SCDLG_DELCONT:BTN_DELFORMULAS" id="bm_id3149256" localize="false"/><paragraph role="heading" id="hd_id3154703" xml-lang="en-US" level="3" l10n="U" oldref="13">Formulas</paragraph> +<paragraph role="paragraph" id="par_id3148485" xml-lang="en-US" l10n="U" oldref="14"><ahelp hid="SC_CHECKBOX_RID_SCDLG_DELCONT_BTN_DELFORMULAS">Deletes formulas. Text, numbers, formats, dates and times remain unchanged.</ahelp></paragraph> +<bookmark xml-lang="en-US" branch="hid/sc:CheckBox:RID_SCDLG_DELCONT:BTN_DELNOTES" id="bm_id3152775" localize="false"/><paragraph role="heading" id="hd_id3150300" xml-lang="en-US" level="3" l10n="U" oldref="15">Comments</paragraph> +<paragraph role="paragraph" id="par_id3154658" xml-lang="en-US" l10n="U" oldref="16"><ahelp hid="SC_CHECKBOX_RID_SCDLG_DELCONT_BTN_DELNOTES">Deletes comments added to cells. All other elements remain unchanged.</ahelp></paragraph> +<bookmark xml-lang="en-US" branch="hid/sc:CheckBox:RID_SCDLG_DELCONT:BTN_DELATTRS" id="bm_id3145258" localize="false"/><paragraph role="heading" id="hd_id3155112" xml-lang="en-US" level="3" l10n="U" oldref="17">Formats</paragraph> +<paragraph role="paragraph" id="par_id3146134" xml-lang="en-US" l10n="U" oldref="18"><ahelp hid="SC_CHECKBOX_RID_SCDLG_DELCONT_BTN_DELATTRS">Deletes format attributes applied to cells. All cell content remains unchanged.</ahelp></paragraph> +<bookmark xml-lang="en-US" branch="hid/sc:CheckBox:RID_SCDLG_DELCONT:BTN_DELOBJECTS" id="bm_id3152582" localize="false"/><paragraph role="heading" id="hd_id3150088" xml-lang="en-US" level="3" l10n="U" oldref="19">Objects</paragraph> +<paragraph role="paragraph" id="par_id3152990" xml-lang="en-US" l10n="U" oldref="20"><ahelp hid="SC_CHECKBOX_RID_SCDLG_DELCONT_BTN_DELOBJECTS">Deletes objects. All cell content remains unchanged.</ahelp></paragraph> +</body> +</helpdocument> diff --git a/source/text/scalc/01/02160000.xhp b/source/text/scalc/01/02160000.xhp new file mode 100644 index 0000000000..4bf43a8150 --- /dev/null +++ b/source/text/scalc/01/02160000.xhp @@ -0,0 +1,89 @@ +<?xml version="1.0" encoding="UTF-8"?> + + + +<!-- + *********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************ + --> + + + <helpdocument version="1.0"> +<meta> +<topic id="textscalc0102160000xml" indexer="include" status="PUBLISH"> +<title xml-lang="en-US" id="tit">Delete Cells</title> +<filename>/text/scalc/01/02160000.xhp</filename> +</topic> +</meta> +<body> + + + +<bookmark xml-lang="en-US" branch="index" id="bm_id3153726"><bookmark_value>cells; deleting cells</bookmark_value> +<bookmark_value>columns; deleting</bookmark_value> +<bookmark_value>rows; deleting</bookmark_value> +<bookmark_value>spreadsheets; deleting cells</bookmark_value> +<bookmark_value>deleting;cells/rows/columns</bookmark_value> +</bookmark> + <comment>MW made one "deleting;" entry out of 3</comment> + +<bookmark xml-lang="en-US" branch="hid/.uno:DeleteCell" id="bm_id3151115" localize="false"/> + <paragraph xml-lang="en-US" id="hd_id3153726" role="heading" level="1" l10n="U" oldref="1">Delete Cells</paragraph> + <paragraph xml-lang="en-US" id="par_id3154490" role="paragraph" l10n="U" oldref="2"><variable id="zellenloeschentext"><ahelp hid=".uno:DeleteCell">Completely deletes selected cells, columns or rows. The cells below or to the right of the deleted cells will fill the space.</ahelp> +</variable> Note that the selected delete option is stored and reloaded when the dialog is next called.</paragraph> + <section id="howtoget"> + + <embed href="text/scalc/00/00000402.xhp#bzelo"/> + + </section> + <paragraph xml-lang="en-US" id="hd_id3149121" role="heading" level="2" l10n="U" oldref="3">Selection</paragraph> + <paragraph xml-lang="en-US" id="par_id3150751" role="paragraph" l10n="U" oldref="4">This area contains options for specifying how sheets are displayed after deleting cells.</paragraph> + +<bookmark xml-lang="en-US" branch="hid/sc:RadioButton:RID_SCDLG_DELCELL:BTN_CELLSUP" id="bm_id3154755" localize="false"/> + <paragraph xml-lang="en-US" id="hd_id3155767" role="heading" level="3" l10n="U" oldref="5">Shift cells up</paragraph> + <paragraph xml-lang="en-US" id="par_id3153714" role="paragraph" l10n="U" oldref="6"><ahelp hid="SC:RADIOBUTTON:RID_SCDLG_DELCELL:BTN_CELLSUP">Fills the space produced by the deleted cells with the cells underneath it.</ahelp></paragraph> + +<bookmark xml-lang="en-US" branch="hid/sc:RadioButton:RID_SCDLG_DELCELL:BTN_CELLSLEFT" id="bm_id3147346" localize="false"/> + <paragraph xml-lang="en-US" id="hd_id3156382" role="heading" level="3" l10n="U" oldref="7">Shift cells left</paragraph> + <paragraph xml-lang="en-US" id="par_id3154702" role="paragraph" l10n="U" oldref="8"><ahelp hid="SC:RADIOBUTTON:RID_SCDLG_DELCELL:BTN_CELLSLEFT">Fills the resulting space by the cells to the right of the deleted cells.</ahelp></paragraph> + +<bookmark xml-lang="en-US" branch="hid/sc:RadioButton:RID_SCDLG_DELCELL:BTN_DELROWS" id="bm_id3149566" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/.uno:DeleteRows" id="bm_id3149565" localize="false"/> + <paragraph xml-lang="en-US" id="hd_id3146918" role="heading" level="3" l10n="U" oldref="9">Delete entire row(s)</paragraph> + <paragraph xml-lang="en-US" id="par_id3148487" role="paragraph" l10n="U" oldref="10"><ahelp hid=".uno:DeleteRows">After selecting at least one cell, deletes the entire row from the sheet.</ahelp></paragraph> + +<bookmark xml-lang="en-US" branch="hid/sc:RadioButton:RID_SCDLG_DELCELL:BTN_DELCOLS" id="bm_id3150342" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/.uno:DeleteColumns" id="bm_id3159240" localize="false"/> + <paragraph xml-lang="en-US" id="hd_id3155114" role="heading" level="3" l10n="U" oldref="11">Delete entire column(s)</paragraph> + <paragraph xml-lang="en-US" id="par_id3150086" role="paragraph" l10n="U" oldref="12"><ahelp hid=".uno:DeleteColumns">After selecting at least one cell, deletes the entire column from the sheet.</ahelp></paragraph> + <section id="relatedtopics"> + + <paragraph xml-lang="en-US" id="par_id3166424" role="paragraph" l10n="CHG"><link href="text/scalc/01/02150000.xhp" name="Deleting Contents">Deleting Contents</link></paragraph> + + </section> + </body> +</helpdocument> diff --git a/source/text/scalc/01/02170000.xhp b/source/text/scalc/01/02170000.xhp new file mode 100644 index 0000000000..0ebfb372ff --- /dev/null +++ b/source/text/scalc/01/02170000.xhp @@ -0,0 +1,62 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textscalc0102170000xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Delete Sheet</title> +<filename>/text/scalc/01/02170000.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2004-09-27T11:19:29">converted from old format - fpe +YJ: checked</lastedited> +</history> +</meta> +<body> +<bookmark xml-lang="en-US" branch="index" id="bm_id3156424"><bookmark_value>spreadsheets; deleting</bookmark_value> +<bookmark_value>sheets; deleting</bookmark_value> +<bookmark_value>deleting; spreadsheets</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/.uno:Remove" id="bm_id7030283" localize="false"/><!-- HID added by script --> +<bookmark xml-lang="en-US" branch="hid/.uno:Remove" id="bm_id3150769" localize="false"/> +<paragraph role="heading" id="hd_id3156424" xml-lang="en-US" level="1" l10n="U" oldref="1"> Delete Sheet</paragraph> +<paragraph role="paragraph" id="par_id3153193" xml-lang="en-US" l10n="U" oldref="2"><variable id="tabelleloeschentext"><ahelp hid=".uno:Remove">Deletes the current sheet after query confirmation.</ahelp> +</variable></paragraph> +<section id="howtoget"> + <embed href="text/scalc/00/00000402.xhp#btaloes"/> +</section> +<paragraph role="note" id="par_id3145801" xml-lang="en-US" l10n="CHG" oldref="7">You cannot delete a sheet while <emph>Edit - Changes - Record</emph> is activated.</paragraph> +<paragraph role="heading" id="hd_id3147124" xml-lang="en-US" level="2" l10n="U" oldref="3">Yes</paragraph> +<paragraph role="paragraph" id="par_id3154943" xml-lang="en-US" l10n="U" oldref="4">Deletes the current sheet.</paragraph> +<paragraph role="heading" id="hd_id3149412" xml-lang="en-US" level="2" l10n="U" oldref="5">No</paragraph> +<paragraph role="paragraph" id="par_id3154510" xml-lang="en-US" l10n="U" oldref="6">Cancels the dialog. No delete is performed.</paragraph> +</body> +</helpdocument> diff --git a/source/text/scalc/01/02180000.xhp b/source/text/scalc/01/02180000.xhp new file mode 100644 index 0000000000..d2d15b538f --- /dev/null +++ b/source/text/scalc/01/02180000.xhp @@ -0,0 +1,69 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!-- + *********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************ + --> + +<helpdocument version="1.0"> +<meta> +<topic id="textscalc0102180000xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Move or Copy a Sheet</title> +<filename>/text/scalc/01/02180000.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2006-02-16T15:25:21">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<bookmark xml-lang="en-US" branch="index" id="bm_id3153360"><bookmark_value>spreadsheets; moving</bookmark_value> +<bookmark_value>spreadsheets; copying</bookmark_value> +<bookmark_value>moving; spreadsheets</bookmark_value> +<bookmark_value>copying; spreadsheets</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/.uno:Move" id="bm_id9622978" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/.uno:Move" id="bm_id3149657" localize="false"/> +<paragraph role="heading" id="hd_id3153360" xml-lang="en-US" level="1" l10n="U" oldref="1">Move or Copy a Sheet</paragraph> +<paragraph role="paragraph" id="par_id3154686" xml-lang="en-US" l10n="U" oldref="2"><variable id="tabelleverschiebenkopierentext"><ahelp hid=".uno:Move">Moves or copies a sheet to a new location in the document or to a different document.</ahelp> +</variable></paragraph> +<section id="howtoget"> + <embed href="text/scalc/00/00000402.xhp#btaverko"/> +</section> +<paragraph role="warning" id="par_id2282479" xml-lang="en-US" l10n="NEW">When you copy and paste cells containing <link href="text/scalc/01/04060102.xhp">date values</link> between different spreadsheets, both spreadsheet documents must be set to the same date base. If date bases differ, the displayed date values will change!</paragraph> +<bookmark xml-lang="en-US" branch="hid/sc:ListBox:RID_SCDLG_MOVETAB:LB_DEST" id="bm_id3146119" localize="false"/> +<paragraph role="heading" id="hd_id3163710" xml-lang="en-US" level="2" l10n="U" oldref="3">To Document</paragraph> +<paragraph role="paragraph" id="par_id3148645" xml-lang="en-US" l10n="U" oldref="4"><ahelp hid="SC:LISTBOX:RID_SCDLG_MOVETAB:LB_DEST">Indicates where the current sheet is to be moved or copied to.</ahelp> Select <emph>- new document -</emph> if you want to create a new location for the sheet to be moved or copied.</paragraph> +<bookmark xml-lang="en-US" branch="hid/sc:ListBox:RID_SCDLG_MOVETAB:LB_INSERT" id="bm_id3147350" localize="false"/> +<paragraph role="heading" id="hd_id3154012" xml-lang="en-US" level="2" l10n="U" oldref="5">Insert Before</paragraph> +<paragraph role="paragraph" id="par_id3145366" xml-lang="en-US" l10n="U" oldref="6"><ahelp hid="SC:LISTBOX:RID_SCDLG_MOVETAB:LB_INSERT">The current sheet is moved or copied in front of the selected sheet.</ahelp> The <emph>- move to end position -</emph> option places the current sheet at the end.</paragraph> +<bookmark xml-lang="en-US" branch="hid/sc:CheckBox:RID_SCDLG_MOVETAB:BTN_COPY" id="bm_id3156283" localize="false"/> +<paragraph role="heading" id="hd_id3153726" xml-lang="en-US" level="2" l10n="U" oldref="7">Copy</paragraph> +<paragraph role="paragraph" id="par_id3144764" xml-lang="en-US" l10n="U" oldref="8"><ahelp hid="SC:CHECKBOX:RID_SCDLG_MOVETAB:BTN_COPY">Specifies that the sheet is to be copied. If the option is unmarked, the sheet is moved.</ahelp> Moving sheets is the default.</paragraph> +</body> +</helpdocument> diff --git a/source/text/scalc/01/02190000.xhp b/source/text/scalc/01/02190000.xhp new file mode 100644 index 0000000000..b3adc19a43 --- /dev/null +++ b/source/text/scalc/01/02190000.xhp @@ -0,0 +1,54 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textscalc0102190000xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Delete Manual Breaks</title> +<filename>/text/scalc/01/02190000.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2004-12-17T13:39:23">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="manuellen"> +<bookmark xml-lang="en-US" branch="hid/.uno:DelBreakMenu" id="bm_id8417004" localize="false"/> +<paragraph role="heading" id="hd_id3150541" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/scalc/01/02190000.xhp" name="Delete Manual Breaks">Delete Manual Break</link></paragraph> +<paragraph role="paragraph" id="par_id3154365" xml-lang="en-US" l10n="CHG" oldref="2"><ahelp hid=".">Choose the type of manual break that you want to delete.</ahelp></paragraph> +</section> +<section id="howtoget"> + <embed href="text/scalc/00/00000402.xhp#bmaumloe"/> +</section> +<embed href="text/scalc/01/02190100.xhp#zeilenumbruch"/> +<embed href="text/scalc/01/02190200.xhp#spaltenumbruch"/> +</body> +</helpdocument> diff --git a/source/text/scalc/01/02190100.xhp b/source/text/scalc/01/02190100.xhp new file mode 100644 index 0000000000..7192f13503 --- /dev/null +++ b/source/text/scalc/01/02190100.xhp @@ -0,0 +1,60 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!-- + *********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************ + --> + +<helpdocument version="1.0"> +<meta> +<topic id="textscalc0102190100xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Row Break</title> +<filename>/text/scalc/01/02190100.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2006-11-28T09:18:03">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="zeilenumbruch"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3156326"><bookmark_value>spreadsheets; deleting row breaks</bookmark_value> +<bookmark_value>deleting;manual row breaks</bookmark_value> +<bookmark_value>row breaks; deleting</bookmark_value> +</bookmark><comment>MW deleted "removing;..." and changed "deleting;...!</comment> +<bookmark xml-lang="en-US" branch="hid/.uno:DeleteRowbreak" id="bm_id6936520" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/.uno:DeleteRowbreak" id="bm_id3151384" localize="false"/> +<paragraph role="heading" id="hd_id3156326" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/scalc/01/02190100.xhp" name="Row Break">Row Break</link></paragraph> +<paragraph role="paragraph" id="par_id3154366" xml-lang="en-US" l10n="U" oldref="2"><ahelp hid=".uno:DeleteRowbreak">Removes the manual row break above the active cell.</ahelp></paragraph> +</section> +<paragraph role="paragraph" id="par_id3151041" xml-lang="en-US" l10n="U" oldref="3">Position the cursor in a cell directly below the row break indicated by a horizontal line and choose <emph>Edit - Delete Manual Break - Row Break</emph>. The manual row break is removed.</paragraph> +<section id="howtoget"> + <embed href="text/scalc/00/00000402.xhp#bzeilum"/> +</section> +</body> +</helpdocument> diff --git a/source/text/scalc/01/02190200.xhp b/source/text/scalc/01/02190200.xhp new file mode 100644 index 0000000000..0318ff6150 --- /dev/null +++ b/source/text/scalc/01/02190200.xhp @@ -0,0 +1,68 @@ +<?xml version="1.0" encoding="UTF-8"?> + + + +<!-- + *********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************ + --> + + + <helpdocument version="1.0"> +<meta> +<topic id="textscalc0102190200xml" indexer="include" status="PUBLISH"> +<title xml-lang="en-US" id="tit">Column Break</title> +<filename>/text/scalc/01/02190200.xhp</filename> +</topic> +</meta> +<body> + + + <section id="spaltenumbruch"> + + +<bookmark xml-lang="en-US" branch="index" id="bm_id3151384"><bookmark_value>spreadsheets;deleting column breaks</bookmark_value> +<bookmark_value>deleting;manual column breaks</bookmark_value> +<bookmark_value>column breaks;deleting</bookmark_value> +</bookmark> + <comment>MW deleted "removing;" and changed "deleting;"</comment> + +<bookmark xml-lang="en-US" branch="hid/.uno:DeleteColumnbreak" id="bm_id2513425" localize="false"/> + +<bookmark xml-lang="en-US" branch="hid/.uno:DeleteColumnbreak" id="bm_id3154758" localize="false"/> + <paragraph xml-lang="en-US" id="hd_id3151384" role="heading" level="1" l10n="U" oldref="1"><link href="text/scalc/01/02190200.xhp" name="Column Break">Column Break</link></paragraph> + <paragraph xml-lang="en-US" id="par_id3154124" role="paragraph" l10n="U" oldref="2"><ahelp hid=".uno:DeleteColumnbreak">Removes a manual column break to the left of the active cell.</ahelp></paragraph> + + </section> + <paragraph xml-lang="en-US" id="par_id3145173" role="paragraph" l10n="U" oldref="3">Position the cursor in the cell to the right of the column break indicated by a vertical line and choose <emph>Edit - Delete Manual Break - Column Break</emph>. The manual column break is removed.</paragraph> + <section id="howtoget"> + + <embed href="text/scalc/00/00000402.xhp#bspaum"/> + + </section> + </body> +</helpdocument> diff --git a/source/text/scalc/01/02200000.xhp b/source/text/scalc/01/02200000.xhp new file mode 100644 index 0000000000..a33e5cdab1 --- /dev/null +++ b/source/text/scalc/01/02200000.xhp @@ -0,0 +1,53 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textscalc0102200000xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Sheet</title> +<filename>/text/scalc/01/02200000.xhp</filename> +</topic> +</meta> +<body> +<section id="tabellen"> +<bookmark xml-lang="en-US" branch="hid/.uno:EditSheetMenu" id="bm_id8190862" localize="false"/> +<paragraph role="heading" id="hd_id3146794" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/scalc/01/02200000.xhp" name="Sheet">Sheet</link></paragraph> +<paragraph role="paragraph" id="par_id3149456" xml-lang="en-US" l10n="CHG" oldref="2"><ahelp hid=".">Edit commands for entire sheets.</ahelp></paragraph> +</section> +<paragraph role="heading" id="hd_id3150792" xml-lang="en-US" level="2" l10n="U" oldref="3"><link href="text/scalc/01/02180000.xhp" name="Move/Copy">Move/Copy</link></paragraph> +<embed href="text/scalc/01/02180000.xhp#tabelleverschiebenkopierentext"/> +<paragraph role="heading" id="hd_id3153968" xml-lang="en-US" level="2" l10n="U" oldref="4"><link href="text/scalc/01/02210000.xhp" name="Select">Select</link></paragraph> +<embed href="text/scalc/01/02210000.xhp#tabellenauswaehlen"/> +<paragraph role="heading" id="hd_id3163708" xml-lang="en-US" level="2" l10n="U" oldref="5"><link href="text/scalc/01/02170000.xhp" name="Delete">Delete</link></paragraph> +<embed href="text/scalc/01/02170000.xhp#tabelleloeschentext"/> +<paragraph role="heading" id="hd_id3163733308" xml-lang="en-US" level="2" l10n="NEW"><link href="text/shared/01/06140500.xhp" name="Events">Events</link></paragraph> +<embed href="text/shared/01/06140500.xhp#assignaction"/> +</body> +</helpdocument> diff --git a/source/text/scalc/01/02210000.xhp b/source/text/scalc/01/02210000.xhp new file mode 100644 index 0000000000..8990670216 --- /dev/null +++ b/source/text/scalc/01/02210000.xhp @@ -0,0 +1,49 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--><helpdocument version="1.0"> +<meta> +<topic id="textscalc0102210000xml" indexer="include" status="PUBLISH"> +<title xml-lang="en-US" id="tit">Selecting Sheets</title> +<filename>/text/scalc/01/02210000.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2003-10-31T00:00:00">converted from old format - fpe</lastedited> +</history> +</meta> +<body> + + + <bookmark xml-lang="en-US" branch="hid/.uno:SelectTables" id="bm_id6707893" localize="false"/><!-- HID added by script --> +<bookmark branch="hid/.uno:SelectTables" xml-lang="en-US" id="bm_id3154758"/><paragraph role="heading" level="1" id="hd_id3156023" l10n="U" xml-lang="en-US" oldref="5">Selecting Sheets</paragraph> + <paragraph l10n="U" role="paragraph" id="par_id3147265" xml-lang="en-US" oldref="1"><variable id="tabellenauswaehlen"><ahelp hid=".uno:SelectTables" visibility="visible">Selects multiple sheets.</ahelp></variable></paragraph> + <bookmark branch="hid/SC_HID_SELECTTABLES" xml-lang="en-US" id="bm_id3154126"/><paragraph role="heading" level="2" id="hd_id3125863" l10n="U" xml-lang="en-US" oldref="2">Selected Sheets</paragraph> + <paragraph l10n="U" role="paragraph" id="par_id3153969" xml-lang="en-US" oldref="3"><ahelp hid="HID_SELECTTABLES" visibility="visible">Lists the sheets in the current document. To select a sheet, press the up or down arrow keys to move to a sheet in the list. To add a sheet to the selection, hold down Ctrl (Mac: Command) while pressing the arrow keys and then press Spacebar. To select a range of sheets, hold down Shift and press the arrow keys. </ahelp></paragraph> + </body> +</helpdocument> diff --git a/source/text/scalc/01/03070000.xhp b/source/text/scalc/01/03070000.xhp new file mode 100644 index 0000000000..40e99a6284 --- /dev/null +++ b/source/text/scalc/01/03070000.xhp @@ -0,0 +1,68 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + + + +<helpdocument version="1.0"> +<meta> +<topic id="textscalc0103070000xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Column & Row Headers</title> +<filename>/text/scalc/01/03070000.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2005-10-11T13:27:38">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="spaltenzeilenkoepfe"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3156024"><bookmark_value>spreadsheets; displaying headers of columns/rows</bookmark_value> +<bookmark_value>displaying; headers of columns/rows</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/.uno:ViewRowColumnHeaders" id="bm_id4366858" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/.uno:ViewRowColumnHeaders" id="bm_id3147265" localize="false"/> +<paragraph role="heading" id="hd_id3156024" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/scalc/01/03070000.xhp" name="Column & Row Headers">Column & Row Headers</link></paragraph> +<paragraph role="paragraph" id="par_id3147230" xml-lang="en-US" l10n="CHG" oldref="2"><ahelp hid=".uno:ViewRowColumnHeaders">Shows column headers and row headers.</ahelp></paragraph> +</section> +<list type="unordered"> +<listitem> +<paragraph role="listitem" id="par_id3156280" xml-lang="en-US" l10n="U" oldref="4">To hide the column and row headers unmark this menu entry.</paragraph> +</listitem> +</list> +<section id="howtoget"> + <embed href="text/scalc/00/00000403.xhp#aspze"/> +</section> +<list type="unordered"> +<listitem> +<paragraph role="listitem" id="par_id3156441" xml-lang="en-US" l10n="U" oldref="3">You can also set the view of the column and row headers in <emph><switchinline select="sys"><caseinline select="MAC">%PRODUCTNAME - Preferences</caseinline><defaultinline>Tools - Options</defaultinline></switchinline> - <link href="text/shared/optionen/01060100.xhp" name="Spreadsheet - View">%PRODUCTNAME Calc - View</link></emph>.</paragraph> +</listitem> +</list> +</body> +</helpdocument> diff --git a/source/text/scalc/01/03080000.xhp b/source/text/scalc/01/03080000.xhp new file mode 100644 index 0000000000..b006434b89 --- /dev/null +++ b/source/text/scalc/01/03080000.xhp @@ -0,0 +1,53 @@ +<?xml version="1.0" encoding="UTF-8"?><helpdocument version="1.0"> +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************ --> + +<meta> +<topic id="textscalc0103080000xml" indexer="include" status="PUBLISH"> +<title xml-lang="en-US" id="tit">Value Highlighting</title> +<filename>/text/scalc/01/03080000.xhp</filename> +</topic> +</meta> +<body> +<section id="wertehervorheben"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3151384"> +<bookmark_value>spreadsheets; value highlighting</bookmark_value> +<bookmark_value>values;highlighting</bookmark_value> +<bookmark_value>highlighting; values in sheets</bookmark_value> +<bookmark_value>colors;values</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/.uno:ViewValueHighlighting" id="bm_id3145068" localize="false"/> +<paragraph id="hd_id3151384" role="heading" xml-lang="en-US" level="1"><link href="text/scalc/01/03080000.xhp" name="Value Highlighting">Value Highlighting</link></paragraph> +<paragraph id="par_id3154366" role="paragraph" xml-lang="en-US"><ahelp hid=".uno:ViewValueHighlighting">Displays cell contents in different colors, depending on type.</ahelp></paragraph> +</section> +<paragraph id="par_id3125863" role="paragraph" xml-lang="en-US">To remove the highlighting, unmark the menu entry.</paragraph> +<section id="howtoget"><embed href="text/scalc/00/00000403.xhp#awehe"/> +</section> +<paragraph id="par_id3145785" role="paragraph" xml-lang="en-US">Text cells are formatted in black, formulas in green, and number cells in blue, no matter how their display is formatted.</paragraph> +<paragraph id="par_id3153188" role="warning" xml-lang="en-US">If this function is active, colors that you define in the document will not be displayed. When you deactivate the function, the user-defined colors are displayed again.</paragraph> +</body> +</helpdocument> diff --git a/source/text/scalc/01/03090000.xhp b/source/text/scalc/01/03090000.xhp new file mode 100644 index 0000000000..19ac2efc4f --- /dev/null +++ b/source/text/scalc/01/03090000.xhp @@ -0,0 +1,58 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textscalc0103090000xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Formula Bar</title> +<filename>/text/scalc/01/03090000.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2004-08-16T12:57:24">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="rechenleiste"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3147264"><bookmark_value>formula bar;spreadsheets</bookmark_value> +<bookmark_value>spreadsheets; formula bar</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/.uno:InputLineVisible" id="bm_id268003" localize="false"/><!-- HID added by script --> +<bookmark xml-lang="en-US" branch="hid/.uno:InputLineVisible" id="bm_id3148663" localize="false"/> +<paragraph role="heading" id="hd_id3147264" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/scalc/01/03090000.xhp" name="Formula Bar">Formula Bar</link></paragraph> +<paragraph role="paragraph" id="par_id3156423" xml-lang="en-US" l10n="U" oldref="2"><ahelp hid=".uno:InputLineVisible">Shows or hides the Formula Bar, which is used for entering and editing formulas.</ahelp> The Formula Bar is the most important tool when working with spreadsheets.</paragraph> +</section> +<paragraph role="paragraph" id="par_id3154686" xml-lang="en-US" l10n="U" oldref="4">To hide the Formula Bar, unmark the menu item.</paragraph> +<section id="howtoget"> + <embed href="text/scalc/00/00000403.xhp#rechenleiste"/> +</section> +<paragraph role="paragraph" id="par_id3145787" xml-lang="en-US" l10n="U" oldref="3">If the Formula Bar is hidden, you can still edit cells by activating the edit mode with F2. After editing cells, accept the changes by pressing Enter, or discard entries by pressing Esc. Esc is also used to exit the edit mode.</paragraph> +</body> +</helpdocument> diff --git a/source/text/scalc/01/03100000.xhp b/source/text/scalc/01/03100000.xhp new file mode 100644 index 0000000000..1fef7b643c --- /dev/null +++ b/source/text/scalc/01/03100000.xhp @@ -0,0 +1,62 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textscalc0103100000xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Page Break Preview</title> +<filename>/text/scalc/01/03100000.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2004-09-02T11:31:06">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="seitenumbruchvorschau"> +<bookmark xml-lang="en-US" branch="hid/.uno:PagebreakMode" id="bm_id3465342" localize="false"/><!-- HID added by script --> +<bookmark xml-lang="en-US" branch="hid/.uno:PagebreakMode" id="bm_id3154758" localize="false"/> +<paragraph role="heading" id="hd_id3151384" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/scalc/01/03100000.xhp" name="Page Break Preview">Page Break Preview</link></paragraph> +<paragraph role="paragraph" id="par_id3150792" xml-lang="en-US" l10n="U" oldref="2"><ahelp hid=".uno:PagebreakMode">Display the page breaks and print ranges in the sheet. Choose <emph>View - Normal</emph> to switch this mode off.</ahelp></paragraph> +</section> +<section id="howtoget"> + <embed href="text/scalc/00/00000403.xhp#seumvo"/> +</section> +<embed href="text/scalc/guide/print_details.xhp#print_details"/> +<embed href="text/scalc/guide/print_exact.xhp#print_exact"/> +<paragraph role="paragraph" id="par_id3153877" xml-lang="en-US" l10n="U" oldref="13">The context menu of the page break preview contains functions for editing page breaks, including the following options:</paragraph> +<bookmark xml-lang="en-US" branch="hid/.uno:DeleteAllBreaks" id="bm_id8896104" localize="false"/><!-- HID added by script --> +<bookmark xml-lang="en-US" branch="hid/.uno:DeleteAllBreaks" id="bm_id3155602" localize="false"/> +<paragraph role="heading" id="hd_id3154731" xml-lang="en-US" level="2" l10n="U" oldref="14">Delete All Manual Breaks</paragraph> +<paragraph role="paragraph" id="par_id3149400" xml-lang="en-US" l10n="U" oldref="15"><ahelp hid=".uno:DeleteAllBreaks">Deletes all manual breaks in the current sheet.</ahelp></paragraph> +<paragraph role="heading" id="hd_id3155067" xml-lang="en-US" level="2" l10n="U" oldref="18">Add Print Range</paragraph> +<paragraph role="paragraph" id="par_id3155764" xml-lang="en-US" l10n="U" oldref="19">Adds the selected cells to print ranges.</paragraph> +</body> +</helpdocument> diff --git a/source/text/scalc/01/04010000.xhp b/source/text/scalc/01/04010000.xhp new file mode 100644 index 0000000000..2d0d408141 --- /dev/null +++ b/source/text/scalc/01/04010000.xhp @@ -0,0 +1,61 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!-- + *********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************ + --> + +<helpdocument version="1.0"> +<meta> +<topic id="textscalc0104010000xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Manual Break</title> +<filename>/text/scalc/01/04010000.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2006-03-07T14:43:59">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="manueller"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3153192"><bookmark_value>spreadsheets; inserting breaks in</bookmark_value> +<bookmark_value>inserting; breaks</bookmark_value> +<bookmark_value>page breaks; inserting in spreadsheets</bookmark_value> +</bookmark><comment>mw changed "page breaks;..."</comment> +<bookmark xml-lang="en-US" branch="hid/.uno:InsertBreakMenu" id="bm_id2778710" localize="false"/> +<paragraph role="heading" id="hd_id3153192" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/scalc/01/04010000.xhp" name="Manual Break">Manual Break</link></paragraph> +<paragraph role="paragraph" id="par_id3125864" xml-lang="en-US" l10n="CHG" oldref="2"><ahelp hid=".">This command inserts manual row or column breaks to ensure that your data prints properly. You can insert a horizontal page break above, or a vertical page break to the left of, the active cell.</ahelp></paragraph> +</section> +<paragraph role="paragraph" id="par_id3155133" xml-lang="en-US" l10n="CHG" oldref="3">Choose <link href="text/scalc/01/02190000.xhp" name="Edit - Delete Manual Break">Edit - Delete Manual Break</link> to remove breaks created manually.</paragraph> +<section id="howtoget"> + <embed href="text/scalc/00/00000404.xhp#eimaum"/> +</section> +<embed href="text/scalc/01/04010100.xhp#zeilenumbruch"/> +<embed href="text/scalc/01/04010200.xhp#spaltenumbruch"/> +</body> +</helpdocument> diff --git a/source/text/scalc/01/04010100.xhp b/source/text/scalc/01/04010100.xhp new file mode 100644 index 0000000000..2f73209070 --- /dev/null +++ b/source/text/scalc/01/04010100.xhp @@ -0,0 +1,59 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textscalc0104010100xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Row Break</title> +<filename>/text/scalc/01/04010100.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2004-08-16T11:21:32">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="zeilenumbruch"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3153821"><bookmark_value>sheets; inserting row breaks</bookmark_value> +<bookmark_value>row breaks; inserting</bookmark_value> +<bookmark_value>inserting; manual row breaks</bookmark_value> +<bookmark_value>manual row breaks</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/.uno:InsertRowBreak" id="bm_id7744261" localize="false"/><!-- HID added by script --> +<bookmark xml-lang="en-US" branch="hid/.uno:InsertRowBreak" id="bm_id3151245" localize="false"/> +<paragraph role="heading" id="hd_id3153821" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/scalc/01/04010100.xhp" name="Row Break">Row Break</link></paragraph> +<paragraph role="paragraph" id="par_id3149656" xml-lang="en-US" l10n="U" oldref="2"><ahelp hid=".uno:InsertRowBreak">Inserts a row break (horizontal page break) above the selected cell.</ahelp></paragraph> +</section> +<paragraph role="paragraph" id="par_id3156422" xml-lang="en-US" l10n="U" oldref="3">The manual row break is indicated by a dark blue horizontal line.</paragraph> +<section id="howtoget"> + <embed href="text/scalc/00/00000404.xhp#eimaumze"/> +</section> +</body> +</helpdocument> diff --git a/source/text/scalc/01/04010200.xhp b/source/text/scalc/01/04010200.xhp new file mode 100644 index 0000000000..896bef2786 --- /dev/null +++ b/source/text/scalc/01/04010200.xhp @@ -0,0 +1,59 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--> + +<helpdocument version="1.0"> +<meta> +<topic id="textscalc0104010200xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Column Break</title> +<filename>/text/scalc/01/04010200.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2004-08-16T11:20:46">converted from old format - fpe</lastedited> +</history> +</meta> +<body> +<section id="spaltenumbruch"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3155923"><bookmark_value>spreadsheets; inserting column breaks</bookmark_value> +<bookmark_value>column breaks; inserting</bookmark_value> +<bookmark_value>inserting; manual column breaks</bookmark_value> +<bookmark_value>manual column breaks</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/.uno:InsertColumnBreak" id="bm_id9499162" localize="false"/><!-- HID added by script --> +<bookmark xml-lang="en-US" branch="hid/.uno:InsertColumnBreak" id="bm_id3148947" localize="false"/> +<paragraph role="heading" id="hd_id3155923" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/scalc/01/04010200.xhp" name="Column Break">Column Break</link></paragraph> +<paragraph role="paragraph" id="par_id3150447" xml-lang="en-US" l10n="U" oldref="2"><ahelp hid=".uno:InsertColumnBreak">Inserts a column break (vertical page break) to the left of the active cell.</ahelp></paragraph> +</section> +<paragraph role="paragraph" id="par_id3145171" xml-lang="en-US" l10n="U" oldref="3">The manual column break is indicated by a dark blue vertical line.</paragraph> +<section id="howtoget"> + <embed href="text/scalc/00/00000404.xhp#eimaumsp"/> +</section> +</body> +</helpdocument> diff --git a/source/text/scalc/01/04020000.xhp b/source/text/scalc/01/04020000.xhp new file mode 100644 index 0000000000..38e12850f5 --- /dev/null +++ b/source/text/scalc/01/04020000.xhp @@ -0,0 +1,77 @@ +<?xml version="1.0" encoding="UTF-8"?> + + + +<!-- + *********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************ + --> + + + <helpdocument version="1.0"> +<meta> +<topic id="textscalc0104020000xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Insert Cells</title> +<filename>/text/scalc/01/04020000.xhp</filename> +</topic> +</meta> +<body> +<bookmark xml-lang="en-US" branch="index" id="bm_id3156023"><bookmark_value>spreadsheets; inserting cells</bookmark_value> +<bookmark_value>cells; inserting</bookmark_value> +<bookmark_value>inserting; cells</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/.uno:InsertCell" id="bm_id6503296" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/.uno:InsertCell" id="bm_id3147264" localize="false"/><paragraph role="heading" id="hd_id3156023" xml-lang="en-US" level="1" l10n="U" oldref="1"> Insert Cells</paragraph> +<paragraph role="paragraph" id="par_id3150542" xml-lang="en-US" l10n="U" oldref="2"><variable id="zelleneinfuegentext"><ahelp hid=".uno:InsertCell">Opens the<emph> Insert Cells </emph>dialog, in which you can insert new cells according to the options that you specify.</ahelp> +</variable> You can delete cells by choosing <link href="text/scalc/01/02160000.xhp" name="Edit - Delete Cells"><emph>Edit - Delete Cells</emph></link>.</paragraph> +<section id="howtoget"> + <embed href="text/scalc/00/00000404.xhp#eize"/> +</section> +<paragraph role="heading" id="hd_id3153768" xml-lang="en-US" level="2" l10n="U" oldref="3">Selection</paragraph> +<paragraph role="paragraph" id="par_id3149262" xml-lang="en-US" l10n="U" oldref="4">This area contains the options available for inserting cells into a sheet. The cell quantity and position is defined by selecting a cell range in the sheet beforehand.</paragraph> +<bookmark xml-lang="en-US" branch="hid/.uno:InsertCellsDown" id="bm_id6210706" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/.uno:InsertCellsDown" id="bm_id3152578" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/sc:RadioButton:RID_SCDLG_INSCELL:BTN_CELLSDOWN" id="bm_id3145271" localize="false"/><paragraph role="heading" id="hd_id3146120" xml-lang="en-US" level="3" l10n="U" oldref="5">Shift cells down</paragraph> +<paragraph role="paragraph" id="par_id3152596" xml-lang="en-US" l10n="U" oldref="6"><variable id="zellenuntentext"><ahelp hid="SC:RADIOBUTTON:RID_SCDLG_INSCELL:BTN_CELLSDOWN">Moves the contents of the selected range downward when cells are inserted.</ahelp> +</variable></paragraph> +<embed href="text/scalc/00/00000404.xhp#syzellenunten"/> +<bookmark xml-lang="en-US" branch="hid/.uno:InsertCellsRight" id="bm_id7689959" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/.uno:InsertCellsRight" id="bm_id3151118" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/sc:RadioButton:RID_SCDLG_INSCELL:BTN_CELLSRIGHT" id="bm_id3147348" localize="false"/><paragraph role="heading" id="hd_id3147434" xml-lang="en-US" level="3" l10n="U" oldref="7">Shift cells right</paragraph> +<paragraph role="paragraph" id="par_id3144764" xml-lang="en-US" l10n="U" oldref="8"><variable id="zellenrechtstext"><ahelp hid="SC:RADIOBUTTON:RID_SCDLG_INSCELL:BTN_CELLSRIGHT">Moves the contents of the selected range to the right when cells are inserted.</ahelp> +</variable></paragraph> +<embed href="text/scalc/00/00000404.xhp#syzellenrechts"/> +<bookmark xml-lang="en-US" branch="hid/sc:RadioButton:RID_SCDLG_INSCELL:BTN_INSROWS" id="bm_id3154731" localize="false"/><paragraph role="heading" id="hd_id3153877" xml-lang="en-US" level="3" l10n="U" oldref="9">Entire row</paragraph> +<paragraph role="paragraph" id="par_id3155417" xml-lang="en-US" l10n="U" oldref="10"><variable id="zeilenganzetext"><ahelp hid="SC:RADIOBUTTON:RID_SCDLG_INSCELL:BTN_INSROWS">Inserts an entire row. The position of the row is determined by the selection on the sheet.</ahelp> +</variable> The number of rows inserted depends on how many rows are selected. The contents of the original rows are moved downward.</paragraph> +<embed href="text/scalc/00/00000404.xhp#syzeilenganze"/> +<bookmark xml-lang="en-US" branch="hid/sc:RadioButton:RID_SCDLG_INSCELL:BTN_INSCOLS" id="bm_id3150750" localize="false"/><paragraph role="heading" id="hd_id3146971" xml-lang="en-US" level="3" l10n="U" oldref="11">Entire column</paragraph> +<paragraph role="paragraph" id="par_id3155068" xml-lang="en-US" l10n="CHG" oldref="12"><variable id="spaltenganzetext"><ahelp hid="SC:RADIOBUTTON:RID_SCDLG_INSCELL:BTN_INSCOLS">Inserts an entire column. The number of columns to be inserted is determined by the selected number of columns.</ahelp> +</variable> The contents of the original columns are shifted to the right.</paragraph> +<embed href="text/scalc/00/00000404.xhp#syspaltenganze"/> +</body> +</helpdocument> diff --git a/source/text/scalc/01/04030000.xhp b/source/text/scalc/01/04030000.xhp new file mode 100644 index 0000000000..da25f52385 --- /dev/null +++ b/source/text/scalc/01/04030000.xhp @@ -0,0 +1,52 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!--*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************--><helpdocument version="1.0"> +<meta> +<topic id="textscalc0104030000xml" indexer="include" status="PUBLISH"> +<title xml-lang="en-US" id="tit">Rows</title> +<filename>/text/scalc/01/04030000.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +<lastedited date="2003-10-31T00:00:00">converted from old format - fpe</lastedited> +</history> +</meta> +<body> + + + <section id="zeilen"> + <bookmark branch="index" xml-lang="en-US" id="bm_id3150541"><bookmark_value>spreadsheets; inserting rows</bookmark_value><bookmark_value>rows; inserting</bookmark_value><bookmark_value>inserting; rows</bookmark_value></bookmark><bookmark xml-lang="en-US" branch="hid/.uno:InsertRows" id="bm_id4302477" localize="false"/><!-- HID added by script --> +<bookmark branch="hid/.uno:InsertRows" xml-lang="en-US" id="bm_id3154366"/><paragraph id="hd_id3150541" role="heading" level="1" oldref="1" l10n="U" xml-lang="en-US"><link href="text/scalc/01/04030000.xhp" name="Rows">Rows</link></paragraph> + <paragraph l10n="U" role="paragraph" id="par_id3150767" xml-lang="en-US" oldref="2"><ahelp hid=".uno:InsertRows" visibility="visible">Inserts a new row above the active cell.</ahelp> The number of rows inserted correspond to the number of rows selected. The existing rows are moved downward.</paragraph> + </section> + <section id="howtoget"> + <embed href="text/scalc/00/00000404.xhp#eizei"/> +</section> + </body> +</helpdocument> diff --git a/source/text/scalc/01/04040000.xhp b/source/text/scalc/01/04040000.xhp new file mode 100644 index 0000000000..fd679dcea9 --- /dev/null +++ b/source/text/scalc/01/04040000.xhp @@ -0,0 +1,55 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> + +<!-- +*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************ + --> + + +<meta> +<topic id="textscalc0104040000xml" indexer="include"> +<title id="tit" xml-lang="en-US">Columns</title> +<filename>/text/scalc/01/04040000.xhp</filename> +</topic> +</meta> +<body> +<section id="spalten"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3155628"><bookmark_value>spreadsheets; inserting columns</bookmark_value> +<bookmark_value>inserting; columns</bookmark_value> +<bookmark_value>columns; inserting</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/.uno:InsertColumns" id="bm_id601010" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/.uno:InsertColumns" id="bm_id3155922" localize="false"/> +<paragraph role="heading" id="hd_id3155628" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/scalc/01/04040000.xhp" name="Columns">Columns</link></paragraph> +<paragraph role="paragraph" id="par_id3150791" xml-lang="en-US" l10n="U" oldref="2"><ahelp hid=".uno:InsertColumns">Inserts a new column to the left of the active cell.</ahelp> The number of columns inserted corresponds to the number of columns selected. The existing columns are moved to the right.</paragraph> +</section> +<section id="howtoget"> +<embed href="text/scalc/00/00000404.xhp#eispa"/> +</section> +</body> +</helpdocument> diff --git a/source/text/scalc/01/04050000.xhp b/source/text/scalc/01/04050000.xhp new file mode 100644 index 0000000000..94627a9d0a --- /dev/null +++ b/source/text/scalc/01/04050000.xhp @@ -0,0 +1,85 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> + +<!-- +*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************ + --> + + +<meta> +<topic id="textscalc0104050000xml" indexer="include"> +<title id="tit" xml-lang="en-US">Insert Sheet</title> +<filename>/text/scalc/01/04050000.xhp</filename> +</topic> +</meta> +<body> +<bookmark xml-lang="en-US" branch="index" id="bm_id4522232"><bookmark_value>sheets;creating</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/sc:ModalDialog:RID_SCDLG_INSERT_TABLE" id="bm_id3151384" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/.uno:Insert" id="bm_id1669896" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/.uno:Insert" id="bm_id3153896" localize="false"/> +<paragraph role="heading" id="hd_id3155629" xml-lang="en-US" level="1" l10n="U" oldref="1">Insert Sheet</paragraph> +<paragraph role="paragraph" id="par_id3147264" xml-lang="en-US" l10n="U" oldref="2"><variable id="tabelleeinfuegentext"><ahelp hid=".uno:Insert">Defines the options to be used to insert a new sheet.</ahelp> You can create a new sheet, or insert an existing sheet from a file. +</variable></paragraph> +<section id="howtoget"> +<embed href="text/scalc/00/00000404.xhp#eitab"/> +</section> +<paragraph role="heading" id="hd_id3154684" xml-lang="en-US" level="2" l10n="U" oldref="19">Position</paragraph> +<paragraph role="paragraph" id="par_id3156281" xml-lang="en-US" l10n="U" oldref="20">Specifies where the new sheet is to be inserted into your document.</paragraph> +<bookmark xml-lang="en-US" branch="hid/sc:RadioButton:RID_SCDLG_INSERT_TABLE:RB_BEFORE" id="bm_id3155131" localize="false"/> +<paragraph role="heading" id="hd_id3154123" xml-lang="en-US" level="3" l10n="U" oldref="21">Before current sheet</paragraph> +<paragraph role="paragraph" id="par_id3145787" xml-lang="en-US" l10n="U" oldref="22"><ahelp hid="SC:RADIOBUTTON:RID_SCDLG_INSERT_TABLE:RB_BEFORE">Inserts a new sheet directly before the current sheet.</ahelp></paragraph> +<bookmark xml-lang="en-US" branch="hid/sc:RadioButton:RID_SCDLG_INSERT_TABLE:RB_BEHIND" id="bm_id3147434" localize="false"/> +<paragraph role="heading" id="hd_id3155414" xml-lang="en-US" level="3" l10n="U" oldref="23">After current sheet</paragraph> +<paragraph role="paragraph" id="par_id3145271" xml-lang="en-US" l10n="U" oldref="24"><ahelp hid="SC:RADIOBUTTON:RID_SCDLG_INSERT_TABLE:RB_BEHIND">Inserts a new sheet directly after the current sheet.</ahelp></paragraph> +<paragraph role="heading" id="hd_id3147428" xml-lang="en-US" level="2" l10n="CHG" oldref="25">Sheet</paragraph> +<paragraph role="paragraph" id="par_id3154012" xml-lang="en-US" l10n="U" oldref="26">Specifies whether a new sheet or an existing sheet is inserted into the document.</paragraph> +<bookmark xml-lang="en-US" branch="hid/sc:RadioButton:RID_SCDLG_INSERT_TABLE:RB_NEW" id="bm_id3145750" localize="false"/> +<paragraph role="heading" id="hd_id3147350" xml-lang="en-US" level="2" l10n="CHG" oldref="3">New sheet</paragraph> +<paragraph role="paragraph" id="par_id3149262" xml-lang="en-US" l10n="CHG" oldref="4"><ahelp hid="SC_RADIOBUTTON_RID_SCDLG_INSERT_TABLE_RB_NEW">Creates a new sheet. Enter a sheet name in the <emph>Name</emph> field. Allowed characters are letters, numbers, spaces, and the underline character.</ahelp></paragraph> +<bookmark xml-lang="en-US" branch="hid/sc:NumericField:RID_SCDLG_INSERT_TABLE:NF_COUNT" id="bm_id3153157" localize="false"/> +<paragraph role="heading" id="hd_id3155418" xml-lang="en-US" level="3" l10n="CHG" oldref="27">No. of sheets</paragraph> +<paragraph role="paragraph" id="par_id3148457" xml-lang="en-US" l10n="U" oldref="28"><ahelp hid="SC:NUMERICFIELD:RID_SCDLG_INSERT_TABLE:NF_COUNT">Specifies the number of sheets to be created.</ahelp></paragraph> +<bookmark xml-lang="en-US" branch="hid/sc:Edit:RID_SCDLG_INSERT_TABLE:ED_TABNAME" id="bm_id3154510" localize="false"/> +<paragraph role="heading" id="hd_id3149379" xml-lang="en-US" level="3" l10n="U" oldref="7">Name</paragraph> +<paragraph role="paragraph" id="par_id3150718" xml-lang="en-US" l10n="CHG" oldref="8"><ahelp hid="SC:EDIT:RID_SCDLG_INSERT_TABLE:ED_TABNAME">Specifies the name of the new sheet.</ahelp></paragraph> +<embed href="text/scalc/guide/rename_table.xhp#rename_table"/> +<bookmark xml-lang="en-US" branch="hid/sc:RadioButton:RID_SCDLG_INSERT_TABLE:RB_FROMFILE" id="bm_id3150328" localize="false"/> +<paragraph role="heading" id="hd_id3155066" xml-lang="en-US" level="2" l10n="U" oldref="9">From File</paragraph> +<paragraph role="paragraph" id="par_id3153714" xml-lang="en-US" l10n="CHG" oldref="10"><ahelp hid="SC_RADIOBUTTON_RID_SCDLG_INSERT_TABLE_RB_FROMFILE">Inserts a sheet from an existing file into the current document.</ahelp></paragraph> +<bookmark xml-lang="en-US" branch="hid/sc:PushButton:RID_SCDLG_INSERT_TABLE:BTN_BROWSE" id="bm_id3150044" localize="false"/> +<paragraph role="heading" id="hd_id3149020" xml-lang="en-US" level="3" l10n="U" oldref="15">Browse</paragraph> +<paragraph role="paragraph" id="par_id3159267" xml-lang="en-US" l10n="CHG" oldref="16"><ahelp hid="SC:PUSHBUTTON:RID_SCDLG_INSERT_TABLE:BTN_BROWSE">Opens a dialog for selecting a file.</ahelp></paragraph> +<bookmark xml-lang="en-US" branch="hid/sc:MultiListBox:RID_SCDLG_INSERT_TABLE:LB_TABLES" id="bm_id3146314" localize="false"/> +<paragraph role="heading" id="hd_id3149255" xml-lang="en-US" level="3" l10n="U" oldref="29">Available Sheets</paragraph> +<paragraph role="paragraph" id="par_id3155336" xml-lang="en-US" l10n="U" oldref="30"><ahelp hid="SC:MULTILISTBOX:RID_SCDLG_INSERT_TABLE:LB_TABLES">If you selected a file by using the <emph>Browse</emph> button, the sheets contained in it are displayed in the list box. The file path is displayed below this box. Select the sheet to be inserted from the list box.</ahelp></paragraph> +<bookmark xml-lang="en-US" branch="hid/sc:CheckBox:RID_SCDLG_INSERT_TABLE:CB_LINK" id="bm_id3149814" localize="false"/> +<paragraph role="heading" id="hd_id3145791" xml-lang="en-US" level="3" l10n="U" oldref="17">Link</paragraph> +<paragraph role="paragraph" id="par_id3152580" xml-lang="en-US" l10n="CHG" oldref="18"><ahelp hid="SC_CHECKBOX_RID_SCDLG_INSERT_TABLE_CB_LINK">Select to insert the sheet as a link instead as a copy. The links can be updated to show the current contents.</ahelp></paragraph> +</body> +</helpdocument> diff --git a/source/text/scalc/01/04050100.xhp b/source/text/scalc/01/04050100.xhp new file mode 100644 index 0000000000..be5fc595b6 --- /dev/null +++ b/source/text/scalc/01/04050100.xhp @@ -0,0 +1,60 @@ +<?xml version="1.0" encoding="UTF-8"?> + + + +<!-- + *********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************ + --> + + + <helpdocument version="1.0"> +<meta> +<topic id="textscalc0104050100xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Sheet from file</title> +<filename>/text/scalc/01/04050100.xhp</filename> +</topic> +</meta> +<body> +<section id="sheetfromfile"> +<bookmark xml-lang="en-US" branch="hid/.uno:InsertSheetFromFile" id="bm_id1850337" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/.uno:InsertSheetFromFile" id="bm_id4379406" localize="false"/><paragraph role="heading" id="par_idN105C1" xml-lang="en-US" level="1" l10n="NEW"><link href="text/scalc/01/04050100.xhp">Sheet from file</link></paragraph> +<paragraph role="paragraph" id="par_idN105D1" xml-lang="en-US" l10n="NEW"><ahelp hid="26275">Inserts a sheet from a different spreadsheet file.</ahelp></paragraph> +</section> +<section id="howtoget"> + <embed href="text/scalc/00/00000404.xhp#eitabfile"/> +</section> +<list type="ordered"> +<listitem> +<paragraph role="paragraph" id="par_idN105F7" xml-lang="en-US" l10n="CHG">Use the <link href="text/shared/01/01020000.xhp">File - Open</link> dialog to locate the spreadsheet.</paragraph> +</listitem> +<listitem> +<paragraph role="paragraph" id="par_idN10609" xml-lang="en-US" l10n="NEW">In the <link href="text/scalc/01/04050000.xhp">Insert Sheet</link> dialog, select the sheet that you want to insert.</paragraph> +</listitem> +</list> +</body> +</helpdocument> diff --git a/source/text/scalc/01/04060000.xhp b/source/text/scalc/01/04060000.xhp new file mode 100644 index 0000000000..70961a7ff0 --- /dev/null +++ b/source/text/scalc/01/04060000.xhp @@ -0,0 +1,113 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> + +<!-- +*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************ + --> + + +<meta> +<topic id="textscalc0104060000xml" indexer="include"> +<title id="tit" xml-lang="en-US">Function Wizard</title> +<filename>/text/scalc/01/04060000.xhp</filename> +</topic> +</meta> +<body> +<section id="funktionsautopilot"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3147426"><bookmark_value>inserting functions; Function Wizard</bookmark_value> +<bookmark_value>functions;Function Wizard</bookmark_value> +<bookmark_value>wizards; functions</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_INSWIN_CALC" id="bm_id3145750" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/.uno:FunctionDialog" id="bm_id1185225" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/.uno:FunctionDialog" id="bm_id3148577" localize="false"/> +<paragraph role="heading" id="hd_id3147426" xml-lang="en-US" level="1" l10n="U" oldref="1"><link href="text/scalc/01/04060000.xhp" name="AutoPilot: Functions">Function Wizard</link></paragraph> +</section> +<paragraph role="paragraph" id="par_id3145271" xml-lang="en-US" l10n="U" oldref="2"><variable id="funktionsautopilottext"><ahelp hid=".uno:FunctionDialog">Opens the <emph>Function Wizard</emph>, which helps you to interactively create formulas.</ahelp> +</variable> Before you start the Wizard, select a cell or a range of cells from the current sheet, in order to determine the position at which the formula will be inserted.</paragraph> +<section id="howtoget"> +<embed href="text/scalc/00/00000404.xhp#eifu"/> +</section> +<paragraph role="note" id="par_id8007446" xml-lang="en-US" l10n="NEW">You can download the complete ODFF (OpenDocument Format Formula) specification from the <link href="http://www.oasis-open.org/committees/documents.php?wg_abbrev=office-formula">OASIS</link> web site.</paragraph> +<paragraph role="paragraph" id="par_id3159153" xml-lang="en-US" l10n="U" oldref="60">The <emph>Function Wizard</emph> has two tabs: <emph>Functions</emph> is used to create formulas, and <emph>Structure</emph> is used to check the formula build.</paragraph> +<paragraph role="heading" id="hd_id3154490" xml-lang="en-US" level="2" l10n="U" oldref="3">Functions Tab</paragraph> +<paragraph role="paragraph" id="par_id3149378" xml-lang="en-US" l10n="U" oldref="5"><link href="text/scalc/01/04060100.xhp" name="List of Categories and Functions">List of Categories and Functions</link></paragraph> +<!-- removed HID SC:LISTBOX:RID_SCTAB_FUNCTION:LB_CATEGORY --> +<paragraph role="heading" id="hd_id3154730" xml-lang="en-US" level="3" l10n="U" oldref="36">Category</paragraph> +<paragraph role="paragraph" id="par_id3153417" xml-lang="en-US" l10n="U" oldref="37"><variable id="kategorienliste"><ahelp hid="SC:LISTBOX:RID_SCTAB_FUNCTION:LB_CATEGORY">Lists all the categories to which the different functions are assigned. Select a category to view the appropriate functions in the list field below.</ahelp> Select "All" to view all functions in alphabetical order, irrespective of category. "Last Used" lists the functions you have most recently used. +</variable></paragraph> +<!-- removed HID SC:LISTBOX:RID_SCTAB_FUNCTION:LB_FUNCTION --> +<paragraph role="heading" id="hd_id3150749" xml-lang="en-US" level="3" l10n="U" oldref="6">Function</paragraph> +<paragraph role="paragraph" id="par_id3155445" xml-lang="en-US" l10n="U" oldref="7"><ahelp hid="SC:LISTBOX:RID_SCTAB_FUNCTION:LB_FUNCTION">Displays the functions found under the selected category. Double-click to select a function.</ahelp> A single-click displays a short function description.</paragraph> +<!-- removed HID SC:CHECKBOX:RID_SCDLG_FORMULA:BTN_MATRIX --> +<paragraph role="heading" id="hd_id3159264" xml-lang="en-US" level="3" l10n="U" oldref="8">Array</paragraph> +<paragraph role="paragraph" id="par_id3149566" xml-lang="en-US" l10n="U" oldref="9"><ahelp hid="SC:CHECKBOX:RID_SCDLG_FORMULA:BTN_MATRIX">Specifies that the selected function is inserted into the selected cell range as an array formula. </ahelp> Array formulas operate on multiple cells. Each cell in the array contains the formula, not as a copy but as a common formula shared by all matrix cells.</paragraph> +<paragraph role="paragraph" id="par_id3155959" xml-lang="en-US" l10n="U" oldref="61">The <emph>Array</emph> option is identical to the <switchinline select="sys"><caseinline select="MAC">Command</caseinline><defaultinline>Ctrl</defaultinline></switchinline>+Shift+Enter command, which is used to enter and confirm formulas in the sheet. The formula is inserted as a matrix formula indicated by two braces { }.</paragraph> +<paragraph role="note" id="par_id3152993" xml-lang="en-US" l10n="U" oldref="40">The maximum size of an array range is 128 by 128 cells.</paragraph> +<paragraph role="heading" id="hd_id3150367" xml-lang="en-US" level="3" l10n="U" oldref="41">Argument Input Fields</paragraph> +<paragraph role="paragraph" id="par_id3145587" xml-lang="en-US" l10n="CHG" oldref="15">When you double-click a function, the argument input field(s) appear on the right side of the dialog. To select a cell reference as an argument, click directly into the cell, or drag across the required range on the sheet while holding down the mouse button. You can also enter numerical and other values or references directly into the corresponding fields in the dialog. When using <link href="text/scalc/01/04060102.xhp" name="date entries">date entries</link>, make sure you use the correct format. Click OK to insert the result into the spreadsheet.</paragraph> +<embed href="text/shared/00/00000001.xhp#eingabesymbol"/> +<paragraph role="heading" id="hd_id3149408" xml-lang="en-US" level="3" l10n="U" oldref="18">Function Result</paragraph> +<paragraph role="paragraph" id="par_id3155809" xml-lang="en-US" l10n="U" oldref="19">As soon you enter arguments in the function, the result is calculated. This preview informs you if the calculation can be carried out with the arguments given. If the arguments result in an error, the corresponding <link href="text/scalc/05/02140000.xhp" name="error code">error code</link> is displayed.</paragraph> +<paragraph role="paragraph" id="par_id3148700" xml-lang="en-US" l10n="CHG" oldref="23">The required arguments are indicated by names in bold print.</paragraph> +<!-- removed HID HID_SC_FAP_BTN_FX1 --> +<!-- removed HID HID_SC_FAP_BTN_FX2 --> +<!-- removed HID HID_SC_FAP_BTN_FX3 --> +<!-- removed HID HID_SC_FAP_BTN_FX4 --> +<paragraph role="heading" id="hd_id3153064" xml-lang="en-US" level="3" l10n="CHG" oldref="22">f(x) (depending on the selected function)</paragraph> +<paragraph role="paragraph" id="par_id3157980" xml-lang="en-US" l10n="U" oldref="24"><ahelp hid="HID_SC_FAP_BTN_FX4">Allows you to access a subordinate level of the <emph>Function Wizard</emph> in order to nest another function within the function, instead of a value or reference.</ahelp></paragraph> +<!-- removed HID SC:EDIT:RID_SCDLG_FORMULA:ED_REF --> +<paragraph role="heading" id="hd_id3145076" xml-lang="en-US" level="3" l10n="CHG" oldref="25">Argument/Parameter/Cell Reference (depending on the selected function)</paragraph> +<paragraph role="paragraph" id="par_id3159097" xml-lang="en-US" l10n="U" oldref="26"><ahelp hid="SC:EDIT:RID_SCDLG_FORMULA:ED_REF">The number of visible text fields depends on the function. Enter arguments either directly into the argument fields or by clicking a cell in the table.</ahelp></paragraph> +<paragraph role="heading" id="hd_id3154957" xml-lang="en-US" level="3" l10n="U" oldref="51">Result</paragraph> +<paragraph role="paragraph" id="par_id3150211" xml-lang="en-US" l10n="U" oldref="52">Displays the calculation result or an error message.</paragraph> +<!-- removed HID HID_SC_FAP_FORMULA --> +<paragraph role="heading" id="hd_id3151304" xml-lang="en-US" level="3" l10n="U" oldref="43">Formula</paragraph> +<paragraph role="paragraph" id="par_id3149898" xml-lang="en-US" l10n="CHG" oldref="44"><ahelp hid="HID_SC_FAP_FORMULA">Displays the created formula. Type your entries directly, or create the formula using the wizard.</ahelp></paragraph> +<!-- removed HID SC:PUSHBUTTON:RID_SCDLG_FORMULA:BTN_BACKWARD --> +<paragraph role="heading" id="hd_id3153249" xml-lang="en-US" level="3" l10n="U" oldref="45">Back</paragraph> +<paragraph role="paragraph" id="par_id3152869" xml-lang="en-US" l10n="U" oldref="53"><ahelp hid="SC:PUSHBUTTON:RID_SCDLG_FORMULA:BTN_BACKWARD">Moves the focus back through the formula components, marking them as it does so.</ahelp></paragraph> +<paragraph role="tip" id="par_id3146966" xml-lang="en-US" l10n="U" oldref="56">To select a single function from a complex formula consisting of several functions, double-click the function in the formula window.</paragraph> +<!-- removed HID SC:PUSHBUTTON:RID_SCDLG_FORMULA:BTN_FORWARD --> +<paragraph role="heading" id="hd_id3155762" xml-lang="en-US" level="3" l10n="U" oldref="54">Next</paragraph> +<paragraph role="paragraph" id="par_id3149316" xml-lang="en-US" l10n="U" oldref="55"><ahelp hid="SC:PUSHBUTTON:RID_SCDLG_FORMULA:BTN_FORWARD">Moves forward through the formula components in the formula window.</ahelp> This button can also be used to assign functions to the formula. If you select a function and click the <emph>Next </emph>button, the selection appears in the formula window.</paragraph> +<paragraph role="tip" id="par_id3159262" xml-lang="en-US" l10n="U" oldref="57">Double-click a function in the selection window to transfer it to the formula window.</paragraph> +<paragraph role="heading" id="hd_id3148745" xml-lang="en-US" level="3" l10n="U" oldref="58">Cancel</paragraph> +<paragraph role="paragraph" id="par_id3147402" xml-lang="en-US" l10n="U" oldref="59">Closes the dialog without implementing the formula.</paragraph> +<paragraph role="heading" id="hd_id3150534" xml-lang="en-US" level="3" l10n="U" oldref="32">OK</paragraph> +<paragraph role="paragraph" id="par_id3153029" xml-lang="en-US" l10n="CHG" oldref="33">Ends the <emph>Function Wizard</emph>, and transfers the formula to the selected cells.</paragraph> +<paragraph role="paragraph" id="par_id3156400" xml-lang="en-US" l10n="U" oldref="34"><link href="text/scalc/01/04060100.xhp" name="List of Categories and Functions">List of Categories and Functions</link></paragraph> +<paragraph role="heading" id="hd_id3147610" xml-lang="en-US" level="2" l10n="U" oldref="47">Structure tab</paragraph> +<paragraph role="paragraph" id="par_id3153122" xml-lang="en-US" l10n="U" oldref="48">On this page, you can view the structure of the function.</paragraph> +<paragraph role="note" id="par_id3149350" xml-lang="en-US" l10n="U" oldref="4">If you start the <emph>Function Wizard</emph> while the cell cursor is positioned in a cell that already contains a function, the <emph>Structure</emph> tab is opened and shows the composition of the current formula.</paragraph> +<!-- removed HID HID_SC_FAP_STRUCT --> +<paragraph role="heading" id="hd_id3149014" xml-lang="en-US" level="3" l10n="U" oldref="49">Structure</paragraph> +<paragraph role="paragraph" id="par_id3150481" xml-lang="en-US" l10n="U" oldref="50"><ahelp hid="HID_SC_FAP_STRUCT">Displays a hierarchical representation of the current function.</ahelp> You can hide or show the arguments by a click on the plus or minus sign in front.</paragraph> +<paragraph role="note" id="par_id3148886" xml-lang="en-US" l10n="U" oldref="63">Blue dots denote correctly entered arguments. Red dots indicate incorrect data types. For example: if the SUM function has one argument entered as text, this is highlighted in red as SUM only permits number entries.</paragraph> +</body> +</helpdocument> diff --git a/source/text/scalc/01/04060100.xhp b/source/text/scalc/01/04060100.xhp new file mode 100644 index 0000000000..a5b301b63f --- /dev/null +++ b/source/text/scalc/01/04060100.xhp @@ -0,0 +1,82 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> + +<!-- +*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************ + --> + + +<meta> + <topic id="textscalc0104060100xml" indexer="include"> + <title xml-lang="en-US" id="tit">Functions by Category</title> + <filename>/text/scalc/01/04060100.xhp</filename> + </topic> + </meta> + <body> +<bookmark xml-lang="en-US" branch="index" id="bm_id3148575"><bookmark_value>functions;listed by category</bookmark_value> + <bookmark_value>categories of functions</bookmark_value> + <bookmark_value>list of functions</bookmark_value> +</bookmark><comment>MW deleted "Calc functions"</comment> +<paragraph xml-lang="en-US" id="hd_id3154944" role="heading" level="1" l10n="CHG" + oldref="16">Functions by Category</paragraph> + <paragraph xml-lang="en-US" id="par_id3149378" role="paragraph" l10n="CHG" oldref="2">This section describes the functions of $[officename] Calc. The various functions are divided into categories in the Function Wizard.</paragraph> + <paragraph xml-lang="en-US" id="par_id0120200910234570" role="tip" l10n="NEW">You can find detailed explanations, illustrations, and examples of Calc functions <link href="http://help.libreoffice.org/Calc/Functions_by_Category">in the LibreOffice WikiHelp</link>.</paragraph> + <paragraph xml-lang="en-US" id="hd_id3146972" role="heading" level="2" l10n="U" oldref="3"><link href="text/scalc/01/04060101.xhp" name="Database">Database</link></paragraph> + <embed href="text/scalc/01/04060101.xhp#datenbanktext"/> + <paragraph xml-lang="en-US" id="hd_id3155443" role="heading" level="2" l10n="U" oldref="4"><link href="text/scalc/01/04060102.xhp" name="Date & Time">Date & Time</link></paragraph> + <embed href="text/scalc/01/04060102.xhp#datumzeittext"/> + <paragraph xml-lang="en-US" id="hd_id3147339" role="heading" level="2" l10n="U" oldref="5"><link href="text/scalc/01/04060103.xhp" name="Financial">Financial</link></paragraph> + <embed href="text/scalc/01/04060103.xhp#finanztext"/> + <paragraph xml-lang="en-US" id="hd_id3153963" role="heading" level="2" l10n="U" oldref="6"><link href="text/scalc/01/04060104.xhp" name="Information">Information</link></paragraph> + <embed href="text/scalc/01/04060104.xhp#informationtext"/> + <paragraph xml-lang="en-US" id="hd_id3146316" role="heading" level="2" l10n="U" oldref="7"><link href="text/scalc/01/04060105.xhp" name="Logical">Logical</link></paragraph> + <embed href="text/scalc/01/04060105.xhp#logischtext"/> + <paragraph xml-lang="en-US" id="hd_id3148485" role="heading" level="2" l10n="U" oldref="8"><link href="text/scalc/01/04060106.xhp" name="Mathematical">Mathematical</link></paragraph> + <embed href="text/scalc/01/04060106.xhp#mathematiktext"/> + <paragraph xml-lang="en-US" id="hd_id3150363" role="heading" level="2" l10n="CHG" + oldref="9"><link href="text/scalc/01/04060107.xhp" name="Matrix">Array</link></paragraph> + <embed href="text/scalc/01/04060107.xhp#matrixtext"/> + <paragraph xml-lang="en-US" id="hd_id3150208" role="heading" level="2" l10n="U" + oldref="10"><link href="text/scalc/01/04060108.xhp" name="Statistical">Statistical</link></paragraph> + <embed href="text/scalc/01/04060108.xhp#statistiktext"/> + <paragraph xml-lang="en-US" id="hd_id3166428" role="heading" level="2" l10n="U" + oldref="11"><link href="text/scalc/01/04060109.xhp" name="Spreadsheet">Spreadsheet</link></paragraph> + <embed href="text/scalc/01/04060109.xhp#tabelletext"/> + <paragraph xml-lang="en-US" id="hd_id3145585" role="heading" level="2" l10n="U" + oldref="12"><link href="text/scalc/01/04060110.xhp" name="Text">Text</link></paragraph> + <embed href="text/scalc/01/04060110.xhp#texttext"/> + <paragraph xml-lang="en-US" id="hd_id3156449" role="heading" level="2" l10n="U" + oldref="13"><link href="text/scalc/01/04060111.xhp" name="Add-in">Add-in</link></paragraph> + <embed href="text/scalc/01/04060111.xhp#addintext"/> + <paragraph xml-lang="en-US" id="par_id3150715" role="paragraph" l10n="U" oldref="14"><link href="text/scalc/01/04060199.xhp" name="Operators">Operators</link> are also available.</paragraph> + <section id="relatedtopics"> + <paragraph xml-lang="en-US" id="par_id0902200809540918" role="paragraph" l10n="NEW"><variable id="drking"><link href="http://help.libreoffice.org/Calc/Functions_by_Category">Calc Functions By Category</link> in the LibreOffice WikiHelp +</variable></paragraph> + </section> + </body> +</helpdocument>
\ No newline at end of file diff --git a/source/text/scalc/01/04060101.xhp b/source/text/scalc/01/04060101.xhp new file mode 100644 index 0000000000..2cd7057ca7 --- /dev/null +++ b/source/text/scalc/01/04060101.xhp @@ -0,0 +1,766 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> + +<!-- +*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************ + --> + + +<meta> + <topic id="textscalc0104060101xml" indexer="include"> + <title xml-lang="en-US" id="tit">Database Functions</title> + <filename>/text/scalc/01/04060101.xhp</filename> + </topic> + </meta> + <body> +<bookmark xml-lang="en-US" branch="index" id="bm_id3148946"><bookmark_value>Function Wizard; databases</bookmark_value> + <bookmark_value>functions; database functions</bookmark_value> + <bookmark_value>databases; functions in $[officename] Calc</bookmark_value> +</bookmark> +<paragraph xml-lang="en-US" id="hd_id3148946" role="heading" level="1" l10n="U" oldref="1">Database Functions</paragraph> + <paragraph xml-lang="en-US" id="par_id3145173" role="paragraph" l10n="U" oldref="2"><variable id="datenbanktext">This section deals with functions used with data organized as one row of data for one record. +</variable></paragraph> + <paragraph xml-lang="en-US" id="par_id3154016" role="note" l10n="U" oldref="186">The Database category may be confused with a database integrated in $[officename]. However, there is no connection between a database in $[officename] and the Database category in $[officename] Calc.</paragraph> + <paragraph xml-lang="en-US" id="hd_id3150329" role="heading" level="3" l10n="U" + oldref="190">Example Data:</paragraph> + <paragraph xml-lang="en-US" id="par_id3153713" role="paragraph" l10n="U" oldref="191">The following data will be used in some of the function description examples:</paragraph> + <paragraph xml-lang="en-US" id="par_id3155766" role="paragraph" l10n="U" oldref="3">The range A1:E10 lists the children invited to Joe's birthday party. The following information is given for each entry: column A shows the name, B the grade, then age in years, distance to school in meters and weight in kilograms.</paragraph> + <table id="tbl_id3159264"> + <tablerow> + <tablecell> +</tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3145232" role="tablehead" l10n="U" oldref="4">A</paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3146316" role="tablehead" l10n="U" oldref="5">B</paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3150297" role="tablehead" l10n="U" oldref="6">C</paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3150344" role="tablehead" l10n="U" oldref="7">D</paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3150785" role="tablehead" l10n="U" oldref="8">E</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3150090" role="tablecontent" l10n="U" oldref="9">1</paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3152992" role="tablecontent" l10n="U" oldref="10"> +<item type="input">Name</item> +</paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3155532" role="tablecontent" l10n="U" oldref="11"> +<item type="input">Grade</item> +</paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3156448" role="tablecontent" l10n="U" oldref="12"> +<item type="input">Age</item> +</paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3154486" role="tablecontent" l10n="U" oldref="13"> +<item type="input">Distance to School</item> +</paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3152899" role="tablecontent" l10n="U" oldref="14"> +<item type="input">Weight</item> +</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3153816" role="tablecontent" l10n="U" oldref="15">2</paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3151240" role="tablecontent" l10n="U" oldref="16"> +<item type="input">Andy</item> +</paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3156016" role="tablecontent" l10n="U" oldref="17"> +<item type="input">3</item> +</paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3145073" role="tablecontent" l10n="U" oldref="18"> +<item type="input">9</item> +</paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3154956" role="tablecontent" l10n="U" oldref="19"> +<item type="input">150</item> +</paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3153976" role="tablecontent" l10n="U" oldref="20"> +<item type="input">40</item> +</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3150894" role="tablecontent" l10n="U" oldref="21">3</paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3152870" role="tablecontent" l10n="U" oldref="22"> +<item type="input">Betty</item> +</paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3149692" role="tablecontent" l10n="U" oldref="23"> +<item type="input">4</item> +</paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3154652" role="tablecontent" l10n="U" oldref="24"> +<item type="input">10</item> +</paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3149381" role="tablecontent" l10n="U" oldref="25"> +<item type="input">1000</item> +</paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3153812" role="tablecontent" l10n="U" oldref="26"> +<item type="input">42</item> +</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3146965" role="tablecontent" l10n="U" oldref="27">4</paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3155596" role="tablecontent" l10n="U" oldref="28"> +<item type="input">Charles</item> +</paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3147244" role="tablecontent" l10n="U" oldref="29"> +<item type="input">3</item> +</paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3149871" role="tablecontent" l10n="U" oldref="30"> +<item type="input">10</item> +</paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3155752" role="tablecontent" l10n="U" oldref="31"> +<item type="input">300</item> +</paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3149052" role="tablecontent" l10n="U" oldref="32"> +<item type="input">51</item> +</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3146097" role="tablecontent" l10n="U" oldref="33">5</paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3147296" role="tablecontent" l10n="U" oldref="34"> +<item type="input">Daniel</item> +</paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3150393" role="tablecontent" l10n="U" oldref="35"> +<item type="input">5</item> +</paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3145236" role="tablecontent" l10n="U" oldref="36"> +<item type="input">11</item> +</paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3150534" role="tablecontent" l10n="U" oldref="37"> +<item type="input">1200</item> +</paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3150375" role="tablecontent" l10n="U" oldref="38"> +<item type="input">48</item> +</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3159121" role="tablecontent" l10n="U" oldref="39">6</paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3150456" role="tablecontent" l10n="U" oldref="40"> +<item type="input">Eva</item> +</paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3146886" role="tablecontent" l10n="U" oldref="41"> +<item type="input">2</item> +</paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3149945" role="tablecontent" l10n="U" oldref="42"> +<item type="input">8</item> +</paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3157904" role="tablecontent" l10n="U" oldref="43"> +<item type="input">650</item> +</paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3149352" role="tablecontent" l10n="U" oldref="44"> +<item type="input">33</item> +</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3150028" role="tablecontent" l10n="U" oldref="45">7</paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3145826" role="tablecontent" l10n="U" oldref="46"> +<item type="input">F</item> +<item type="input">rank</item> +</paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3150743" role="tablecontent" l10n="U" oldref="47"> +<item type="input">2</item> +</paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3154844" role="tablecontent" l10n="U" oldref="48"> +<item type="input">7</item> +</paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3148435" role="tablecontent" l10n="U" oldref="49"> +<item type="input">3</item> +<item type="input">00</item> +</paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3148882" role="tablecontent" l10n="U" oldref="50"> +<item type="input">4</item> +<item type="input">2</item> +</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3150140" role="tablecontent" l10n="U" oldref="51">8</paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3146137" role="tablecontent" l10n="U" oldref="52"> +<item type="input">Greta</item> +</paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3148739" role="tablecontent" l10n="U" oldref="53"> +<item type="input">1</item> +</paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3148583" role="tablecontent" l10n="U" oldref="54"> +<item type="input">7</item> +</paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3154556" role="tablecontent" l10n="U" oldref="55"> +<item type="input">200</item> +</paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3155255" role="tablecontent" l10n="U" oldref="56"> +<item type="input">36</item> +</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3145141" role="tablecontent" l10n="U" oldref="57">9</paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3153078" role="tablecontent" l10n="U" oldref="58"> +<item type="input">Harry</item> +</paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3149955" role="tablecontent" l10n="U" oldref="59"> +<item type="input">3</item> +</paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3150005" role="tablecontent" l10n="U" oldref="60"> +<item type="input">9</item> +</paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3155951" role="tablecontent" l10n="U" oldref="61"> +<item type="input">1200</item> +</paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3145169" role="tablecontent" l10n="U" oldref="62"> +<item type="input">44</item> +</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3153571" role="tablecontent" l10n="U" oldref="63">10</paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3148761" role="tablecontent" l10n="U" oldref="64"> +<item type="input">Irene</item> +</paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3149877" role="tablecontent" l10n="U" oldref="65"> +<item type="input">2</item> +</paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3154327" role="tablecontent" l10n="U" oldref="66"> +<item type="input">8</item> +</paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3155435" role="tablecontent" l10n="U" oldref="67"> +<item type="input">1000</item> +</paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3145353" role="tablecontent" l10n="U" oldref="68"> +<item type="input">42</item> +</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3150662" role="tablecontent" l10n="U" oldref="69">11</paragraph> + </tablecell> + <tablecell> +</tablecell> + <tablecell> +</tablecell> + <tablecell> +</tablecell> + <tablecell> +</tablecell> + <tablecell> +</tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3150568" role="tablecontent" l10n="U" oldref="70">12</paragraph> + </tablecell> + <tablecell> +</tablecell> + <tablecell> +</tablecell> + <tablecell> +</tablecell> + <tablecell> +</tablecell> + <tablecell> +</tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3149393" role="tablecontent" l10n="U" oldref="71">13</paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3153544" role="tablecontent" l10n="U" oldref="72"> +<item type="input">Name</item> +</paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3158414" role="tablecontent" l10n="U" oldref="73"> +<item type="input">Grade</item> +</paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3152820" role="tablecontent" l10n="U" oldref="74"> +<item type="input">Age</item> +</paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3154866" role="tablecontent" l10n="U" oldref="75"> +<item type="input">Distance to School</item> +</paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3150471" role="tablecontent" l10n="U" oldref="76"> +<item type="input">Weight</item> +</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3153920" role="tablecontent" l10n="U" oldref="77">14</paragraph> + </tablecell> + <tablecell> +</tablecell> + <tablecell> +</tablecell> + <tablecell> +</tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3148429" role="tablecontent" l10n="U" oldref="78"> +<item type="input">>600</item> +</paragraph> + </tablecell> + <tablecell> +</tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3152588" role="tablecontent" l10n="U" oldref="79">15</paragraph> + </tablecell> + <tablecell> +</tablecell> + <tablecell> +</tablecell> + <tablecell> +</tablecell> + <tablecell> +</tablecell> + <tablecell> +</tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3083286" role="tablecontent" l10n="U" oldref="80">16</paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3163823" role="tablecontent" l10n="U" oldref="81"> +<item type="input">DCOUNT</item> +</paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3145083" role="tablecontent" l10n="U" oldref="82"> +<item type="input">5</item> +</paragraph> + </tablecell> + <tablecell> +</tablecell> + <tablecell> +</tablecell> + <tablecell> +</tablecell> + </tablerow> + </table> + + <paragraph xml-lang="en-US" id="par_id3149282" role="paragraph" l10n="U" oldref="83">The formula in cell B16 is =DCOUNT(A1:E10;0;A13:E14)</paragraph> + <paragraph xml-lang="en-US" id="hd_id3150962" role="heading" level="3" l10n="U" + oldref="192">Database Function Parameters:</paragraph> + <paragraph xml-lang="en-US" id="par_id3155837" role="paragraph" l10n="U" oldref="84">The following items are the parameter definitions for all database functions:</paragraph> + <paragraph xml-lang="en-US" id="par_id3149453" role="paragraph" l10n="U" oldref="85"> +<emph>Database</emph> is the cell range defining the database.</paragraph> + <paragraph xml-lang="en-US" id="par_id3151272" role="paragraph" l10n="U" oldref="86"> +<emph>DatabaseField</emph> specifies the column where the function operates on after the search criteria of the first parameter is applied and the data rows are selected. It is not related to the search criteria itself. Use the number 0 to specify the whole data range. <variable id="quotes">To reference a column by means of the column header name, place quotation marks around the header name. +</variable></paragraph> + <paragraph xml-lang="en-US" id="par_id3147083" role="paragraph" l10n="U" oldref="87"> +<emph>SearchCriteria</emph> is the cell range containing search criteria. If you write several criteria in one row they are connected by AND. If you write the criteria in different rows they are connected by OR. Empty cells in the search criteria range will be ignored.</paragraph> + <paragraph xml-lang="en-US" id="par_id3151188" role="paragraph" l10n="U" oldref="188">Choose <switchinline select="sys"><caseinline select="MAC">%PRODUCTNAME - Preferences</caseinline><defaultinline>Tools - Options</defaultinline></switchinline> - <link href="text/shared/optionen/01060500.xhp" name="Spreadsheet - Calculate">%PRODUCTNAME Calc - Calculate</link> to define how $[officename] Calc acts when searching for identical entries.</paragraph> + <paragraph xml-lang="en-US" id="par_id3882869" role="paragraph" l10n="NEW">See also the Wiki page about <link href="http://wiki.documentfoundation.org/Documentation/How_Tos/Conditional_Counting_and_Summation">Conditional Counting and Summation</link>.</paragraph> +<sort order="asc"> +<section id="Section1"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3150882"><bookmark_value>DCOUNT function</bookmark_value> + <bookmark_value>counting rows;with numeric values</bookmark_value> +</bookmark><comment>mw added "counting rows;"</comment> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_DBANZAHL" id="bm_id3152926" localize="false"/> +<paragraph xml-lang="en-US" id="hd_id3150882" role="heading" level="2" l10n="U" + oldref="88">DCOUNT</paragraph> + <paragraph xml-lang="en-US" id="par_id3156133" role="paragraph" l10n="U" oldref="89"><ahelp hid="HID_FUNC_DBANZAHL">DCOUNT counts the number of rows (records) in a database that match the specified search criteria and contain numerical values.</ahelp></paragraph> + <embed href="text/shared/00/00000001.xhp#regulaer"/> + <paragraph xml-lang="en-US" id="hd_id3156099" role="heading" level="3" l10n="U" + oldref="90">Syntax</paragraph> + <paragraph xml-lang="en-US" id="par_id3153218" role="code" l10n="U" oldref="91">DCOUNT(Database; DatabaseField; SearchCriteria)</paragraph> + <paragraph xml-lang="en-US" id="par_id3153273" role="paragraph" l10n="U" oldref="187">For the DatabaseField parameter you can enter a cell to specify the column, or enter the number 0 for the entire database. The parameter cannot be empty. <embedvar href="text/scalc/01/04060101.xhp#quotes"/> +</paragraph> + <paragraph xml-lang="en-US" id="hd_id3154743" role="heading" level="3" l10n="U" + oldref="92">Example</paragraph> + <paragraph xml-lang="en-US" id="par_id3153623" role="paragraph" l10n="U" oldref="93">In the example above (scroll up, please), we want to know how many children have to travel more than 600 meters to school. The result is to be stored in cell B16. Set the cursor in cell B16. Enter the formula <item type="input">=DCOUNT(A1:E10;0;A13:E14)</item> in B16. The <emph>Function Wizard</emph> helps you to input ranges.</paragraph> + <paragraph xml-lang="en-US" id="par_id3149142" role="paragraph" l10n="U" oldref="94"> +<emph>Database</emph> is the range of data to be evaluated, including its headers: in this case A1:E10. <emph>DatabaseField</emph> specifies the column for the search criteria: in this case, the whole database. <emph>SearchCriteria</emph> is the range where you can enter the search parameters: in this case, A13:E14.</paragraph> + <paragraph xml-lang="en-US" id="par_id3145652" role="paragraph" l10n="U" oldref="95">To learn how many children in second grade are over 7 years of age, delete the entry >600 in cell D14 and enter <item type="input">2</item> in cell B14 under Grade, and enter <item type="input">>7</item> in cell C14 to the right. The result is 2. Two children are in second grade and over 7 years of age. As both criteria are in the same row, they are connected by AND.</paragraph> + </section> + <section id="Section2"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3156123"><bookmark_value>DCOUNTA function</bookmark_value> + <bookmark_value>records;counting in Calc databases</bookmark_value> + <bookmark_value>counting rows;with numeric or alphanumeric values</bookmark_value> +</bookmark><comment>mw added "records;" and "counting rows;"</comment> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_DBANZAHL2" id="bm_id3154055" localize="false"/> +<paragraph xml-lang="en-US" id="hd_id3156123" role="heading" level="2" l10n="U" + oldref="97">DCOUNTA</paragraph> + <paragraph xml-lang="en-US" id="par_id3156110" role="paragraph" l10n="U" oldref="98"><ahelp hid="HID_FUNC_DBANZAHL2">DCOUNTA counts the number of rows (records) in a database that match the specified search conditions, and contain numeric or alphanumeric values.</ahelp></paragraph> + <embed href="text/shared/00/00000001.xhp#regulaer"/> + <paragraph xml-lang="en-US" id="hd_id3143228" role="heading" level="3" l10n="U" + oldref="99">Syntax</paragraph> + <paragraph xml-lang="en-US" id="par_id3146893" role="code" l10n="U" oldref="100">DCOUNTA(Database; DatabaseField; SearchCriteria)</paragraph> + <embed href="text/scalc/01/04060101.xhp#quotes"/> + <paragraph xml-lang="en-US" id="hd_id3149751" role="heading" level="3" l10n="U" + oldref="101">Example</paragraph> + <paragraph xml-lang="en-US" id="par_id3153982" role="paragraph" l10n="CHG" oldref="102">In the example above (scroll up, please), you can search for the number of children whose name starts with an E or a subsequent letter. Edit the formula in B16 to read <item type="input">=DCOUNTA(A1:E10;"Name";A13:E14)</item>. Delete the old search criteria and enter <item type="input">>=E</item> under Name in field A14. The result is 5. If you now delete all number values for Greta in row 8, the result changes to 4. Row 8 is no longer included in the count because it does not contain any values. The name Greta is text, not a value. Note that the DatabaseField parameter must point to a column that can contain values.<comment>see i25407</comment></paragraph> + </section> + <section id="Section3"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3147256"><bookmark_value>DGET function</bookmark_value> + <bookmark_value>cell contents;searching in Calc databases</bookmark_value> + <bookmark_value>searching;cell contents in Calc databases</bookmark_value> +</bookmark><comment>mw added "cell contents;" and "searching;"</comment> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_DBAUSZUG" id="bm_id3149198" localize="false"/> +<paragraph xml-lang="en-US" id="hd_id3147256" role="heading" level="2" l10n="U" + oldref="104">DGET</paragraph> + <paragraph xml-lang="en-US" id="par_id3152801" role="paragraph" l10n="U" oldref="105"><ahelp hid="HID_FUNC_DBAUSZUG">DGET returns the contents of the referenced cell in a database which matches the specified search criteria.</ahelp> In case of an error, the function returns either #VALUE! for no row found, or Err502 for more than one cell found.</paragraph> + <embed href="text/shared/00/00000001.xhp#regulaer"/> + <paragraph xml-lang="en-US" id="hd_id3159344" role="heading" level="3" l10n="U" + oldref="106">Syntax</paragraph> + <paragraph xml-lang="en-US" id="par_id3154696" role="code" l10n="U" oldref="107">DGET(Database; DatabaseField; SearchCriteria)</paragraph> + <embed href="text/scalc/01/04060101.xhp#quotes"/> + <paragraph xml-lang="en-US" id="hd_id3153909" role="heading" level="3" l10n="U" + oldref="108">Example</paragraph> + <paragraph xml-lang="en-US" id="par_id3155388" role="paragraph" l10n="U" oldref="109">In the above example (scroll up, please), we want to determine what grade a child is in, whose name was entered in cell A14. The formula is entered in cell B16 and differs slightly from the earlier examples because only one column (one database field) can be entered for <emph>DatabaseField</emph>. Enter the following formula:</paragraph> + <paragraph xml-lang="en-US" id="par_id3153096" role="paragraph" l10n="U" oldref="110"> +<item type="input">=DGET(A1:E10;"Grade";A13:E14)</item> +</paragraph> + <paragraph xml-lang="en-US" id="par_id3150524" role="paragraph" l10n="U" oldref="111">Enter the name <item type="input">Frank</item> in A14, and you see the result 2. Frank is in second grade. Enter <item type="input">"Age"</item> instead of "Grade" and you will get Frank's age.</paragraph> + <paragraph xml-lang="en-US" id="par_id3148833" role="paragraph" l10n="U" oldref="112">Or enter the value <item type="input">11</item> in cell C14 only, and delete the other entries in this row. Edit the formula in B16 as follows:</paragraph> + <paragraph xml-lang="en-US" id="par_id3149912" role="paragraph" l10n="U" oldref="113"> +<item type="input">=DGET(A1:E10;"Name";A13:E14)</item> +</paragraph> + <paragraph xml-lang="en-US" id="par_id3148813" role="paragraph" l10n="U" oldref="114">Instead of the grade, the name is queried. The answer appears at once: Daniel is the only child aged 11.</paragraph> + </section> + <section id="Section4"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3149766"><bookmark_value>DMAX function</bookmark_value> + <bookmark_value>maximum values in Calc databases</bookmark_value> + <bookmark_value>searching;maximum values in columns</bookmark_value> +</bookmark><comment>mw added "maximum..." and "searching;"</comment> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_DBMAX" id="bm_id3158401" localize="false"/> +<paragraph xml-lang="en-US" id="hd_id3149766" role="heading" level="2" l10n="U" + oldref="115">DMAX</paragraph> + <paragraph xml-lang="en-US" id="par_id3154903" role="paragraph" l10n="U" oldref="116"><ahelp hid="HID_FUNC_DBMAX">DMAX returns the maximum content of a cell (field) in a database (all records) that matches the specified search conditions.</ahelp></paragraph> + <embed href="text/shared/00/00000001.xhp#regulaer"/> + <paragraph xml-lang="en-US" id="hd_id3150771" role="heading" level="3" l10n="U" + oldref="117">Syntax</paragraph> + <paragraph xml-lang="en-US" id="par_id3159157" role="code" l10n="U" oldref="118">DMAX(Database; DatabaseField; SearchCriteria)</paragraph> + <embed href="text/scalc/01/04060101.xhp#quotes"/> + <paragraph xml-lang="en-US" id="hd_id3145420" role="heading" level="3" l10n="U" + oldref="119">Example</paragraph> + <paragraph xml-lang="en-US" id="par_id3148442" role="paragraph" l10n="U" oldref="120">To find out how much the heaviest child in each grade weighed in the above example (scroll up, please), enter the following formula in B16:</paragraph> + <paragraph xml-lang="en-US" id="par_id3148804" role="paragraph" l10n="U" oldref="121"> +<item type="input">=DMAX(A1:E10;"Weight";A13:E14)</item> +</paragraph> + <paragraph xml-lang="en-US" id="par_id3150510" role="paragraph" l10n="U" oldref="122">Under Grade, enter <item type="input">1, 2, 3,</item> and so on, one after the other. After entering a grade number, the weight of the heaviest child in that grade appears.</paragraph> + </section> + <section id="Section5"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3159141"><bookmark_value>DMIN function</bookmark_value> + <bookmark_value>minimum values in Calc databases</bookmark_value> + <bookmark_value>searching;minimum values in columns</bookmark_value> +</bookmark><comment>mw added "minimum..." and "searching;"</comment> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_DBMIN" id="bm_id3159152" localize="false"/> +<paragraph xml-lang="en-US" id="hd_id3159141" role="heading" level="2" l10n="U" + oldref="123">DMIN</paragraph> + <paragraph xml-lang="en-US" id="par_id3154261" role="paragraph" l10n="U" oldref="124"><ahelp hid="HID_FUNC_DBMIN">DMIN returns the minimum content of a cell (field) in a database that matches the specified search criteria.</ahelp></paragraph> + <embed href="text/shared/00/00000001.xhp#regulaer"/> + <paragraph xml-lang="en-US" id="hd_id3147238" role="heading" level="3" l10n="U" + oldref="125">Syntax</paragraph> + <paragraph xml-lang="en-US" id="par_id3148479" role="code" l10n="U" oldref="126">DMIN(Database; DatabaseField; SearchCriteria)</paragraph> + <embed href="text/scalc/01/04060101.xhp#quotes"/> + <paragraph xml-lang="en-US" id="hd_id3151050" role="heading" level="3" l10n="U" + oldref="127">Example</paragraph> + <paragraph xml-lang="en-US" id="par_id3148925" role="paragraph" l10n="U" oldref="128">To find the shortest distance to school for the children in each grade in the above example (scroll up, please), enter the following formula in B16:</paragraph> + <paragraph xml-lang="en-US" id="par_id3149161" role="paragraph" l10n="U" oldref="129"> +<item type="input">=DMIN(A1:E10;"Distance to School";A13:E14)</item> +</paragraph> + <paragraph xml-lang="en-US" id="par_id3148917" role="paragraph" l10n="U" oldref="130">In row 14, under Grade, enter <item type="input">1, 2, 3,</item> and so on, one after the other. The shortest distance to school for each grade appears.</paragraph> + </section> + <section id="Section6"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3154274"><bookmark_value>DAVERAGE function</bookmark_value> + <bookmark_value>averages; in Calc databases</bookmark_value> + <bookmark_value>calculating;averages in Calc databases</bookmark_value> +</bookmark><comment>mw added "averages;..." and "calculating;"</comment> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_DBMITTELWERT" id="bm_id3166435" localize="false"/> +<paragraph xml-lang="en-US" id="hd_id3154274" role="heading" level="2" l10n="U" + oldref="131">DAVERAGE</paragraph> + <paragraph xml-lang="en-US" id="par_id3166453" role="paragraph" l10n="U" oldref="132"><ahelp hid="HID_FUNC_DBMITTELWERT">DAVERAGE returns the average of the values of all cells (fields) in all rows (database records) that match the specified search criteria.</ahelp></paragraph> + <embed href="text/shared/00/00000001.xhp#regulaer"/> + <paragraph xml-lang="en-US" id="hd_id3146955" role="heading" level="3" l10n="U" + oldref="133">Syntax</paragraph> + <paragraph xml-lang="en-US" id="par_id3150710" role="code" l10n="U" oldref="134">DAVERAGE(Database; DatabaseField; SearchCriteria)</paragraph> + <embed href="text/scalc/01/04060101.xhp#quotes"/> + <paragraph xml-lang="en-US" id="hd_id3152943" role="heading" level="3" l10n="U" + oldref="135">Example</paragraph> + <paragraph xml-lang="en-US" id="par_id3149104" role="paragraph" l10n="U" oldref="136">To find the average weight of all children of the same age in the above example (scroll up, please), enter the following formula in B16:</paragraph> + <paragraph xml-lang="en-US" id="par_id3153688" role="paragraph" l10n="U" oldref="137"> +<item type="input">=DAVERAGE(A1:E10;"Weight";A13:E14)</item> +</paragraph> + <paragraph xml-lang="en-US" id="par_id3155587" role="paragraph" l10n="U" oldref="138">In row 14, under Age, enter <item type="input">7, 8, 9,</item> and so on, one after the other. The average weight of all children of the same age appears.</paragraph> + </section> + <section id="Section7"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3159269"><bookmark_value>DPRODUCT function</bookmark_value> + <bookmark_value>multiplying;cell contents in Calc databases</bookmark_value> +</bookmark><comment>mw added "multiplying..."</comment> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_DBPRODUKT" id="bm_id3159281" localize="false"/> +<paragraph xml-lang="en-US" id="hd_id3159269" role="heading" level="2" l10n="U" + oldref="139">DPRODUCT</paragraph> + <paragraph xml-lang="en-US" id="par_id3152879" role="paragraph" l10n="U" oldref="140"><ahelp hid="HID_FUNC_DBPRODUKT">DPRODUCT multiplies all cells of a data range where the cell contents match the search criteria.</ahelp></paragraph> + <embed href="text/shared/00/00000001.xhp#regulaer"/> + <paragraph xml-lang="en-US" id="hd_id3149966" role="heading" level="3" l10n="U" + oldref="141">Syntax</paragraph> + <paragraph xml-lang="en-US" id="par_id3154854" role="code" l10n="U" oldref="142">DPRODUCT(Database; DatabaseField; SearchCriteria)</paragraph> + <embed href="text/scalc/01/04060101.xhp#quotes"/> + <paragraph xml-lang="en-US" id="hd_id3149802" role="heading" level="3" l10n="U" + oldref="143">Example</paragraph> + <paragraph xml-lang="en-US" id="par_id3148986" role="paragraph" l10n="U" oldref="144">With the birthday party example above (scroll up, please), there is no meaningful application of this function.</paragraph> + </section> + <section id="Section8"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3148462"><bookmark_value>DSTDEV function</bookmark_value> + <bookmark_value>standard deviations in databases;based on a sample</bookmark_value> +</bookmark><comment>mw added "standard deviations...;"</comment> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_DBSTDABW" id="bm_id3145370" localize="false"/> +<paragraph xml-lang="en-US" id="hd_id3148462" role="heading" level="2" l10n="U" + oldref="145">DSTDEV</paragraph> + <paragraph xml-lang="en-US" id="par_id3154605" role="paragraph" l10n="U" oldref="146"><ahelp hid="HID_FUNC_DBSTDABW">DSTDEV calculates the standard deviation of a population based on a sample, using the numbers in a database column that match the given conditions.</ahelp> The records are treated as a sample of data. That means that the children in the example represent a cross section of all children. Note that a representative result can not be obtained from a sample of less than one thousand.</paragraph> + <embed href="text/shared/00/00000001.xhp#regulaer"/> + <paragraph xml-lang="en-US" id="hd_id3149427" role="heading" level="3" l10n="U" + oldref="147">Syntax</paragraph> + <paragraph xml-lang="en-US" id="par_id3148661" role="code" l10n="U" oldref="148">DSTDEV(Database; DatabaseField; SearchCriteria)</paragraph> + <embed href="text/scalc/01/04060101.xhp#quotes"/> + <paragraph xml-lang="en-US" id="hd_id3153945" role="heading" level="3" l10n="U" + oldref="149">Example</paragraph> + <paragraph xml-lang="en-US" id="par_id3149934" role="paragraph" l10n="U" oldref="150">To find the standard deviation of the weight for all children of the same age in the example (scroll up, please), enter the following formula in B16:</paragraph> + <paragraph xml-lang="en-US" id="par_id3150630" role="paragraph" l10n="U" oldref="151"> +<item type="input">=DSTDEV(A1:E10;"Weight";A13:E14)</item> +</paragraph> + <paragraph xml-lang="en-US" id="par_id3153536" role="paragraph" l10n="U" oldref="152">In row 14, under Age, enter <item type="input">7, 8, 9,</item> and so on, one after the other. The result shown is the standard deviation of the weight of all children of this age.</paragraph> + </section> + <section id="Section9"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3150429"><bookmark_value>DSTDEVP function</bookmark_value> + <bookmark_value>standard deviations in databases;based on populations</bookmark_value> +</bookmark><comment>mw added "standard deviations...;"</comment> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_DBSTDABWN" id="bm_id3149523" localize="false"/> +<paragraph xml-lang="en-US" id="hd_id3150429" role="heading" level="2" l10n="U" + oldref="153">DSTDEVP</paragraph> + <paragraph xml-lang="en-US" id="par_id3145598" role="paragraph" l10n="U" oldref="154"><ahelp hid="HID_FUNC_DBSTDABWN">DSTDEVP calculates the standard deviation of a population based on all cells of a data range which match the search criteria.</ahelp> The records from the example are treated as the whole population.</paragraph> + <embed href="text/shared/00/00000001.xhp#regulaer"/> + <paragraph xml-lang="en-US" id="hd_id3145307" role="heading" level="3" l10n="U" + oldref="155">Syntax</paragraph> + <paragraph xml-lang="en-US" id="par_id3149484" role="code" l10n="U" oldref="156">DSTDEVP(Database; DatabaseField; SearchCriteria)</paragraph> + <embed href="text/scalc/01/04060101.xhp#quotes"/> + <paragraph xml-lang="en-US" id="hd_id3153322" role="heading" level="3" l10n="U" + oldref="157">Example</paragraph> + <paragraph xml-lang="en-US" id="par_id3155431" role="paragraph" l10n="U" oldref="158">To find the standard deviation of the weight for all children of the same age at Joe's birthday party (scroll up, please), enter the following formula in B16:</paragraph> + <paragraph xml-lang="en-US" id="par_id3148411" role="paragraph" l10n="U" oldref="159"> +<item type="input">=DSTDEVP(A1:E10;"Weight";A13:E14)</item> +</paragraph> + <paragraph xml-lang="en-US" id="par_id3143271" role="paragraph" l10n="U" oldref="160">In row 14, under Age, enter <item type="input">7, 8, 9,</item> and so on, one after the other. The result is the standard deviation of the weight for all same-aged children whose weight was checked.</paragraph> + </section> + <section id="Section10"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3154794"><bookmark_value>DSUM function</bookmark_value> + <bookmark_value>calculating;sums in Calc databases</bookmark_value> + <bookmark_value>sums;cells in Calc databases</bookmark_value> +</bookmark><comment>mw added "calculating;" and "sums;"</comment> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_DBSUMME" id="bm_id3148687" localize="false"/> +<paragraph xml-lang="en-US" id="hd_id3154794" role="heading" level="2" l10n="U" + oldref="161">DSUM</paragraph> + <paragraph xml-lang="en-US" id="par_id3149591" role="paragraph" l10n="U" oldref="162"><ahelp hid="HID_FUNC_DBSUMME">DSUM returns the total of all cells in a database field in all rows (records) that match the specified search criteria.</ahelp></paragraph> + <embed href="text/shared/00/00000001.xhp#regulaer"/> + <paragraph xml-lang="en-US" id="hd_id3146128" role="heading" level="3" l10n="U" + oldref="163">Syntax</paragraph> + <paragraph xml-lang="en-US" id="par_id3150989" role="code" l10n="U" oldref="164">DSUM(Database; DatabaseField; SearchCriteria)</paragraph> + <embed href="text/scalc/01/04060101.xhp#quotes"/> + <paragraph xml-lang="en-US" id="hd_id3159079" role="heading" level="3" l10n="U" + oldref="165">Example</paragraph> + <paragraph xml-lang="en-US" id="par_id3152766" role="paragraph" l10n="U" oldref="166">To find the length of the combined distance to school of all children at Joe's birthday party (scroll up, please) who are in second grade, enter the following formula in B16:</paragraph> + <paragraph xml-lang="en-US" id="par_id3151312" role="paragraph" l10n="U" oldref="167"> +<item type="input">=DSUM(A1:E10;"Distance to School";A13:E14)</item> +</paragraph> + <paragraph xml-lang="en-US" id="par_id3150596" role="paragraph" l10n="U" oldref="168">Enter <item type="input">2</item> in row 14 under Grade. The sum (1950) of the distances to school of all the children who are in second grade is displayed.</paragraph> + </section> + <section id="Section11"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3155614"><bookmark_value>DVAR function</bookmark_value> + <bookmark_value>variances;based on samples</bookmark_value> +</bookmark><comment>mw added "variances;"</comment> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_DBVARIANZ" id="bm_id3159391" localize="false"/> +<paragraph xml-lang="en-US" id="hd_id3155614" role="heading" level="2" l10n="U" + oldref="170">DVAR</paragraph> + <paragraph xml-lang="en-US" id="par_id3154418" role="paragraph" l10n="U" oldref="171"><ahelp hid="HID_FUNC_DBVARIANZ">DVAR returns the variance of all cells of a database field in all records that match the specified search criteria.</ahelp> The records from the example are treated as a sample of data. A representative result cannot be obtained from a sample population of less than one thousand.</paragraph> + <embed href="text/shared/00/00000001.xhp#regulaer"/> + <paragraph xml-lang="en-US" id="hd_id3154825" role="heading" level="3" l10n="U" + oldref="172">Syntax</paragraph> + <paragraph xml-lang="en-US" id="par_id3156138" role="code" l10n="U" oldref="173">DVAR(Database; DatabaseField; SearchCriteria)</paragraph> + <embed href="text/scalc/01/04060101.xhp#quotes"/> + <paragraph xml-lang="en-US" id="hd_id3151257" role="heading" level="3" l10n="U" + oldref="174">Example</paragraph> + <paragraph xml-lang="en-US" id="par_id3153701" role="paragraph" l10n="U" oldref="175">To find the variance of the weight of all children of the same age of the above example (scroll up, please), enter the following formula in B16:</paragraph> + <paragraph xml-lang="en-US" id="par_id3153676" role="paragraph" l10n="U" oldref="176"> +<item type="input">=DVAR(A1:E10;"Weight";A13:E14)</item> +</paragraph> + <paragraph xml-lang="en-US" id="par_id3153798" role="paragraph" l10n="U" oldref="177">In row 14, under Age, enter <item type="input">7, 8, 9,</item> and so on, one after the other. You will see as a result the variance of the weight values for all children of this age.</paragraph> + </section> + <section id="Section12"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3153880"><bookmark_value>DVARP function</bookmark_value> + <bookmark_value>variances;based on populations</bookmark_value> +</bookmark><comment>mw added "variances;"</comment> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_DBVARIANZEN" id="bm_id3153891" localize="false"/> +<paragraph xml-lang="en-US" id="hd_id3153880" role="heading" level="2" l10n="U" + oldref="178">DVARP</paragraph> + <paragraph xml-lang="en-US" id="par_id3155119" role="paragraph" l10n="U" oldref="179"><ahelp hid="HID_FUNC_DBVARIANZEN">DVARP calculates the variance of all cell values in a database field in all records that match the specified search criteria.</ahelp> The records are from the example are treated as an entire population.</paragraph> + <embed href="text/shared/00/00000001.xhp#regulaer"/> + <paragraph xml-lang="en-US" id="hd_id3145774" role="heading" level="3" l10n="U" + oldref="180">Syntax</paragraph> + <paragraph xml-lang="en-US" id="par_id3153776" role="code" l10n="U" oldref="181">DVARP(Database; DatabaseField; SearchCriteria)</paragraph> + <embed href="text/scalc/01/04060101.xhp#quotes"/> + <paragraph xml-lang="en-US" id="hd_id3151110" role="heading" level="3" l10n="U" + oldref="182">Example</paragraph> + <paragraph xml-lang="en-US" id="par_id3147099" role="paragraph" l10n="U" oldref="183">To find the variance of the weight for all children of the same age at Joe's birthday party (scroll up, please), enter the following formula in B16:</paragraph> + <paragraph xml-lang="en-US" id="par_id3147322" role="paragraph" l10n="U" oldref="184"> +<item type="input">=DVARP(A1:E10;"Weight";A13:E14)</item> +</paragraph> + <paragraph xml-lang="en-US" id="par_id3146902" role="paragraph" l10n="U" oldref="185">In row 14, under Age, enter <item type="input">7, 8, 9,</item> and so on, one after the other. The variance of the weight values for all children of this age attending Joe's birthday party appears.</paragraph> + </section> +</sort> +<section id="relatedtopics"> + <embed href="text/scalc/01/04060100.xhp#drking"/> + </section> + </body> +</helpdocument>
\ No newline at end of file diff --git a/source/text/scalc/01/04060102.xhp b/source/text/scalc/01/04060102.xhp new file mode 100644 index 0000000000..8d4912fba1 --- /dev/null +++ b/source/text/scalc/01/04060102.xhp @@ -0,0 +1,224 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> + +<!-- +*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************ + --> + + +<meta> +<topic id="textscalc0104060102xml" indexer="include"> +<title id="tit" xml-lang="en-US">Date & Time Functions</title> +<filename>/text/scalc/01/04060102.xhp</filename> +</topic> +</meta> +<body> +<bookmark xml-lang="en-US" branch="index" id="bm_id3154536"><bookmark_value>date and time functions</bookmark_value> +<bookmark_value>functions; date & time</bookmark_value> +<bookmark_value>Function Wizard; date & time</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3154536" xml-lang="en-US" level="1" l10n="U" oldref="1">Date & Time Functions</paragraph> +<paragraph role="paragraph" id="par_id3153973" xml-lang="en-US" l10n="U" oldref="2"><variable id="datumzeittext">These spreadsheet functions are used for inserting and editing dates and times. +</variable></paragraph> +<section id="howtoget"> +<embed href="text/scalc/00/00000404.xhp#eikadaze"/> +</section> +<section id="ADD_note"> +<paragraph role="note" id="par_idN10600" xml-lang="en-US" l10n="NEW">The functions whose names end with _ADD return the same results as the corresponding Microsoft Excel functions. Use the functions without _ADD to get results based on international standards. For example, the WEEKNUM function calculates the week number of a given date based on international standard ISO 8601, while WEEKNUM_ADD returns the same week number as Microsoft Excel.<comment>UFI: see #33784#</comment></paragraph> +</section> +<paragraph role="paragraph" id="par_id3150437" xml-lang="en-US" l10n="U" oldref="170">$[officename] internally handles a date/time value as a numerical value. If you assign the numbering format "Number" to a date or time value, it is converted to a number. For example, 01/01/2000 12:00 PM, converts to 36526.5. The value preceding the decimal point corresponds to the date; the value following the decimal point corresponds to the time. If you do not want to see this type of numerical date or time representation, change the number format (date or time) accordingly. To do this, select the cell containing the date or time value, call its context menu and select <emph>Format Cells</emph>. The <emph>Numbers</emph> tab page contains the functions for defining the number format.</paragraph> +<paragraph role="heading" id="hd_id2408825" xml-lang="en-US" level="2" l10n="NEW">Date base for day zero</paragraph> +<paragraph role="paragraph" id="par_id9988402" xml-lang="en-US" l10n="NEW">Dates are calculated as offsets from a starting day zero. You can set the day zero to be one of the following:</paragraph> +<table id="tbl_id1661427"> +<tablerow> +<tablecell> +<paragraph role="tablehead" id="par_id6401257" xml-lang="en-US" l10n="NEW">Date base</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablehead" id="par_id5841242" xml-lang="en-US" l10n="NEW">Use</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph role="tablecontent" id="par_id6794030" xml-lang="en-US" l10n="CHG">'12/30/1899'</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablecontent" id="par_id7096774" xml-lang="en-US" l10n="NEW">(default)</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph role="tablecontent" id="par_id5699942" xml-lang="en-US" l10n="CHG">'01/01/1900'</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablecontent" id="par_id6420484" xml-lang="en-US" l10n="NEW">(used in former StarCalc 1.0)</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph role="tablecontent" id="par_id6986602" xml-lang="en-US" l10n="CHG">'01/01/1904'</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablecontent" id="par_id616779" xml-lang="en-US" l10n="NEW">(used in Apple software)</paragraph> +</tablecell> +</tablerow> +</table> + +<paragraph role="paragraph" id="par_id791039" xml-lang="en-US" l10n="NEW">Choose <emph><switchinline select="sys"><caseinline select="MAC">%PRODUCTNAME - Preferences</caseinline><defaultinline>Tools - Options</defaultinline></switchinline> - %PRODUCTNAME Calc - Calculate</emph> to select the date base.</paragraph> +<paragraph role="warning" id="par_id1953489" xml-lang="en-US" l10n="NEW">When you copy and paste cells containing date values between different spreadsheets, both spreadsheet documents must be set to the same date base. If date bases differ, the displayed date values will change!</paragraph> +<paragraph role="heading" id="hd_id757469" xml-lang="en-US" level="2" l10n="NEW">Two digits years</paragraph> +<paragraph role="paragraph" id="par_id3149720" xml-lang="en-US" l10n="U" oldref="183">In <emph><switchinline select="sys"><caseinline select="MAC">%PRODUCTNAME - Preferences</caseinline><defaultinline>Tools - Options</defaultinline></switchinline> - $[officename] - General</emph> you find the area <emph>Year (two digits)</emph>. This sets the period for which two-digit information applies. Note that changes made here have an effect on some of the following functions.</paragraph> +<paragraph role="note" id="par_id3150654" xml-lang="en-US" l10n="U" oldref="185">When entering dates, slashes or dashes used as date separators may be interpreted as arithmetic operators. Therefore, dates entered in this format are not always recognized as dates and result in erroneous calculations. To keep dates from being interpreted as parts of formulas, place them in quotation marks, for example, "07/20/54".</paragraph> +<paragraph role="heading" id="par_idN1067A" xml-lang="en-US" level="2" l10n="NEW">Functions</paragraph> +<sort order="asc"> +<section id="workday"> +<paragraph role="paragraph" id="par_idN10683" xml-lang="en-US" l10n="NEW"> +<embedvar href="text/scalc/01/func_workday.xhp#workday"/> +</paragraph> +</section> +<section id="yearfrac"> +<paragraph role="paragraph" id="par_id5189062" xml-lang="en-US" l10n="NEW"> +<embedvar href="text/scalc/01/func_yearfrac.xhp#yearfrac"/> +</paragraph> +</section> +<section id="date"> +<paragraph role="paragraph" id="par_id6854457" xml-lang="en-US" l10n="NEW"> +<embedvar href="text/scalc/01/func_date.xhp#date"/> +</paragraph> +</section> +<section id="datedif"> +<paragraph role="paragraph" id="par_id6354457" xml-lang="en-US" l10n="NEW"> +<embedvar href="text/scalc/01/func_datedif.xhp#datedif"/> +</paragraph> +</section> +<section id="datevalue"> +<paragraph role="paragraph" id="par_id3372295" xml-lang="en-US" l10n="NEW"> +<embedvar href="text/scalc/01/func_datevalue.xhp#datevalue"/> +</paragraph> +</section> +<section id="edate"> +<paragraph role="paragraph" id="par_id5684377" xml-lang="en-US" l10n="NEW"> +<embedvar href="text/scalc/01/func_edate.xhp#edate"/> +</paragraph> +</section> +<section id="today"> +<paragraph role="paragraph" id="par_id7576525" xml-lang="en-US" l10n="NEW"> +<embedvar href="text/scalc/01/func_today.xhp#today"/> +</paragraph> +</section> +<section id="year"> +<paragraph role="paragraph" id="par_id641193" xml-lang="en-US" l10n="NEW"> +<embedvar href="text/scalc/01/func_year.xhp#year"/> +</paragraph> +</section> +<section id="now"> +<paragraph role="paragraph" id="par_id6501968" xml-lang="en-US" l10n="NEW"> +<embedvar href="text/scalc/01/func_now.xhp#now"/> +</paragraph> +</section> +<section id="weeknum"> +<paragraph role="paragraph" id="par_id3886532" xml-lang="en-US" l10n="NEW"> +<embedvar href="text/scalc/01/func_weeknum.xhp#weeknum"/> +</paragraph> +</section> +<section id="weeknumadd"> +<paragraph role="paragraph" id="par_id614947" xml-lang="en-US" l10n="NEW"> +<embedvar href="text/scalc/01/func_weeknumadd.xhp#weeknumadd"/> +</paragraph> +</section> +<section id="minute"> +<paragraph role="paragraph" id="par_id3953062" xml-lang="en-US" l10n="NEW"> +<embedvar href="text/scalc/01/func_minute.xhp#minute"/> +</paragraph> +</section> +<section id="month"> +<paragraph role="paragraph" id="par_id2579729" xml-lang="en-US" l10n="NEW"> +<embedvar href="text/scalc/01/func_month.xhp#month"/> +</paragraph> +</section> +<section id="eomonth"> +<paragraph role="paragraph" id="par_id1346781" xml-lang="en-US" l10n="NEW"> +<embedvar href="text/scalc/01/func_eomonth.xhp#eomonth"/> +</paragraph> +</section> +<section id="networkdays"> +<paragraph role="paragraph" id="par_id8951384" xml-lang="en-US" l10n="NEW"> +<embedvar href="text/scalc/01/func_networkdays.xhp#networkdays"/> +</paragraph> +</section> +<section id="eastersunday"> +<paragraph role="paragraph" id="par_id1074251" xml-lang="en-US" l10n="NEW"> +<embedvar href="text/scalc/01/func_eastersunday.xhp#eastersunday"/> +</paragraph> +</section> +<section id="second"> +<paragraph role="paragraph" id="par_id372325" xml-lang="en-US" l10n="NEW"> +<embedvar href="text/scalc/01/func_second.xhp#second"/> +</paragraph> +</section> +<section id="hour"> +<paragraph role="paragraph" id="par_id224005" xml-lang="en-US" l10n="NEW"> +<embedvar href="text/scalc/01/func_hour.xhp#hour"/> +</paragraph> +</section> +<section id="day"> +<paragraph role="paragraph" id="par_id5375835" xml-lang="en-US" l10n="NEW"> +<embedvar href="text/scalc/01/func_day.xhp#day"/> +</paragraph> +</section> +<section id="days"> +<paragraph role="paragraph" id="par_id1208838" xml-lang="en-US" l10n="NEW"> +<embedvar href="text/scalc/01/func_days.xhp#days"/> +</paragraph> +</section> +<section id="days360"> +<paragraph role="paragraph" id="par_id7679982" xml-lang="en-US" l10n="NEW"> +<embedvar href="text/scalc/01/func_days360.xhp#days360"/> +</paragraph> +</section> +<section id="weekday"> +<paragraph role="paragraph" id="par_id9172643" xml-lang="en-US" l10n="NEW"> +<embedvar href="text/scalc/01/func_weekday.xhp#weekday"/> +</paragraph> +</section> +<section id="time"> +<paragraph role="paragraph" id="par_id2354503" xml-lang="en-US" l10n="NEW"> +<embedvar href="text/scalc/01/func_time.xhp#time"/> +</paragraph> +</section> +<section id="timevalue"> +<paragraph role="paragraph" id="par_id7765434" xml-lang="en-US" l10n="NEW"> +<embedvar href="text/scalc/01/func_timevalue.xhp#timevalue"/> +</paragraph> +</section> +</sort> +<section id="relatedtopics"> +<embed href="text/scalc/01/04060100.xhp#drking"/> +</section> +</body> +</helpdocument> diff --git a/source/text/scalc/01/04060103.xhp b/source/text/scalc/01/04060103.xhp new file mode 100644 index 0000000000..28573f43ae --- /dev/null +++ b/source/text/scalc/01/04060103.xhp @@ -0,0 +1,779 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> + +<!-- +*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************ + --> + + +<meta> + <topic id="textscalc0104060103xml" indexer="include"> + <title xml-lang="en-US" id="tit">Financial Functions Part One</title> + <filename>/text/scalc/01/04060103.xhp</filename> + </topic> + </meta> + <body> +<bookmark xml-lang="en-US" branch="index" id="bm_id3143284"><bookmark_value>financial functions</bookmark_value> + <bookmark_value>functions; financial functions</bookmark_value> + <bookmark_value>Function Wizard; financial</bookmark_value> + <bookmark_value>amortizations, see also depreciations</bookmark_value> +</bookmark><comment>mw added one entry</comment> +<paragraph xml-lang="en-US" id="hd_id3143284" role="heading" level="1" l10n="U" oldref="1">Financial Functions Part One</paragraph> + <paragraph xml-lang="en-US" id="par_id3149095" role="paragraph" l10n="CHG" oldref="2"><variable id="finanztext">This category contains the mathematical finance functions of <item type="productname">%PRODUCTNAME</item> Calc. +</variable></paragraph> +<sort order="asc"> +<section id="amordegrc"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3153366"><bookmark_value>AMORDEGRC function</bookmark_value> + <bookmark_value>depreciations;degressive amortizations</bookmark_value> +</bookmark><comment>mw added one entry</comment> +<bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_AMORDEGRC" id="bm_id3152578" localize="false"/> +<paragraph xml-lang="en-US" id="hd_id3153366" role="heading" level="2" l10n="U" + oldref="359">AMORDEGRC</paragraph> + <paragraph xml-lang="en-US" id="par_id3147434" role="paragraph" l10n="U" oldref="360"><ahelp hid="HID_AAI_FUNC_AMORDEGRC">Calculates the amount of depreciation for a settlement period as degressive amortization.</ahelp> Unlike AMORLINC, a depreciation coefficient that is independent of the depreciable life is used here.</paragraph> + <paragraph xml-lang="en-US" id="hd_id3155855" role="heading" level="3" l10n="U" + oldref="361">Syntax</paragraph> + <paragraph xml-lang="en-US" id="par_id3147427" role="code" l10n="U" oldref="362">AMORDEGRC(Cost; DatePurchased; FirstPeriod; Salvage; Period; Rate; Basis)</paragraph> + <paragraph xml-lang="en-US" id="par_id3147125" role="paragraph" l10n="U" oldref="363"> + <emph>Cost</emph> is the acquisition costs.</paragraph> + <paragraph xml-lang="en-US" id="par_id3151074" role="paragraph" l10n="U" oldref="364"> + <emph>DatePurchased</emph> is the date of acquisition.</paragraph> + <paragraph xml-lang="en-US" id="par_id3144765" role="paragraph" l10n="U" oldref="365"> + <emph>FirstPeriod </emph>is the end date of the first settlement period.</paragraph> + <paragraph xml-lang="en-US" id="par_id3156286" role="paragraph" l10n="U" oldref="366"> + <emph>Salvage</emph> is the salvage value of the capital asset at the end of the depreciable life.</paragraph> + <paragraph xml-lang="en-US" id="par_id3153415" role="paragraph" l10n="U" oldref="367"> + <emph>Period</emph> is the settlement period to be considered.</paragraph> + <paragraph xml-lang="en-US" id="par_id3155064" role="paragraph" l10n="U" oldref="368"> + <emph>Rate</emph> is the rate of depreciation.</paragraph> + <embed href="text/scalc/01/func_yearfrac.xhp#basis"/> + </section> + <section id="amorlinc"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3153765"><bookmark_value>AMORLINC function</bookmark_value> + <bookmark_value>depreciations;linear amortizations</bookmark_value> +</bookmark><comment>mw added "depreciations;..."</comment> +<bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_AMORLINC" id="bm_id3153711" localize="false"/> +<paragraph xml-lang="en-US" id="hd_id3153765" role="heading" level="2" l10n="U" + oldref="369">AMORLINC</paragraph> + <paragraph xml-lang="en-US" id="par_id3159264" role="paragraph" l10n="U" oldref="370"><ahelp hid="HID_AAI_FUNC_AMORLINC">Calculates the amount of depreciation for a settlement period as linear amortization. If the capital asset is purchased during the settlement period, the proportional amount of depreciation is considered.</ahelp></paragraph> + <paragraph xml-lang="en-US" id="hd_id3150044" role="heading" level="3" l10n="U" + oldref="371">Syntax</paragraph> + <paragraph xml-lang="en-US" id="par_id3147363" role="code" l10n="U" oldref="372">AMORLINC(Cost; DatePurchased; FirstPeriod; Salvage; Period; Rate; Basis)</paragraph> + <paragraph xml-lang="en-US" id="par_id3146920" role="paragraph" l10n="U" oldref="373"> + <emph>Cost</emph> means the acquisition costs.</paragraph> + <paragraph xml-lang="en-US" id="par_id3163807" role="paragraph" l10n="U" oldref="374"> + <emph>DatePurchased</emph> is the date of acquisition.</paragraph> + <paragraph xml-lang="en-US" id="par_id3148488" role="paragraph" l10n="U" oldref="375"> + <emph>FirstPeriod </emph>is the end date of the first settlement period.</paragraph> + <paragraph xml-lang="en-US" id="par_id3149530" role="paragraph" l10n="U" oldref="376"> + <emph>Salvage</emph> is the salvage value of the capital asset at the end of the depreciable life.</paragraph> + <paragraph xml-lang="en-US" id="par_id3148633" role="paragraph" l10n="U" oldref="377"> + <emph>Period</emph> is the settlement period to be considered.</paragraph> + <paragraph xml-lang="en-US" id="par_id3150982" role="paragraph" l10n="U" oldref="378"> + <emph>Rate</emph> is the rate of depreciation.</paragraph> + <embed href="text/scalc/01/func_yearfrac.xhp#basis"/> + </section> + <section id="accrint"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3145257"><bookmark_value>ACCRINT function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_ACCRINT" id="bm_id3149815" localize="false"/> +<paragraph xml-lang="en-US" id="hd_id3145257" role="heading" level="2" l10n="U" + oldref="335">ACCRINT</paragraph> +<bookmark xml-lang="en-US" branch="index" id="bm_id3151276"><bookmark_value>accrued interests;periodic payments</bookmark_value> +</bookmark><comment>mw changed "accrued interests"</comment> +<paragraph xml-lang="en-US" id="par_id3151276" role="paragraph" l10n="U" oldref="336"><ahelp hid="HID_AAI_FUNC_ACCRINT">Calculates the accrued interest of a security in the case of periodic payments.</ahelp></paragraph> + <paragraph xml-lang="en-US" id="hd_id3152581" role="heading" level="3" l10n="U" + oldref="337">Syntax</paragraph> + <paragraph xml-lang="en-US" id="par_id3159092" role="code" l10n="U" oldref="338">ACCRINT(Issue; FirstInterest; Settlement; Rate; Par; Frequency; Basis)</paragraph> + <paragraph xml-lang="en-US" id="par_id3150519" role="paragraph" l10n="U" oldref="339"> + <emph>Issue</emph> is the issue date of the security.</paragraph> + <paragraph xml-lang="en-US" id="par_id3155376" role="paragraph" l10n="U" oldref="340"> + <emph>FirstInterest</emph> is the first interest date of the security.</paragraph> + <paragraph xml-lang="en-US" id="par_id3166431" role="paragraph" l10n="U" oldref="341"> + <emph>Settlement</emph> is the date at which the interest accrued up until then is to be calculated.</paragraph> + <paragraph xml-lang="en-US" id="par_id3154486" role="paragraph" l10n="U" oldref="342"> + <emph>Rate</emph> is the annual nominal rate of interest (coupon interest rate)</paragraph> + <paragraph xml-lang="en-US" id="par_id3156445" role="paragraph" l10n="U" oldref="343"> + <emph>Par</emph> is the par value of the security.</paragraph> + <paragraph xml-lang="en-US" id="par_id3149406" role="paragraph" l10n="U" oldref="344"> + <emph>Frequency</emph> is the number of interest payments per year (1, 2 or 4).</paragraph> + <embed href="text/scalc/01/func_yearfrac.xhp#basis"/> + <paragraph xml-lang="en-US" id="hd_id3148699" role="heading" level="3" l10n="U" + oldref="345">Example</paragraph> + <paragraph xml-lang="en-US" id="par_id3148599" role="paragraph" l10n="CHG" oldref="346">A security is issued on 2001-02-28. First interest is set for 2001-08-31. The settlement date is 2001-05-01. The Rate is 0.1 or 10% and Par is 1000 currency units. Interest is paid half-yearly (frequency is 2). The basis is the US method (0). How much interest has accrued?</paragraph> + <paragraph xml-lang="en-US" id="par_id3148840" role="paragraph" l10n="CHG" oldref="347"> + <item type="input">=ACCRINT("2001-02-28";"2001-08-31";"2001-05-01";0.1;1000;2;0)</item> returns 16.94444.</paragraph> + </section> + <section id="accrintm"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3151240"><bookmark_value>ACCRINTM function</bookmark_value> + <bookmark_value>accrued interests;one-off payments</bookmark_value> +</bookmark><comment>mw added one index entry</comment> +<bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_ACCRINTM" id="bm_id3148866" localize="false"/> +<paragraph xml-lang="en-US" id="hd_id3151240" role="heading" level="2" l10n="U" + oldref="348">ACCRINTM</paragraph> + <paragraph xml-lang="en-US" id="par_id3157981" role="paragraph" l10n="U" oldref="349"><ahelp hid="HID_AAI_FUNC_ACCRINTM">Calculates the accrued interest of a security in the case of one-off payment at the settlement date.</ahelp></paragraph> + <paragraph xml-lang="en-US" id="hd_id3159097" role="heading" level="3" l10n="U" + oldref="350">Syntax</paragraph> + <paragraph xml-lang="en-US" id="par_id3147074" role="code" l10n="U" oldref="351">ACCRINTM(Issue; Settlement; Rate; Par; Basis)</paragraph> + <paragraph xml-lang="en-US" id="par_id3144773" role="paragraph" l10n="U" oldref="352"> + <emph>Issue</emph> is the issue date of the security.</paragraph> + <paragraph xml-lang="en-US" id="par_id3154956" role="paragraph" l10n="CHG" oldref="353"> + <emph>Settlement</emph> is the date at which the interest accrued up until then is to be calculated.</paragraph> + <paragraph xml-lang="en-US" id="par_id3153972" role="paragraph" l10n="U" oldref="354"> + <emph>Rate</emph> is the annual nominal rate of interest (coupon interest rate).</paragraph> + <paragraph xml-lang="en-US" id="par_id3159204" role="paragraph" l10n="U" oldref="355"> + <emph>Par</emph> is the par value of the security.</paragraph> + <embed href="text/scalc/01/func_yearfrac.xhp#basis"/> + <paragraph xml-lang="en-US" id="hd_id3155384" role="heading" level="3" l10n="U" + oldref="356">Example</paragraph> + <paragraph xml-lang="en-US" id="par_id3154541" role="paragraph" l10n="CHG" oldref="357">A security is issued on 2001-04-01. The maturity date is set for 2001-06-15. The Rate is 0.1 or 10% and Par is 1000 currency units. The basis of the daily/annual calculation is the daily balance (3). How much interest has accrued?</paragraph> + <paragraph xml-lang="en-US" id="par_id3149128" role="paragraph" l10n="CHG" oldref="358"> + <item type="input">=ACCRINTM("2001-04-01";"2001-06-15";0.1;1000;3)</item> returns 20.54795.</paragraph> + </section> + <section id="received"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3145753"><bookmark_value>RECEIVED function</bookmark_value> + <bookmark_value>amount received for fixed-interest securities</bookmark_value> +</bookmark><comment>mw added one entry</comment> +<bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_RECEIVED" id="bm_id3143218" localize="false"/> +<paragraph xml-lang="en-US" id="hd_id3145753" role="heading" level="2" l10n="U" + oldref="390">RECEIVED</paragraph> + <paragraph xml-lang="en-US" id="par_id3150051" role="paragraph" l10n="U" oldref="391"><ahelp hid="HID_AAI_FUNC_RECEIVED">Calculates the amount received that is paid for a fixed-interest security at a given point in time.</ahelp></paragraph> + <paragraph xml-lang="en-US" id="hd_id3149385" role="heading" level="3" l10n="U" + oldref="392">Syntax</paragraph> + <paragraph xml-lang="en-US" id="par_id3145362" role="code" l10n="U" oldref="393">RECEIVED("Settlement"; "Maturity"; Investment; Discount; Basis)</paragraph> + <paragraph xml-lang="en-US" id="par_id3154654" role="paragraph" l10n="U" oldref="394"> + <emph>Settlement</emph> is the date of purchase of the security.</paragraph> + <paragraph xml-lang="en-US" id="par_id3153011" role="paragraph" l10n="U" oldref="395"> + <emph>Maturity</emph> is the date on which the security matures (expires).</paragraph> + <paragraph xml-lang="en-US" id="par_id3155525" role="paragraph" l10n="U" oldref="396"> + <emph>Investment</emph> is the purchase sum.</paragraph> + <paragraph xml-lang="en-US" id="par_id3155760" role="paragraph" l10n="U" oldref="397"> + <emph>Discount</emph> is the percentage discount on acquisition of the security.</paragraph> + <embed href="text/scalc/01/func_yearfrac.xhp#basis"/> + <paragraph xml-lang="en-US" id="hd_id3154710" role="heading" level="3" l10n="U" + oldref="398">Example</paragraph> + <paragraph xml-lang="en-US" id="par_id3154735" role="paragraph" l10n="U" oldref="399">Settlement date: February 15 1999, maturity date: May 15 1999, investment sum: 1000 currency units, discount: 5.75 per cent, basis: Daily balance/360 = 2.</paragraph> + <paragraph xml-lang="en-US" id="par_id3146108" role="paragraph" l10n="U" oldref="400">The amount received on the maturity date is calculated as follows:</paragraph> + <paragraph xml-lang="en-US" id="par_id3147246" role="paragraph" l10n="CHG" oldref="401"> + <item type="input">=RECEIVED("1999-02-15";"1999-05-15";1000;0.0575;2)</item> returns 1014.420266.</paragraph> + </section> + <section id="pv"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3147556"><bookmark_value>PV function</bookmark_value> + <bookmark_value>present values</bookmark_value> + <bookmark_value>calculating; present values</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_BW" id="bm_id3153072" localize="false"/> +<paragraph xml-lang="en-US" id="hd_id3147556" role="heading" level="2" l10n="U" oldref="3">PV</paragraph> + <paragraph xml-lang="en-US" id="par_id3153301" role="paragraph" l10n="U" oldref="4"><ahelp hid="HID_FUNC_BW">Returns the present value of an investment resulting from a series of regular payments.</ahelp></paragraph> + <paragraph xml-lang="en-US" id="par_id3146099" role="paragraph" l10n="U" oldref="5">Use this function to calculate the amount of money needed to be invested at a fixed rate today, to receive a specific amount, an annuity, over a specified number of periods. You can also determine how much money is to remain after the elapse of the period. Specify as well if the amount is to be paid out at the beginning or at the end of each period.</paragraph> + <paragraph xml-lang="en-US" id="par_id3153334" role="paragraph" l10n="U" oldref="6">Enter these values either as numbers, expressions or references. If, for example, interest is paid annually at 8%, but you want to use month as your period, enter 8%/12 under <emph>Rate</emph> and <item type="productname">%PRODUCTNAME</item> Calc with automatically calculate the correct factor.</paragraph> + <paragraph xml-lang="en-US" id="hd_id3147407" role="heading" level="3" l10n="U" oldref="7">Syntax</paragraph> + <paragraph xml-lang="en-US" id="par_id3150395" role="code" l10n="U" oldref="8">PV(Rate; NPer; Pmt; FV; Type)</paragraph> + <paragraph xml-lang="en-US" id="par_id3151341" role="paragraph" l10n="U" oldref="9"> + <emph>Rate</emph> defines the interest rate per period.</paragraph> + <paragraph xml-lang="en-US" id="par_id3153023" role="paragraph" l10n="U" oldref="10"> + <emph>NPer</emph> is the total number of periods (payment period).</paragraph> + <paragraph xml-lang="en-US" id="par_id3146323" role="paragraph" l10n="U" oldref="11"> + <emph>Pmt</emph> is the regular payment made per period.</paragraph> + <paragraph xml-lang="en-US" id="par_id3150536" role="paragraph" l10n="U" oldref="12"> + <emph>FV</emph> (optional) defines the future value remaining after the final installment has been made.</paragraph> + <paragraph xml-lang="en-US" id="par_id3146883" role="paragraph" l10n="U" oldref="13"> + <emph>Type</emph> (optional) denotes due date for payments. Type = 1 means due at the beginning of a period and Type = 0 (default) means due at the end of the period.</paragraph> + <paragraph xml-lang="en-US" id="par_idN10B13" role="paragraph" l10n="NEW"> + <embedvar href="text/scalc/00/00000004.xhp#optional"/> + </paragraph> + <paragraph xml-lang="en-US" id="hd_id3150037" role="heading" level="3" l10n="U" + oldref="14">Example</paragraph> + <paragraph xml-lang="en-US" id="par_id3145225" role="paragraph" l10n="U" oldref="15">What is the present value of an investment, if 500 currency units are paid out monthly and the annual interest rate is 8%? The payment period is 48 months and 20,000 currency units are to remain at the end of the payment period.</paragraph> + <paragraph xml-lang="en-US" id="par_id3155907" role="paragraph" l10n="U" oldref="16"> + <item type="input">=PV(8%/12;48;500;20000)</item> = -35,019.37 currency units. Under the named conditions, you must deposit 35,019.37 currency units today, if you want to receive 500 currency units per month for 48 months and have 20,000 currency units left over at the end. Cross-checking shows that 48 x 500 currency units + 20,000 currency units = 44,000 currency units. The difference between this amount and the 35,000 currency units deposited represents the interest paid.</paragraph> + <paragraph xml-lang="en-US" id="par_id3149150" role="paragraph" l10n="U" oldref="17">If you enter references instead of these values into the formula, you can calculate any number of "If-then" scenarios. Please note: references to constants must be defined as absolute references. Examples of this type of application are found under the depreciation functions.</paragraph> + </section> + <section id="syd"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3152978"><bookmark_value>calculating; depreciations</bookmark_value> + <bookmark_value>SYD function</bookmark_value> + <bookmark_value>depreciations; arithmetic declining</bookmark_value> + <bookmark_value>arithmetic declining depreciations</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_DIA" id="bm_id3157905" localize="false"/> +<paragraph xml-lang="en-US" id="hd_id3152978" role="heading" level="2" l10n="U" + oldref="19">SYD</paragraph> + <paragraph xml-lang="en-US" id="par_id3148732" role="paragraph" l10n="U" oldref="20"><ahelp hid="HID_FUNC_DIA">Returns the arithmetic-declining depreciation rate.</ahelp></paragraph> + <paragraph xml-lang="en-US" id="par_id3149886" role="paragraph" l10n="U" oldref="21">Use this function to calculate the depreciation amount for one period of the total depreciation span of an object. Arithmetic declining depreciation reduces the depreciation amount from period to period by a fixed sum.</paragraph> + <paragraph xml-lang="en-US" id="hd_id3149431" role="heading" level="3" l10n="U" + oldref="22">Syntax</paragraph> + <paragraph xml-lang="en-US" id="par_id3150483" role="code" l10n="U" oldref="23">SYD(Cost; Salvage; Life; Period)</paragraph> + <paragraph xml-lang="en-US" id="par_id3146879" role="paragraph" l10n="U" oldref="24"> + <emph>Cost</emph> is the initial cost of an asset.</paragraph> + <paragraph xml-lang="en-US" id="par_id3147423" role="paragraph" l10n="U" oldref="25"> + <emph>Salvage</emph> is the value of an asset after depreciation.</paragraph> + <paragraph xml-lang="en-US" id="par_id3151229" role="paragraph" l10n="U" oldref="26"> + <emph>Life</emph> is the period fixing the time span over which an asset is depreciated.</paragraph> + <paragraph xml-lang="en-US" id="par_id3147473" role="paragraph" l10n="U" oldref="27"> + <emph>Period</emph> defines the period for which the depreciation is to be calculated.</paragraph> + <paragraph xml-lang="en-US" id="hd_id3148434" role="heading" level="3" l10n="U" + oldref="28">Example</paragraph> + <paragraph xml-lang="en-US" id="par_id3149688" role="paragraph" l10n="U" oldref="29">A video system initially costing 50,000 currency units is to be depreciated annually for the next 5 years. The salvage value is to be 10,000 currency units. You want to calculate depreciation for the first year.</paragraph> + <paragraph xml-lang="en-US" id="par_id3150900" role="paragraph" l10n="U" oldref="30"> + <item type="input">=SYD(50000;10000;5;1)</item>=13,333.33 currency units. The depreciation amount for the first year is 13,333.33 currency units.</paragraph> + <paragraph xml-lang="en-US" id="par_id3146142" role="paragraph" l10n="U" oldref="31">To have an overview of depreciation rates per period, it is best to define a depreciation table. By entering the different depreciation formulas available in <item type="productname">%PRODUCTNAME</item> Calc next to each other, you can see which depreciation form is the most appropriate. Enter the table as follows:</paragraph> + <table id="tbl_id3149189"> + <tablerow> + <tablecell> +</tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3155258" role="tablehead" l10n="U" oldref="32"> + <emph>A</emph> + </paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3154558" role="tablehead" l10n="U" oldref="33"> + <emph>B</emph> + </paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3152372" role="tablehead" l10n="U" oldref="34"> + <emph>C</emph> + </paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3149949" role="tablehead" l10n="U" oldref="35"> + <emph>D</emph> + </paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3145123" role="tablehead" l10n="U" oldref="36"> + <emph>E</emph> + </paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3149504" role="tablecontent" l10n="U" oldref="37">1</paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3153778" role="tablecontent" l10n="U" oldref="38"> + <item type="input">Initial Cost</item> + </paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3159083" role="tablecontent" l10n="U" oldref="39"> + <item type="input">Salvage Value</item> + </paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3150002" role="tablecontent" l10n="U" oldref="40"> + <item type="input">Useful Life</item> + </paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3153006" role="tablecontent" l10n="U" oldref="41"> + <item type="input">Time Period</item> + </paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3154505" role="tablecontent" l10n="U" oldref="42"> + <item type="input">Deprec. SYD</item> + </paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3150336" role="tablecontent" l10n="U" oldref="43">2</paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3155926" role="tablecontent" l10n="U" oldref="44"> + <item type="input">50,000 currency units</item> + </paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3153736" role="tablecontent" l10n="U" oldref="45"> + <item type="input">10,000 currency units</item> + </paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3150131" role="tablecontent" l10n="U" oldref="46"> + <item type="input">5</item> + </paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3148766" role="tablecontent" l10n="U" oldref="47"> + <item type="input">1</item> + </paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3159136" role="tablecontent" l10n="U" oldref="48"> + <item type="input">13,333.33 currency units</item> + </paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3151018" role="tablecontent" l10n="U" oldref="49">3</paragraph> + </tablecell> + <tablecell> +</tablecell> + <tablecell> +</tablecell> + <tablecell> +</tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3148397" role="tablecontent" l10n="U" oldref="50"> + <item type="input">2</item> + </paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3146907" role="tablecontent" l10n="U" oldref="51"> + <item type="input">10,666.67 currency units</item> + </paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3147356" role="tablecontent" l10n="U" oldref="52">4</paragraph> + </tablecell> + <tablecell> +</tablecell> + <tablecell> +</tablecell> + <tablecell> +</tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3150267" role="tablecontent" l10n="U" oldref="53"> + <item type="input">3</item> + </paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3145628" role="tablecontent" l10n="U" oldref="54"> + <item type="input">8,000.00 currency units</item> + </paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3149004" role="tablecontent" l10n="U" oldref="55">5</paragraph> + </tablecell> + <tablecell> +</tablecell> + <tablecell> +</tablecell> + <tablecell> +</tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3153545" role="tablecontent" l10n="U" oldref="56"> + <item type="input">4</item> + </paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3154634" role="tablecontent" l10n="U" oldref="57"> + <item type="input">5,333.33 currency units</item> + </paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3147537" role="tablecontent" l10n="U" oldref="58">6</paragraph> + </tablecell> + <tablecell> +</tablecell> + <tablecell> +</tablecell> + <tablecell> +</tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3155085" role="tablecontent" l10n="U" oldref="59"> + <item type="input">5</item> + </paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3158413" role="tablecontent" l10n="U" oldref="60"> + <item type="input">2,666.67 currency units</item> + </paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3154866" role="tablecontent" l10n="U" oldref="61">7</paragraph> + </tablecell> + <tablecell> +</tablecell> + <tablecell> +</tablecell> + <tablecell> +</tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3155404" role="tablecontent" l10n="U" oldref="62"> + <item type="input">6</item> + </paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3148431" role="tablecontent" l10n="U" oldref="63"> + <item type="input">0.00 currency units</item> + </paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3156261" role="tablecontent" l10n="U" oldref="64">8</paragraph> + </tablecell> + <tablecell> +</tablecell> + <tablecell> +</tablecell> + <tablecell> +</tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3083286" role="tablecontent" l10n="U" oldref="65"> + <item type="input">7</item> + </paragraph> + </tablecell> + <tablecell> +</tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3083443" role="tablecontent" l10n="U" oldref="67">9</paragraph> + </tablecell> + <tablecell> +</tablecell> + <tablecell> +</tablecell> + <tablecell> +</tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3154815" role="tablecontent" l10n="U" oldref="68"> + <item type="input">8</item> + </paragraph> + </tablecell> + <tablecell> +</tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3145082" role="tablecontent" l10n="U" oldref="70">10</paragraph> + </tablecell> + <tablecell> +</tablecell> + <tablecell> +</tablecell> + <tablecell> +</tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3156307" role="tablecontent" l10n="U" oldref="71"> + <item type="input">9</item> + </paragraph> + </tablecell> + <tablecell> +</tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3147564" role="tablecontent" l10n="U" oldref="73">11</paragraph> + </tablecell> + <tablecell> +</tablecell> + <tablecell> +</tablecell> + <tablecell> +</tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3146856" role="tablecontent" l10n="U" oldref="74"> + <item type="input">10</item> + </paragraph> + </tablecell> + <tablecell> +</tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3150880" role="tablecontent" l10n="U" oldref="76">12</paragraph> + </tablecell> + <tablecell> +</tablecell> + <tablecell> +</tablecell> + <tablecell> +</tablecell> + <tablecell> +</tablecell> + <tablecell> +</tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3145208" role="tablecontent" l10n="U" oldref="77">13</paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3156113" role="tablecontent" l10n="U" oldref="78"> + <item type="input">>0</item> + </paragraph> + </tablecell> + <tablecell> +</tablecell> + <tablecell> +</tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3153625" role="tablecontent" l10n="U" oldref="79"> + <item type="input">Total</item> + </paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3151297" role="tablecontent" l10n="U" oldref="80"> + <item type="input">40,000.00 currency units</item> + </paragraph> + </tablecell> + </tablerow> + </table> + + <paragraph xml-lang="en-US" id="par_id3149979" role="paragraph" l10n="U" oldref="81">The formula in E2 is as follows:</paragraph> + <paragraph xml-lang="en-US" id="par_id3155849" role="paragraph" l10n="U" oldref="82"> + <item type="input">=SYD($A$2;$B$2;$C$2;D2)</item> + </paragraph> + <paragraph xml-lang="en-US" id="par_id3156124" role="paragraph" l10n="U" oldref="83">This formula is duplicated in column E down to E11 (select E2, then drag down the lower right corner with the mouse).</paragraph> + <paragraph xml-lang="en-US" id="par_id3147270" role="paragraph" l10n="U" oldref="84">Cell E13 contains the formula used to check the total of the depreciation amounts. It uses the SUMIF function as the negative values in E8:E11 must not be considered. The condition >0 is contained in cell A13. The formula in E13 is as follows:</paragraph> + <paragraph xml-lang="en-US" id="par_id3152811" role="paragraph" l10n="U" oldref="85"> + <item type="input">=SUMIF(E2:E11;A13)</item> + </paragraph> + <paragraph xml-lang="en-US" id="par_id3155998" role="paragraph" l10n="U" oldref="86">Now view the depreciation for a 10 year period, or at a salvage value of 1 currency unit, or enter a different initial cost, and so on.</paragraph> + </section> + <section id="disc"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3155104"><bookmark_value>DISC function</bookmark_value> + <bookmark_value>allowances</bookmark_value> + <bookmark_value>discounts</bookmark_value> +</bookmark><comment>mw added "discounts" and "allowances"</comment> +<bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_DISC" id="bm_id3149290" localize="false"/> +<paragraph xml-lang="en-US" id="hd_id3155104" role="heading" level="2" l10n="U" + oldref="379">DISC</paragraph> + <paragraph xml-lang="en-US" id="par_id3153891" role="paragraph" l10n="U" oldref="380"><ahelp hid="HID_AAI_FUNC_DISC">Calculates the allowance (discount) of a security as a percentage.</ahelp></paragraph> + <paragraph xml-lang="en-US" id="hd_id3153982" role="heading" level="3" l10n="U" + oldref="381">Syntax</paragraph> + <paragraph xml-lang="en-US" id="par_id3149756" role="code" l10n="U" oldref="382">DISC("Settlement"; "Maturity"; Price; Redemption; Basis)</paragraph> + <paragraph xml-lang="en-US" id="par_id3156014" role="paragraph" l10n="U" oldref="383"> + <emph>Settlement</emph> is the date of purchase of the security.</paragraph> + <paragraph xml-lang="en-US" id="par_id3154304" role="paragraph" l10n="U" oldref="384"> + <emph>Maturity</emph> is the date on which the security matures (expires).</paragraph> + <paragraph xml-lang="en-US" id="par_id3159180" role="paragraph" l10n="U" oldref="385"> + <emph>Price</emph> is the price of the security per 100 currency units of par value.</paragraph> + <paragraph xml-lang="en-US" id="par_id3147253" role="paragraph" l10n="U" oldref="386"> + <emph>Redemption</emph> is the redemption value of the security per 100 currency units of par value.</paragraph> + <embed href="text/scalc/01/func_yearfrac.xhp#basis"/> + <paragraph xml-lang="en-US" id="hd_id3151174" role="heading" level="3" l10n="U" + oldref="387">Example</paragraph> + <paragraph xml-lang="en-US" id="par_id3155902" role="paragraph" l10n="CHG" oldref="388">A security is purchased on 2001-01-25; the maturity date is 2001-11-15. The price (purchase price) is 97, the redemption value is 100. Using daily balance calculation (basis 3) how high is the settlement (discount)?</paragraph> + <paragraph xml-lang="en-US" id="par_id3152797" role="paragraph" l10n="CHG" oldref="389"> + <item type="input">=DISC("2001-01-25";"2001-11-15";97;100;3)</item> returns about 0.0372 or 3.72 per cent.</paragraph> + </section> + <section id="duration_add"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3154695"><bookmark_value>DURATION_ADD function</bookmark_value> + <bookmark_value>Microsoft Excel functions</bookmark_value> + <bookmark_value>durations;fixed interest securities</bookmark_value> +</bookmark><comment>mw added two entries</comment> +<bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_DURATION" id="bm_id3159344" localize="false"/> +<paragraph xml-lang="en-US" id="hd_id3154695" role="heading" level="2" l10n="U" + oldref="402">DURATION_ADD</paragraph> + <paragraph xml-lang="en-US" id="par_id3145768" role="paragraph" l10n="U" oldref="403"><ahelp hid="HID_AAI_FUNC_DURATION">Calculates the duration of a fixed interest security in years.</ahelp></paragraph> + <embed href="text/scalc/01/04060102.xhp#ADD_note"/> + <paragraph xml-lang="en-US" id="hd_id3153904" role="heading" level="3" l10n="U" + oldref="404">Syntax</paragraph> + <paragraph xml-lang="en-US" id="par_id3153373" role="code" l10n="U" oldref="405">DURATION_ADD("Settlement"; "Maturity"; Coupon; Yield; Frequency; Basis)</paragraph> + <paragraph xml-lang="en-US" id="par_id3155397" role="paragraph" l10n="U" oldref="406"> + <emph>Settlement</emph> is the date of purchase of the security.</paragraph> + <paragraph xml-lang="en-US" id="par_id3148558" role="paragraph" l10n="U" oldref="407"> + <emph>Maturity</emph> is the date on which the security matures (expires).</paragraph> + <paragraph xml-lang="en-US" id="par_id3153096" role="paragraph" l10n="U" oldref="408"> + <emph>Coupon</emph> is the annual coupon interest rate (nominal rate of interest)</paragraph> + <paragraph xml-lang="en-US" id="par_id3154594" role="paragraph" l10n="U" oldref="409"> + <emph>Yield</emph> is the annual yield of the security.</paragraph> + <paragraph xml-lang="en-US" id="par_id3149906" role="paragraph" l10n="U" oldref="410"> + <emph>Frequency</emph> is the number of interest payments per year (1, 2 or 4).</paragraph> + <embed href="text/scalc/01/func_yearfrac.xhp#basis"/> + <paragraph xml-lang="en-US" id="hd_id3146995" role="heading" level="3" l10n="U" + oldref="411">Example</paragraph> + <paragraph xml-lang="en-US" id="par_id3148834" role="paragraph" l10n="CHG" oldref="412">A security is purchased on 2001-01-01; the maturity date is 2006-01-01. The Coupon rate of interest is 8%. The yield is 9.0%. Interest is paid half-yearly (frequency is 2). Using daily balance interest calculation (basis 3) how long is the duration?</paragraph> + <paragraph xml-lang="en-US" id="par_id3154902" role="paragraph" l10n="CHG" oldref="413"> + <item type="input">=DURATION_ADD("2001-01-01";"2006-01-01";0.08;0.09;2;3)</item> + </paragraph> + </section> + <section id="effective"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3159147"><bookmark_value>annual net interest rates</bookmark_value> + <bookmark_value>calculating; annual net interest rates</bookmark_value> + <bookmark_value>net annual interest rates</bookmark_value> + <bookmark_value>EFFECTIVE function</bookmark_value> +</bookmark><comment>mw added one entry</comment> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_EFFEKTIV" id="bm_id3154290" localize="false"/> +<paragraph xml-lang="en-US" id="hd_id3159147" role="heading" level="2" l10n="U" + oldref="88">EFFECTIVE</paragraph> + <paragraph xml-lang="en-US" id="par_id3154204" role="paragraph" l10n="U" oldref="89"><ahelp hid="HID_FUNC_EFFEKTIV">Returns the net annual interest rate for a nominal interest rate.</ahelp></paragraph> + <paragraph xml-lang="en-US" id="par_id3145417" role="paragraph" l10n="U" oldref="90">Nominal interest refers to the amount of interest due at the end of a calculation period. Effective interest increases with the number of payments made. In other words, interest is often paid in installments (for example, monthly or quarterly) before the end of the calculation period.</paragraph> + <paragraph xml-lang="en-US" id="hd_id3150510" role="heading" level="3" l10n="U" + oldref="91">Syntax</paragraph> + <paragraph xml-lang="en-US" id="par_id3148805" role="code" l10n="U" oldref="92">EFFECTIVE(Nom; P)</paragraph> + <paragraph xml-lang="en-US" id="par_id3149768" role="paragraph" l10n="U" oldref="93"> + <emph>Nom</emph> is the nominal interest.</paragraph> + <paragraph xml-lang="en-US" id="par_id3149334" role="paragraph" l10n="U" oldref="94"> + <emph>P</emph> is the number of interest payment periods per year.</paragraph> + <paragraph xml-lang="en-US" id="hd_id3154223" role="heading" level="3" l10n="U" + oldref="95">Example</paragraph> + <paragraph xml-lang="en-US" id="par_id3144499" role="paragraph" l10n="U" oldref="96">If the annual nominal interest rate is 9.75% and four interest calculation periods are defined, what is the actual interest rate (effective rate)?</paragraph> + <paragraph xml-lang="en-US" id="par_id3150772" role="paragraph" l10n="U" oldref="97"> + <item type="input">=EFFECTIVE(9.75%;4)</item> = 10.11% The annual effective rate is therefore 10.11%.</paragraph> + </section> + <section id="effect_add"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3147241"><bookmark_value>effective interest rates</bookmark_value> + <bookmark_value>EFFECT_ADD function</bookmark_value> +</bookmark><comment>mw changed "effective rates"</comment> +<bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_EFFECT" id="bm_id3147515" localize="false"/> +<paragraph xml-lang="en-US" id="hd_id3147241" role="heading" level="2" l10n="U" + oldref="414">EFFECT_ADD</paragraph> + <paragraph xml-lang="en-US" id="par_id3147524" role="paragraph" l10n="U" oldref="415"><ahelp hid="HID_AAI_FUNC_EFFECT">Calculates the effective annual rate of interest on the basis of the nominal interest rate and the number of interest payments per annum.</ahelp></paragraph> + <embed href="text/scalc/01/04060102.xhp#ADD_note"/> + <paragraph xml-lang="en-US" id="hd_id3155364" role="heading" level="3" l10n="U" + oldref="416">Syntax</paragraph> + <paragraph xml-lang="en-US" id="par_id3155118" role="code" l10n="U" oldref="417">EFFECT_ADD(NominalRate; NPerY)</paragraph> + <paragraph xml-lang="en-US" id="par_id3148907" role="paragraph" l10n="U" oldref="418"> + <emph>NominalRate</emph> is the annual nominal rate of interest.</paragraph> + <paragraph xml-lang="en-US" id="par_id3154274" role="paragraph" l10n="U" oldref="419"> + <emph>NPerY </emph>is the number of interest payments per year.</paragraph> + <paragraph xml-lang="en-US" id="hd_id3149156" role="heading" level="3" l10n="U" + oldref="420">Example</paragraph> + <paragraph xml-lang="en-US" id="par_id3158426" role="paragraph" l10n="U" oldref="421">What is the effective annual rate of interest for a 5.25% nominal rate and quarterly payment.</paragraph> + <paragraph xml-lang="en-US" id="par_id3148927" role="paragraph" l10n="U" oldref="422"> + <item type="input">=EFFECT_ADD(0.0525;4)</item> returns 0.053543 or 5.3543%.</paragraph> + </section> + <section id="ddb"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3149998"><bookmark_value>calculating; arithmetic-degressive depreciations</bookmark_value> + <bookmark_value>arithmetic-degressive depreciations</bookmark_value> + <bookmark_value>depreciations;arithmetic-degressive</bookmark_value> + <bookmark_value>DDB function</bookmark_value> +</bookmark><comment>mw corrected two typos and added "depreciations;..."</comment> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_GDA" id="bm_id3149176" localize="false"/> +<paragraph xml-lang="en-US" id="hd_id3149998" role="heading" level="2" l10n="U" + oldref="99">DDB</paragraph> + <paragraph xml-lang="en-US" id="par_id3159190" role="paragraph" l10n="U" oldref="100"><ahelp hid="HID_FUNC_GDA">Returns the depreciation of an asset for a specified period using the arithmetic-declining method.</ahelp></paragraph> + <paragraph xml-lang="en-US" id="par_id3152361" role="paragraph" l10n="U" oldref="101">Use this form of depreciation if you require a higher initial depreciation value as opposed to linear depreciation. The depreciation value gets less with each period and is usually used for assets whose value loss is higher shortly after purchase (for example, vehicles, computers). Please note that the book value will never reach zero under this calculation type.</paragraph> + <paragraph xml-lang="en-US" id="hd_id3156038" role="heading" level="3" l10n="U" + oldref="102">Syntax</paragraph> + <paragraph xml-lang="en-US" id="par_id3166452" role="code" l10n="U" oldref="103">DDB(Cost; Salvage; Life; Period; Factor)</paragraph> + <paragraph xml-lang="en-US" id="par_id3153237" role="paragraph" l10n="U" oldref="104"> + <emph>Cost</emph> fixes the initial cost of an asset.</paragraph> + <paragraph xml-lang="en-US" id="par_id3149787" role="paragraph" l10n="U" oldref="105"> + <emph>Salvage</emph> fixes the value of an asset at the end of its life.</paragraph> + <paragraph xml-lang="en-US" id="par_id3152945" role="paragraph" l10n="U" oldref="106"> + <emph>Life</emph> is the number of periods (for example, years or months) defining how long the asset is to be used.</paragraph> + <paragraph xml-lang="en-US" id="par_id3149736" role="paragraph" l10n="U" oldref="107"> + <emph>Period</emph> states the period for which the value is to be calculated.</paragraph> + <paragraph xml-lang="en-US" id="par_id3150243" role="paragraph" l10n="U" oldref="108"> + <emph>Factor</emph> (optional) is the factor by which depreciation decreases. If a value is not entered, the default is factor 2.</paragraph> + <paragraph xml-lang="en-US" id="hd_id3159274" role="heading" level="3" l10n="U" + oldref="109">Example</paragraph> + <paragraph xml-lang="en-US" id="par_id3152882" role="paragraph" l10n="U" oldref="110">A computer system with an initial cost of 75,000 currency units is to be depreciated monthly over 5 years. The value at the end of the depreciation is to be 1 currency unit. The factor is 2.</paragraph> + <paragraph xml-lang="en-US" id="par_id3154106" role="paragraph" l10n="U" oldref="111"> + <item type="input">=DDB(75000;1;60;12;2) </item>= 1,721.81 currency units. Therefore, the double-declining depreciation in the twelfth month after purchase is 1,721.81 currency units.</paragraph> + </section> + <section id="db"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3149962"><bookmark_value>calculating; geometric-degressive depreciations</bookmark_value> + <bookmark_value>geometric-degressive depreciations</bookmark_value> + <bookmark_value>depreciations;geometric-degressive</bookmark_value> + <bookmark_value>DB function</bookmark_value> +</bookmark><comment>mw added "depreciations;.."</comment> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_GDA2" id="bm_id3149973" localize="false"/> +<paragraph xml-lang="en-US" id="hd_id3149962" role="heading" level="2" l10n="U" + oldref="113">DB</paragraph> + <paragraph xml-lang="en-US" id="par_id3148989" role="paragraph" l10n="U" oldref="114"><ahelp hid="HID_FUNC_GDA2">Returns the depreciation of an asset for a specified period using the double-declining balance method.</ahelp></paragraph> + <paragraph xml-lang="en-US" id="par_id3156213" role="paragraph" l10n="U" oldref="115">This form of depreciation is used if you want to get a higher depreciation value at the beginning of the depreciation (as opposed to linear depreciation). The depreciation value is reduced with every depreciation period by the depreciation already deducted from the initial cost.</paragraph> + <paragraph xml-lang="en-US" id="hd_id3149807" role="heading" level="3" l10n="U" + oldref="116">Syntax</paragraph> + <paragraph xml-lang="en-US" id="par_id3153349" role="code" l10n="U" oldref="117">DB(Cost; Salvage; Life; Period; Month)</paragraph> + <paragraph xml-lang="en-US" id="par_id3148462" role="paragraph" l10n="U" oldref="118"> + <emph>Cost</emph> is the initial cost of an asset.</paragraph> + <paragraph xml-lang="en-US" id="par_id3148658" role="paragraph" l10n="U" oldref="119"> + <emph>Salvage</emph> is the value of an asset at the end of the depreciation.</paragraph> + <paragraph xml-lang="en-US" id="par_id3145371" role="paragraph" l10n="U" oldref="120"> + <emph>Life</emph> defines the period over which an asset is depreciated.</paragraph> + <paragraph xml-lang="en-US" id="par_id3154608" role="paragraph" l10n="U" oldref="121"> + <emph>Period</emph> is the length of each period. The length must be entered in the same date unit as the depreciation period.</paragraph> + <paragraph xml-lang="en-US" id="par_id3150829" role="paragraph" l10n="U" oldref="122"> + <emph>Month</emph> (optional) denotes the number of months for the first year of depreciation. If an entry is not defined, 12 is used as the default.</paragraph> + <paragraph xml-lang="en-US" id="hd_id3151130" role="heading" level="3" l10n="U" + oldref="123">Example</paragraph> + <paragraph xml-lang="en-US" id="par_id3156147" role="paragraph" l10n="U" oldref="124">A computer system with an initial cost of 25,000 currency units is to be depreciated over a three year period. The salvage value is to be 1,000 currency units. One period is 30 days.</paragraph> + <paragraph xml-lang="en-US" id="par_id3149513" role="paragraph" l10n="U" oldref="125"> + <item type="input">=DB(25000;1000;36;1;6)</item> = 1,075.00 currency units</paragraph> + <paragraph xml-lang="en-US" id="par_id3159242" role="paragraph" l10n="U" oldref="126">The fixed-declining depreciation of the computer system is 1,075.00 currency units.</paragraph> + </section> + <section id="irr"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3153948"><bookmark_value>IRR function</bookmark_value> + <bookmark_value>calculating;internal rates of return, regular payments</bookmark_value> + <bookmark_value>internal rates of return;regular payments</bookmark_value> +</bookmark><comment>mw changed "calculating;..." and "internal rates"</comment> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_IKV" id="bm_id3148419" localize="false"/> +<paragraph xml-lang="en-US" id="hd_id3153948" role="heading" level="2" l10n="U" + oldref="128">IRR</paragraph> + <paragraph xml-lang="en-US" id="par_id3143282" role="paragraph" l10n="U" oldref="129"><ahelp hid="HID_FUNC_IKV">Calculates the internal rate of return for an investment.</ahelp> The values represent cash flow values at regular intervals, at least one value must be negative (payments), and at least one value must be positive (income).</paragraph> + <paragraph xml-lang="en-US" id="hd_id3150599" role="heading" level="3" l10n="U" + oldref="130">Syntax</paragraph> + <paragraph xml-lang="en-US" id="par_id3155427" role="code" l10n="U" oldref="131">IRR(Values; Guess)</paragraph> + <paragraph xml-lang="en-US" id="par_id3144758" role="paragraph" l10n="U" oldref="132"> + <emph>Values</emph> represents an array containing the values.</paragraph> + <paragraph xml-lang="en-US" id="par_id3149233" role="paragraph" l10n="U" oldref="133"> + <emph>Guess</emph> (optional) is the estimated value. An iterative method is used to calculate the internal rate of return. If you can provide only few values, you should provide an initial guess to enable the iteration.</paragraph> + <paragraph xml-lang="en-US" id="hd_id3151258" role="heading" level="3" l10n="U" + oldref="134">Example</paragraph> + <paragraph xml-lang="en-US" id="par_id3150630" role="paragraph" l10n="U" oldref="135">Under the assumption that cell contents are A1=<item type="input">-10000</item>, A2=<item type="input">3500</item>, A3=<item type="input">7600</item> and A4=<item type="input">1000</item>, the formula <item type="input">=IRR(A1:A4)</item> gives a result of 11,33%.</paragraph> + </section> + <section id="ispmt"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3151012"><bookmark_value>calculating; interests for unchanged amortization installments</bookmark_value> + <bookmark_value>interests for unchanged amortization installments</bookmark_value> + <bookmark_value>ISPMT function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_ISPMT" id="bm_id3149491" localize="false"/> +<paragraph xml-lang="en-US" id="hd_id3151012" role="heading" level="2" l10n="U" + oldref="314">ISPMT</paragraph> + <paragraph xml-lang="en-US" id="par_id3148693" role="paragraph" l10n="U" oldref="315"><ahelp hid="HID_FUNC_ISPMT">Calculates the level of interest for unchanged amortization installments.</ahelp></paragraph> + <paragraph xml-lang="en-US" id="hd_id3154661" role="heading" level="3" l10n="U" + oldref="316">Syntax</paragraph> + <paragraph xml-lang="en-US" id="par_id3146070" role="code" l10n="U" oldref="317">ISPMT(Rate; Period; TotalPeriods; Invest)</paragraph> + <paragraph xml-lang="en-US" id="par_id3148672" role="paragraph" l10n="U" oldref="318"> + <emph>Rate</emph> sets the periodic interest rate.</paragraph> + <paragraph xml-lang="en-US" id="par_id3145777" role="paragraph" l10n="U" oldref="319"> + <emph>Period</emph> is the number of installments for calculation of interest.</paragraph> + <paragraph xml-lang="en-US" id="par_id3153678" role="paragraph" l10n="U" oldref="320"> + <emph>TotalPeriods</emph> is the total number of installment periods.</paragraph> + <paragraph xml-lang="en-US" id="par_id3159390" role="paragraph" l10n="U" oldref="321"> + <emph>Invest</emph> is the amount of the investment.</paragraph> + <paragraph xml-lang="en-US" id="hd_id3156162" role="heading" level="3" l10n="U" + oldref="322">Example</paragraph> + <paragraph xml-lang="en-US" id="par_id3149558" role="paragraph" l10n="U" oldref="323">For a credit amount of 120,000 currency units with a two-year term and monthly installments, at a yearly interest rate of 12% the level of interest after 1.5 years is required.</paragraph> + <paragraph xml-lang="en-US" id="par_id3150949" role="paragraph" l10n="U" oldref="324"> + <item type="input">=ISPMT(1%;18;24;120000)</item> = -300 currency units. The monthly interest after 1.5 years amounts to 300 currency units.</paragraph> + </section> +</sort> +<paragraph xml-lang="en-US" id="par_id3146812" role="paragraph" l10n="U" oldref="426"><link href="text/scalc/01/04060119.xhp" name="Forward to Financial Functions Part Two">Financial Functions Part Two</link></paragraph> + <paragraph xml-lang="en-US" id="par_id3154411" role="paragraph" l10n="U" oldref="427"><link href="text/scalc/01/04060118.xhp" name="Forward to Financial Functions Part Three">Financial Functions Part Three</link></paragraph> + <embed href="text/scalc/01/04060100.xhp#drking"/> + </body> +</helpdocument>
\ No newline at end of file diff --git a/source/text/scalc/01/04060104.xhp b/source/text/scalc/01/04060104.xhp new file mode 100644 index 0000000000..66ed847c34 --- /dev/null +++ b/source/text/scalc/01/04060104.xhp @@ -0,0 +1,764 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> + +<!-- +*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************ + --> + + +<meta> +<topic id="textscalc0104060104xml" indexer="include"> +<title id="tit" xml-lang="en-US">Information Functions</title> +<filename>/text/scalc/01/04060104.xhp</filename> +</topic> +</meta> +<body> +<bookmark xml-lang="en-US" branch="index" id="bm_id3147247"><bookmark_value>information functions</bookmark_value> +<bookmark_value>Function Wizard; information</bookmark_value> +<bookmark_value>functions; information functions</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3147247" xml-lang="en-US" level="1" l10n="U" oldref="1">Information Functions</paragraph> +<paragraph role="paragraph" id="par_id3147499" xml-lang="en-US" l10n="CHG" oldref="2"><variable id="informationtext">This category contains the <emph>Information</emph> functions. +</variable></paragraph> +<section id="howtoget"> +<embed href="text/scalc/00/00000404.xhp#eikain"/> +</section> +<paragraph role="paragraph" id="par_id3159128" xml-lang="en-US" l10n="U" oldref="3">The data in the following table serves as the basis for some of the examples in the function descriptions:</paragraph> +<table id="tbl_id3157876"> +<tablerow> +<tablecell> +</tablecell> +<tablecell> +<paragraph role="tablehead" id="par_id3146885" xml-lang="en-US" l10n="U" oldref="4">C</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablehead" id="par_id3149944" xml-lang="en-US" l10n="U" oldref="5">D</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph role="tablecontent" id="par_id3150457" xml-lang="en-US" l10n="U" oldref="6"> +<emph>2</emph> +</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablecontent" id="par_id3150024" xml-lang="en-US" l10n="U" oldref="7">x <item type="input">value</item> +</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablecontent" id="par_id3148725" xml-lang="en-US" l10n="U" oldref="8">y <item type="input">value</item> +</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph role="tablecontent" id="par_id3150480" xml-lang="en-US" l10n="U" oldref="9"> +<emph>3</emph> +</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablecontent" id="par_id3148440" xml-lang="en-US" l10n="U" oldref="10"> +<item type="input">-5</item> +</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablecontent" id="par_id3148888" xml-lang="en-US" l10n="U" oldref="11"> +<item type="input">-3</item> +</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph role="tablecontent" id="par_id3153034" xml-lang="en-US" l10n="U" oldref="12"> +<emph>4</emph> +</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablecontent" id="par_id3150139" xml-lang="en-US" l10n="U" oldref="13"> +<item type="input">-2</item> +</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablecontent" id="par_id3149542" xml-lang="en-US" l10n="U" oldref="14"> +<item type="input">0</item> +</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph role="tablecontent" id="par_id3149188" xml-lang="en-US" l10n="U" oldref="15"> +<emph>5</emph> +</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablecontent" id="par_id3153329" xml-lang="en-US" l10n="U" oldref="16"> +<item type="input">-1</item> +</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablecontent" id="par_id3155257" xml-lang="en-US" l10n="U" oldref="17"> +<item type="input">1</item> +</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph role="tablecontent" id="par_id3145142" xml-lang="en-US" l10n="U" oldref="18"> +<emph>6</emph> +</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablecontent" id="par_id3149956" xml-lang="en-US" l10n="U" oldref="19"> +<item type="input">0</item> +</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablecontent" id="par_id3145594" xml-lang="en-US" l10n="U" oldref="20"> +<item type="input">3</item> +</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph role="tablecontent" id="par_id3153113" xml-lang="en-US" l10n="U" oldref="21"> +<emph>7</emph> +</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablecontent" id="par_id3148573" xml-lang="en-US" l10n="U" oldref="22"> +<item type="input">2</item> +</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablecontent" id="par_id3145166" xml-lang="en-US" l10n="U" oldref="23"> +<item type="input">4</item> +</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph role="tablecontent" id="par_id3157998" xml-lang="en-US" l10n="U" oldref="24"> +<emph>8</emph> +</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablecontent" id="par_id3150018" xml-lang="en-US" l10n="U" oldref="25"> +<item type="input">4</item> +</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablecontent" id="par_id3150129" xml-lang="en-US" l10n="U" oldref="26"> +<item type="input">6</item> +</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph role="tablecontent" id="par_id3145245" xml-lang="en-US" l10n="U" oldref="27"> +<emph>9</emph> +</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablecontent" id="par_id3148389" xml-lang="en-US" l10n="U" oldref="28"> +<item type="input">6</item> +</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablecontent" id="par_id3156068" xml-lang="en-US" l10n="U" oldref="29"> +<item type="input">8</item> +</paragraph> +</tablecell> +</tablerow> +</table> + +<sort order="asc"> +<section id="info"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3691824"><bookmark_value>INFO function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_INFO" id="bm_id5369426" localize="false"/> +<paragraph role="heading" id="hd_id5787224" xml-lang="en-US" level="2" l10n="NEW">INFO</paragraph> +<paragraph role="paragraph" id="par_id1507309" xml-lang="en-US" l10n="NEW">Returns specific information about the current working environment. The function receives a single text argument and returns data depending on that parameter.</paragraph> +<paragraph role="heading" id="hd_id7693411" xml-lang="en-US" level="3" l10n="NEW">Syntax</paragraph> +<paragraph role="code" id="par_id3928952" xml-lang="en-US" l10n="NEW">INFO("Type")</paragraph> +<paragraph role="paragraph" id="par_id5206762" xml-lang="en-US" l10n="NEW">The following table lists the values for the text parameter <item type="literal">Type</item> and the return values of the INFO function.</paragraph> +<table id="tbl_id1342204"> +<tablerow> +<tablecell> +<paragraph role="tablehead" id="par_id5735953" xml-lang="en-US" l10n="NEW">Value for "Type"<comment>Do not translate the text values in this column below</comment></paragraph> +</tablecell> +<tablecell> +<paragraph role="tablehead" id="par_id8360850" xml-lang="en-US" l10n="NEW">Return value</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph role="tablecontent" id="par_id9648731" xml-lang="en-US" l10n="NEW">"osversion"</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablecontent" id="par_id908841" xml-lang="en-US" l10n="NEW">Always "Windows (32-bit) NT 5.01", for compatibility reasons</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph role="tablecontent" id="par_id8193914" xml-lang="en-US" l10n="NEW">"system"</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablecontent" id="par_id9841608" xml-lang="en-US" l10n="NEW">The type of the operating system. <br/>"WNT" for Microsoft Windows <br/>"LINUX" for Linux <br/>"SOLARIS" for Solaris</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph role="tablecontent" id="par_id2701803" xml-lang="en-US" l10n="NEW">"release"</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablecontent" id="par_id2136295" xml-lang="en-US" l10n="NEW">The product release identifier, for example "300m25(Build:9876)"</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph role="tablecontent" id="par_id9200109" xml-lang="en-US" l10n="NEW">"numfile"</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablecontent" id="par_id4186223" xml-lang="en-US" l10n="NEW">Always 1, for compatibility reasons</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph role="tablecontent" id="par_id5766472" xml-lang="en-US" l10n="NEW">"recalc"</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablecontent" id="par_id1491134" xml-lang="en-US" l10n="NEW">Current formula recalculation mode, either "Automatic" or "Manual" (localized into %PRODUCTNAME language)</paragraph> +</tablecell> +</tablerow> +</table> + +<paragraph role="note" id="par_id1161534" xml-lang="en-US" l10n="NEW">Other spreadsheet applications may accept localized values for the <item type="literal">Type</item> parameter, but %PRODUCTNAME Calc will only accept the English values.</paragraph> +<paragraph role="heading" id="hd_id5459456" xml-lang="en-US" level="3" l10n="NEW">Example</paragraph> +<paragraph role="paragraph" id="par_id3994567" xml-lang="en-US" l10n="NEW"> +<item type="input">=INFO("release")</item> returns the product release number of the %PRODUCTNAME in use.<comment>Do not translate "release"</comment></paragraph> +<paragraph role="paragraph" id="par_id2873622" xml-lang="en-US" l10n="NEW"> +<item type="input">=INFO(D5)</item> with cell <item type="literal">D5</item> containing a text string <item type="literal">system</item> returns the operation system type.<comment>Do not translate the hlp_literal system</comment></paragraph> +</section> +<section id="current"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3155625"><bookmark_value>CURRENT function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_AKTUELL" id="bm_id3145295" localize="false"/> +<paragraph role="heading" id="hd_id3155625" xml-lang="en-US" level="2" l10n="U" oldref="30">CURRENT</paragraph> +<paragraph role="paragraph" id="par_id3157975" xml-lang="en-US" l10n="CHG" oldref="31"><ahelp hid="HID_FUNC_AKTUELL">This function returns the result to date of evaluating the formula of which it is a part (in other words the result as far as that evaluation has got). Its main use is together with the STYLE() function to apply selected styles to a cell depending on the cell contents.</ahelp></paragraph> +<paragraph role="heading" id="hd_id3148880" xml-lang="en-US" level="3" l10n="U" oldref="32">Syntax</paragraph> +<paragraph role="code" id="par_id3150930" xml-lang="en-US" l10n="U" oldref="33">CURRENT()</paragraph> +<paragraph role="heading" id="hd_id3145629" xml-lang="en-US" level="3" l10n="U" oldref="34">Example</paragraph> +<paragraph role="paragraph" id="par_id5919064" xml-lang="en-US" l10n="NEW"> +<item type="input">=1+2+CURRENT()</item> +</paragraph> +<paragraph role="paragraph" id="par_id8751792" xml-lang="en-US" l10n="NEW">The example returns 6. The formula is calculated from left to right as: 1 + 2 equals 3, giving the result to date when CURRENT() is encountered; CURRENT() therefore yields 3, which is added to the original 3 to give 6.</paragraph> +<paragraph role="paragraph" id="par_id5863826" xml-lang="en-US" l10n="NEW"> +<item type="input">=A2+B2+STYLE(IF(CURRENT()>10;”Red”;”Default”))</item> +</paragraph> +<paragraph role="paragraph" id="par_id7463911" xml-lang="en-US" l10n="NEW">The example returns A2 + B2 (STYLE returns 0 here). If this sum is greater than 10, the style Red is applied to the cell. See the <emph>STYLE</emph> function for more explanation.</paragraph> +<paragraph role="paragraph" id="par_id7318643" xml-lang="en-US" l10n="NEW"> +<item type="input">="choo"&CURRENT()</item> +</paragraph> +<paragraph role="paragraph" id="par_id6019165" xml-lang="en-US" l10n="NEW">The example returns choochoo.</paragraph> +</section> +<section id="formula"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3150688"><bookmark_value>FORMULA function</bookmark_value> +<bookmark_value>formula cells;displaying formulas in other cells</bookmark_value> +<bookmark_value>displaying;formulas at any position</bookmark_value> +</bookmark><comment>mw added "formula cells;" and "displaying;"</comment> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_FORMEL" id="bm_id3155373" localize="false"/> +<paragraph role="heading" id="hd_id3150688" xml-lang="en-US" level="2" l10n="U" oldref="147">FORMULA</paragraph> +<paragraph role="paragraph" id="par_id3158417" xml-lang="en-US" l10n="CHG" oldref="148"><ahelp hid="HID_FUNC_FORMEL">Displays the formula of a formula cell as a text string.</ahelp></paragraph> +<paragraph role="heading" id="hd_id3154954" xml-lang="en-US" level="3" l10n="U" oldref="149">Syntax</paragraph> +<paragraph role="code" id="par_id3147535" xml-lang="en-US" l10n="CHG" oldref="150">FORMULA(Reference)</paragraph> +<paragraph role="paragraph" id="par_id3014313" xml-lang="en-US" l10n="NEW"> +<emph>Reference</emph> is a reference to a cell containing a formula.</paragraph> +<paragraph role="paragraph" id="par_id8857081" xml-lang="en-US" l10n="NEW">An invalid reference or a reference to a cell with no formula results in the error value #N/A.</paragraph> +<paragraph role="heading" id="hd_id3152820" xml-lang="en-US" level="3" l10n="U" oldref="151">Example</paragraph> +<paragraph role="paragraph" id="par_id3153179" xml-lang="en-US" l10n="CHG" oldref="152">If cell A8 contains the formula <item type="input">=SUM(1;2;3)</item> then</paragraph> +<paragraph role="paragraph" id="par_id3153923" xml-lang="en-US" l10n="CHG" oldref="153"> +<item type="input">=FORMULA(A8)</item> returns the text =SUM(1;2;3).</paragraph> +</section> +<section id="isref"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3155409"><bookmark_value>ISREF function</bookmark_value> +<bookmark_value>references;testing cell contents</bookmark_value> +<bookmark_value>cell contents;testing for references</bookmark_value> +</bookmark><comment>mw added "references;" and "cell contents;"</comment> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_ISTBEZUG" id="bm_id3149774" localize="false"/> +<paragraph role="heading" id="hd_id3155409" xml-lang="en-US" level="2" l10n="U" oldref="37">ISREF</paragraph> +<paragraph role="paragraph" id="par_id3153723" xml-lang="en-US" l10n="CHG" oldref="38"><ahelp hid="HID_FUNC_ISTBEZUG">Tests if the argument is a reference.</ahelp> Returns TRUE if the argument is a reference, returns FALSE otherwise. When given a reference this function does not examine the value being referenced.<comment>i82565</comment></paragraph> +<embed href="text/shared/00/00000001.xhp#wahr"/> +<paragraph role="heading" id="hd_id3147175" xml-lang="en-US" level="3" l10n="U" oldref="39">Syntax</paragraph> +<paragraph role="code" id="par_id3149821" xml-lang="en-US" l10n="U" oldref="40">ISREF(Value)</paragraph> +<paragraph role="paragraph" id="par_id3146152" xml-lang="en-US" l10n="U" oldref="41"> +<emph>Value</emph> is the value to be tested, to determine whether it is a reference.</paragraph> +<paragraph role="heading" id="hd_id3083448" xml-lang="en-US" level="3" l10n="U" oldref="42">Example</paragraph> +<paragraph role="paragraph" id="par_id3154317" xml-lang="en-US" l10n="CHG" oldref="43"> +<item type="input">=ISREF(C5)</item> returns the result TRUE because C5 is a valid reference.</paragraph> +<paragraph role="paragraph" id="par_id9728072" xml-lang="en-US" l10n="CHG"> +<item type="input">=ISREF("abcdef")</item> returns always FALSE because a text can never be a reference.</paragraph> +<paragraph role="paragraph" id="par_id2131544" xml-lang="en-US" l10n="NEW"> +<item type="input">=ISREF(4)</item> returns FALSE.</paragraph> +<paragraph role="paragraph" id="par_id4295480" xml-lang="en-US" l10n="NEW"> +<item type="input">=ISREF(INDIRECT("A6"))</item> returns TRUE, because INDIRECT is a function that returns a reference.</paragraph> +<paragraph role="paragraph" id="par_id3626819" xml-lang="en-US" l10n="NEW"> +<item type="input">=ISREF(ADDRESS(1; 1; 2;"Sheet2"))</item> returns FALSE, because ADDRESS is a function that returns a text, although it looks like a reference.</paragraph> +</section> +<section id="iserr"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3154812"><bookmark_value>ISERR function</bookmark_value> +<bookmark_value>error codes;controlling</bookmark_value> +</bookmark><comment>mw added "error codes,"</comment> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_ISTFEHL" id="bm_id3145081" localize="false"/> +<paragraph role="heading" id="hd_id3154812" xml-lang="en-US" level="2" l10n="U" oldref="45">ISERR</paragraph> +<paragraph role="paragraph" id="par_id3149282" xml-lang="en-US" l10n="CHG" oldref="46"><ahelp hid="HID_FUNC_ISTFEHL">Tests for error conditions, except the #N/A error value, and returns TRUE or FALSE.</ahelp></paragraph> +<embed href="text/shared/00/00000001.xhp#wahr"/> +<paragraph role="heading" id="hd_id3149450" xml-lang="en-US" level="3" l10n="U" oldref="47">Syntax</paragraph> +<paragraph role="code" id="par_id3156312" xml-lang="en-US" l10n="U" oldref="48">ISERR(Value)</paragraph> +<paragraph role="paragraph" id="par_id3146857" xml-lang="en-US" l10n="CHG" oldref="49"> +<emph>Value</emph> is any value or expression which is tested to see whether an error value other than #N/A is present.</paragraph> +<paragraph role="heading" id="hd_id3153212" xml-lang="en-US" level="3" l10n="U" oldref="50">Example</paragraph> +<paragraph role="paragraph" id="par_id3153276" xml-lang="en-US" l10n="CHG" oldref="51"> +<item type="input">=ISERR(C8)</item> where cell C8 contains <item type="input">=1/0</item> returns TRUE, because 1/0 is an error.</paragraph> +<paragraph role="paragraph" id="par_id8456984" xml-lang="en-US" l10n="NEW"> +<item type="input">=ISERR(C9)</item> where cell C9 contains <item type="input">=NA()</item> returns FALSE, because ISERR() ignores the #N/A error.</paragraph> +</section> +<section id="iserror"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3147081"><bookmark_value>ISERROR function</bookmark_value> +<bookmark_value>recognizing;general errors</bookmark_value> +</bookmark><comment>mw added "recognizing;"</comment> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_ISTFEHLER" id="bm_id3145206" localize="false"/> +<paragraph role="heading" id="hd_id3147081" xml-lang="en-US" level="2" l10n="U" oldref="53">ISERROR</paragraph> +<paragraph role="paragraph" id="par_id3156316" xml-lang="en-US" l10n="CHG" oldref="54"><ahelp hid="HID_FUNC_ISTFEHLER">Tests for error conditions, including the #N/A error value, and returns TRUE or FALSE.</ahelp></paragraph> +<embed href="text/shared/00/00000001.xhp#wahr"/> +<paragraph role="heading" id="hd_id3147569" xml-lang="en-US" level="3" l10n="U" oldref="55">Syntax</paragraph> +<paragraph role="code" id="par_id3153155" xml-lang="en-US" l10n="U" oldref="56">ISERROR(Value)</paragraph> +<paragraph role="paragraph" id="par_id3154047" xml-lang="en-US" l10n="CHG" oldref="57"> +<emph>Value</emph> is or refers to the value to be tested. ISERROR() returns TRUE if there is an error and FALSE if not.</paragraph> +<paragraph role="heading" id="hd_id3155994" xml-lang="en-US" level="3" l10n="U" oldref="58">Example</paragraph> +<paragraph role="paragraph" id="par_id3150256" xml-lang="en-US" l10n="CHG" oldref="59"> +<item type="input">=ISERROR(C8)</item> where cell C8 contains <item type="input">=1/0</item> returns TRUE, because 1/0 is an error.</paragraph> +<paragraph role="paragraph" id="par_id1889095" xml-lang="en-US" l10n="NEW"> +<item type="input">=ISERROR(C9)</item> where cell C9 contains <item type="input">=NA()</item> returns TRUE.</paragraph> +</section> +<section id="isformula"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3153618"><bookmark_value>ISFORMULA function</bookmark_value> +<bookmark_value>recognizing formula cells</bookmark_value> +<bookmark_value>formula cells;recognizing</bookmark_value> +</bookmark><comment>mw inserted "recognizing..." and "formula cells;"</comment> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_ISTFORMEL" id="bm_id3154740" localize="false"/> +<paragraph role="heading" id="hd_id3153618" xml-lang="en-US" level="2" l10n="U" oldref="61">ISFORMULA</paragraph> +<paragraph role="paragraph" id="par_id3149138" xml-lang="en-US" l10n="U" oldref="62"><ahelp hid="HID_FUNC_ISTFORMEL">Returns TRUE if a cell is a formula cell.</ahelp></paragraph> +<embed href="text/shared/00/00000001.xhp#wahr"/> +<paragraph role="heading" id="hd_id3155100" xml-lang="en-US" level="3" l10n="U" oldref="63">Syntax</paragraph> +<paragraph role="code" id="par_id3143230" xml-lang="en-US" l10n="U" oldref="64">ISFORMULA(Reference)</paragraph> +<paragraph role="paragraph" id="par_id3150150" xml-lang="en-US" l10n="U" oldref="65"> +<emph>Reference</emph> indicates the reference to a cell in which a test will be performed to determine if it contains a formula.</paragraph> +<paragraph role="heading" id="hd_id3147491" xml-lang="en-US" level="3" l10n="U" oldref="66">Example</paragraph> +<paragraph role="paragraph" id="par_id3159182" xml-lang="en-US" l10n="CHG" oldref="67"> +<item type="input">=ISFORMULA(C4)</item> returns FALSE if the cell C4 contains the number <item type="input">5</item>.</paragraph> +</section> +<section id="iseven_add"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3149760"><bookmark_value>ISEVEN_ADD function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_ISEVEN" id="bm_id3146094" localize="false"/> +<paragraph role="heading" id="hd_id3149760" xml-lang="en-US" level="2" oldref="229">ISEVEN_ADD</paragraph> +<paragraph role="paragraph" id="par_id3147253" xml-lang="en-US" l10n="CHG" oldref="230"><ahelp hid="HID_AAI_FUNC_ISEVEN">Tests for even numbers. Returns 1 if the number divided by 2 returns a whole number.</ahelp></paragraph> +<embed href="text/scalc/01/04060102.xhp#ADD_note"/> +<paragraph role="heading" id="hd_id3152799" xml-lang="en-US" level="3" l10n="U" oldref="231">Syntax</paragraph> +<paragraph role="code" id="par_id3149202" xml-lang="en-US" l10n="U" oldref="232">ISEVEN_ADD(Number)</paragraph> +<paragraph role="paragraph" id="par_id3151168" xml-lang="en-US" l10n="CHG" oldref="233"> +<emph>Number</emph> is the number to be tested.</paragraph> +<paragraph role="heading" id="hd_id3150115" xml-lang="en-US" level="3" l10n="U" oldref="234">Example</paragraph> +<paragraph role="paragraph" id="par_id3153904" xml-lang="en-US" l10n="U" oldref="235"> +<item type="input">=ISEVEN_ADD(5)</item> returns 0.</paragraph> +<paragraph role="paragraph" id="par_id6238308" xml-lang="en-US" l10n="NEW"> +<item type="input">=ISEVEN_ADD(A1)</item> returns 1 if cell A1 contains the number <item type="input">2</item>.</paragraph> +</section> +<section id="isnontext"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3154692"><bookmark_value>ISNONTEXT function</bookmark_value> +<bookmark_value>cell contents;no text</bookmark_value> +</bookmark><comment>mw added "cell contents;"</comment> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_ISTKTEXT" id="bm_id3159342" localize="false"/> +<paragraph role="heading" id="hd_id3154692" xml-lang="en-US" level="2" l10n="U" oldref="68">ISNONTEXT</paragraph> +<paragraph role="paragraph" id="par_id3155330" xml-lang="en-US" l10n="U" oldref="69"><ahelp hid="HID_FUNC_ISTKTEXT">Tests if the cell contents are text or numbers, and returns FALSE if the contents are text.</ahelp></paragraph> +<paragraph role="paragraph" id="par_id5719779" xml-lang="en-US" l10n="NEW">If an error occurs, the function returns TRUE.</paragraph> +<paragraph role="heading" id="hd_id3154931" xml-lang="en-US" level="3" l10n="U" oldref="70">Syntax</paragraph> +<paragraph role="code" id="par_id3148829" xml-lang="en-US" l10n="U" oldref="71">ISNONTEXT(Value)</paragraph> +<paragraph role="paragraph" id="par_id3146992" xml-lang="en-US" l10n="U" oldref="72"> +<emph>Value</emph> is any value or expression where a test is performed to determine whether it is a text or numbers or a Boolean value.</paragraph> +<paragraph role="heading" id="hd_id3150525" xml-lang="en-US" level="3" l10n="U" oldref="73">Example</paragraph> +<paragraph role="paragraph" id="par_id3149906" xml-lang="en-US" l10n="CHG" oldref="74"> +<item type="input">=ISNONTEXT(D2)</item> returns FALSE if cell D2 contains the text <item type="input">abcdef</item>.</paragraph> +<paragraph role="paragraph" id="par_id3150777" xml-lang="en-US" l10n="CHG" oldref="75"> +<item type="input">=ISNONTEXT(D9)</item> returns TRUE if cell D9 contains the number <item type="input">8</item>.</paragraph> +</section> +<section id="isblank"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3159148"><bookmark_value>ISBLANK function</bookmark_value> +<bookmark_value>blank cell contents</bookmark_value> +<bookmark_value>empty cells; recognizing</bookmark_value> +</bookmark><comment>mw added "blank..." and "empty cells;"</comment> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_ISTLEER" id="bm_id3148940" localize="false"/> +<paragraph role="heading" id="hd_id3159148" xml-lang="en-US" level="2" l10n="U" oldref="77">ISBLANK</paragraph> +<paragraph role="paragraph" id="par_id3148800" xml-lang="en-US" l10n="U" oldref="78"><ahelp hid="HID_FUNC_ISTLEER">Returns TRUE if the reference to a cell is blank.</ahelp> This function is used to determine if the content of a cell is empty. A cell with a formula inside is not empty. </paragraph> +<embed href="text/shared/00/00000001.xhp#wahr"/> +<paragraph role="heading" id="hd_id3159162" xml-lang="en-US" level="3" l10n="U" oldref="79">Syntax</paragraph> +<paragraph role="code" id="par_id3158406" xml-lang="en-US" l10n="U" oldref="80">ISBLANK(Value)</paragraph> +<paragraph role="paragraph" id="par_id3154212" xml-lang="en-US" l10n="U" oldref="81"> +<emph>Value</emph> is the content to be tested.</paragraph> +<paragraph role="heading" id="hd_id3147508" xml-lang="en-US" level="3" l10n="U" oldref="82">Example</paragraph> +<paragraph role="paragraph" id="par_id3147234" xml-lang="en-US" l10n="U" oldref="83"> +<item type="input">=ISBLANK(D2)</item> returns FALSE as a result.</paragraph> +</section> +<section id="islogical"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3155356"><bookmark_value>ISLOGICAL function</bookmark_value> +<bookmark_value>number formats;logical</bookmark_value> +<bookmark_value>logical number formats</bookmark_value> +</bookmark><comment>mw added "number formats;" and "logical..."</comment> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_ISTLOG" id="bm_id3158424" localize="false"/> +<paragraph role="heading" id="hd_id3155356" xml-lang="en-US" level="2" l10n="U" oldref="85">ISLOGICAL</paragraph> +<paragraph role="paragraph" id="par_id3148926" xml-lang="en-US" l10n="CHG" oldref="86"><ahelp hid="HID_FUNC_ISTLOG">Tests for a logical value (TRUE or FALSE).</ahelp></paragraph> +<paragraph role="paragraph" id="par_id3541062" xml-lang="en-US" l10n="NEW">If an error occurs, the function returns FALSE.</paragraph> +<paragraph role="heading" id="hd_id3149162" xml-lang="en-US" level="3" l10n="U" oldref="87">Syntax</paragraph> +<paragraph role="code" id="par_id3148918" xml-lang="en-US" l10n="U" oldref="88">ISLOGICAL(Value)</paragraph> +<paragraph role="paragraph" id="par_id3146946" xml-lang="en-US" l10n="CHG" oldref="89">Returns TRUE if <emph>Value</emph> is a logical value (TRUE or FALSE), and returns FALSE otherwise.</paragraph> +<paragraph role="heading" id="hd_id3150709" xml-lang="en-US" level="3" l10n="U" oldref="90">Example</paragraph> +<paragraph role="paragraph" id="par_id3166442" xml-lang="en-US" l10n="CHG" oldref="91"> +<item type="input">=ISLOGICAL(99)</item> returns FALSE, because 99 is a number, not a logical value.</paragraph> +<paragraph role="paragraph" id="par_id3556016" xml-lang="en-US" l10n="NEW"> +<item type="input">=ISLOGICAL(ISNA(D4))</item> returns TRUE whatever the contents of cell D4, because ISNA() returns a logical value.</paragraph> +</section> +<section id="isna"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3153685"><bookmark_value>ISNA function</bookmark_value> +<bookmark_value>#N/A error;recognizing</bookmark_value> +</bookmark><comment>mw added "#N/A ..."</comment> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_ISTNV" id="bm_id3159273" localize="false"/> +<paragraph role="heading" id="hd_id3153685" xml-lang="en-US" level="2" l10n="U" oldref="93">ISNA</paragraph> +<paragraph role="paragraph" id="par_id3149105" xml-lang="en-US" l10n="U" oldref="94"><ahelp hid="HID_FUNC_ISTNV">Returns TRUE if a cell contains the #N/A (value not available) error value.</ahelp></paragraph> +<paragraph role="paragraph" id="par_id6018860" xml-lang="en-US" l10n="NEW">If an error occurs, the function returns FALSE.</paragraph> +<paragraph role="heading" id="hd_id3152947" xml-lang="en-US" level="3" l10n="U" oldref="95">Syntax</paragraph> +<paragraph role="code" id="par_id3153748" xml-lang="en-US" l10n="U" oldref="96">ISNA(Value)</paragraph> +<paragraph role="paragraph" id="par_id3152884" xml-lang="en-US" l10n="U" oldref="97"> +<emph>Value</emph> is the value or expression to be tested.</paragraph> +<paragraph role="heading" id="hd_id3149964" xml-lang="en-US" level="3" l10n="U" oldref="98">Example</paragraph> +<paragraph role="paragraph" id="par_id3154852" xml-lang="en-US" l10n="U" oldref="99"> +<item type="input">=ISNA(D3)</item> returns FALSE as a result.</paragraph> +</section> +<section id="istext"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3149426"><bookmark_value>ISTEXT function</bookmark_value> +<bookmark_value>cell contents;text</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_ISTTEXT" id="bm_id3148468" localize="false"/> +<paragraph role="heading" id="hd_id3149426" xml-lang="en-US" level="2" l10n="U" oldref="101">ISTEXT</paragraph> +<paragraph role="paragraph" id="par_id3145368" xml-lang="en-US" l10n="U" oldref="102"><ahelp hid="HID_FUNC_ISTTEXT">Returns TRUE if the cell contents refer to text.</ahelp></paragraph> +<paragraph role="paragraph" id="par_id6779686" xml-lang="en-US" l10n="NEW">If an error occurs, the function returns FALSE.</paragraph> +<paragraph role="heading" id="hd_id3154332" xml-lang="en-US" level="3" l10n="U" oldref="103">Syntax</paragraph> +<paragraph role="code" id="par_id3148649" xml-lang="en-US" l10n="U" oldref="104">ISTEXT(Value)</paragraph> +<paragraph role="paragraph" id="par_id3150417" xml-lang="en-US" l10n="U" oldref="105"> +<emph>Value</emph> is a value, number, Boolean value, or an error value to be tested.</paragraph> +<paragraph role="heading" id="hd_id3149239" xml-lang="en-US" level="3" l10n="U" oldref="106">Example</paragraph> +<paragraph role="paragraph" id="par_id3144756" xml-lang="en-US" l10n="CHG" oldref="107"> +<item type="input">=ISTEXT(D9)</item> returns TRUE if cell D9 contains the text <item type="input">abcdef</item>.</paragraph> +<paragraph role="paragraph" id="par_id3148416" xml-lang="en-US" l10n="CHG" oldref="108"> +<item type="input">=ISTEXT(C3)</item> returns FALSE if cell C3 contains the number <item type="input">3</item>.</paragraph> +</section> +<section id="isodd_add"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3153939"><bookmark_value>ISODD_ADD function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_ISODD" id="bm_id3149927" localize="false"/> +<paragraph role="heading" id="hd_id3153939" xml-lang="en-US" level="2" oldref="236">ISODD_ADD</paragraph> +<paragraph role="paragraph" id="par_id3153538" xml-lang="en-US" l10n="U" oldref="237"><ahelp hid="HID_AAI_FUNC_ISODD">Returns TRUE (1) if the number does not return a whole number when divided by 2.</ahelp></paragraph> +<embed href="text/scalc/01/04060102.xhp#ADD_note"/> +<paragraph role="heading" id="hd_id3145601" xml-lang="en-US" level="3" l10n="U" oldref="238">Syntax</paragraph> +<paragraph role="code" id="par_id3149485" xml-lang="en-US" l10n="U" oldref="239">ISODD_ADD(Number)</paragraph> +<paragraph role="paragraph" id="par_id3153315" xml-lang="en-US" l10n="U" oldref="240"> +<emph>Number</emph> is the number to be tested.</paragraph> +<paragraph role="heading" id="hd_id3143274" xml-lang="en-US" level="3" l10n="U" oldref="241">Example</paragraph> +<paragraph role="paragraph" id="par_id3154793" xml-lang="en-US" l10n="U" oldref="242"> +<item type="input">=ISODD_ADD(5)</item> returns 1.</paragraph> +</section> +<section id="isnumber"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3148688"><bookmark_value>ISNUMBER function</bookmark_value> +<bookmark_value>cell contents;numbers</bookmark_value> +</bookmark><comment>mw added "cell contents;"</comment> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_ISTZAHL" id="bm_id3149587" localize="false"/> +<paragraph role="heading" id="hd_id3148688" xml-lang="en-US" level="2" l10n="U" oldref="110">ISNUMBER</paragraph> +<paragraph role="paragraph" id="par_id3154618" xml-lang="en-US" l10n="U" oldref="111"><ahelp hid="HID_FUNC_ISTZAHL">Returns TRUE if the value refers to a number.</ahelp></paragraph> +<embed href="text/shared/00/00000001.xhp#wahr"/> +<paragraph role="heading" id="hd_id3152769" xml-lang="en-US" level="3" l10n="U" oldref="112">Syntax</paragraph> +<paragraph role="code" id="par_id3150595" xml-lang="en-US" l10n="U" oldref="113">ISNUMBER(Value)</paragraph> +<paragraph role="paragraph" id="par_id3150351" xml-lang="en-US" l10n="U" oldref="114"> +<emph>Value</emph> is any expression to be tested to determine whether it is a number or text.</paragraph> +<paragraph role="heading" id="hd_id3146793" xml-lang="en-US" level="3" l10n="U" oldref="115">Example</paragraph> +<paragraph role="paragraph" id="par_id3155614" xml-lang="en-US" l10n="CHG" oldref="116"> +<item type="input">=ISNUMBER(C3)</item> returns TRUE if the cell C3 contains the number <item type="input">4</item>.</paragraph> +<paragraph role="paragraph" id="par_id3154417" xml-lang="en-US" l10n="CHG" oldref="117"> +<item type="input">=ISNUMBER(C2)</item> returns FALSE if the cell C2 contains the text <item type="input">abcdef</item>.</paragraph> +</section> +<section id="n"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3153694"><bookmark_value>N function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_N" id="bm_id3153786" localize="false"/> +<paragraph role="heading" id="hd_id3153694" xml-lang="en-US" level="2" l10n="U" oldref="119">N</paragraph> +<paragraph role="paragraph" id="par_id3150405" xml-lang="en-US" l10n="CHG" oldref="120"><ahelp hid="HID_FUNC_N">Returns the numeric value of the given parameter. Returns 0 if parameter is text or FALSE.</ahelp></paragraph> +<paragraph role="paragraph" id="par_id9115573" xml-lang="en-US" l10n="NEW">If an error occurs the function returns the error value.</paragraph> +<paragraph role="heading" id="hd_id3145774" xml-lang="en-US" level="3" l10n="U" oldref="121">Syntax</paragraph> +<paragraph role="code" id="par_id3153883" xml-lang="en-US" l10n="U" oldref="122">N(Value)</paragraph> +<paragraph role="paragraph" id="par_id3151101" xml-lang="en-US" l10n="CHG" oldref="123"> +<emph>Value</emph> is the parameter to be converted into a number. N() returns the numeric value if it can. It returns the logical values TRUE and FALSE as 1 and 0 respectively. It returns text as 0.</paragraph> +<paragraph role="heading" id="hd_id3147097" xml-lang="en-US" level="3" l10n="U" oldref="124">Example</paragraph> +<paragraph role="paragraph" id="par_id3154117" xml-lang="en-US" l10n="CHG" oldref="125"> +<item type="input">=N(123)</item> returns 123</paragraph> +<paragraph role="paragraph" id="par_id2337717" xml-lang="en-US" l10n="NEW"> +<item type="input">=N(TRUE)</item> returns 1</paragraph> +<paragraph role="paragraph" id="par_id3153781" xml-lang="en-US" l10n="U" oldref="126"> +<item type="input">=N(FALSE)</item> returns 0</paragraph> +<paragraph role="paragraph" id="par_id3154670" xml-lang="en-US" l10n="U" oldref="243"> +<item type="input">=N("abc")</item> returns 0</paragraph> +<paragraph role="paragraph" id="par_id3519089" xml-lang="en-US" l10n="NEW">=N(1/0) returns #DIV/0!</paragraph> +</section> +<section id="na"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3156275"><bookmark_value>NA function</bookmark_value> +<bookmark_value>#N/A error;assigning to a cell</bookmark_value> +</bookmark><comment>mw added "#N/A error;"</comment> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_NV" id="bm_id3154569" localize="false"/> +<paragraph role="heading" id="hd_id3156275" xml-lang="en-US" level="2" l10n="U" oldref="129">NA</paragraph> +<paragraph role="paragraph" id="par_id3156161" xml-lang="en-US" l10n="U" oldref="130"><ahelp hid="HID_FUNC_NV">Returns the error value #N/A.</ahelp></paragraph> +<paragraph role="heading" id="hd_id3147532" xml-lang="en-US" level="3" l10n="U" oldref="131">Syntax</paragraph> +<paragraph role="code" id="par_id3149563" xml-lang="en-US" l10n="U" oldref="132">NA()</paragraph> +<paragraph role="heading" id="hd_id3155128" xml-lang="en-US" level="3" l10n="U" oldref="133">Example</paragraph> +<paragraph role="paragraph" id="par_id3154481" xml-lang="en-US" l10n="U" oldref="134"> +<item type="input">=NA()</item> converts the contents of the cell into #N/A.</paragraph> +</section> +<section id="type"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3151255"><bookmark_value>TYPE function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_TYP" id="bm_id3146127" localize="false"/> +<paragraph role="heading" id="hd_id3151255" xml-lang="en-US" level="2" l10n="U" oldref="136">TYPE</paragraph> +<paragraph role="paragraph" id="par_id3155900" xml-lang="en-US" l10n="U" oldref="137"><ahelp hid="HID_FUNC_TYP">Returns the type of value.</ahelp></paragraph> +<embed href="text/shared/00/00000001.xhp#wahr"/> +<paragraph role="heading" id="hd_id3149992" xml-lang="en-US" level="3" l10n="U" oldref="138">Syntax</paragraph> +<paragraph role="code" id="par_id3148400" xml-lang="en-US" l10n="U" oldref="139">TYPE(Value)</paragraph> +<paragraph role="paragraph" id="par_id3150830" xml-lang="en-US" l10n="U" oldref="140"> +<emph>Value</emph> is a specific value for which the data type is determined. Value 1 = number, value 2 = text, value 4 = Boolean value, value 8 = formula, value 16 = error value.</paragraph> +<paragraph role="heading" id="hd_id3154363" xml-lang="en-US" level="3" l10n="U" oldref="141">Example (see example table above)</paragraph> +<paragraph role="paragraph" id="par_id3153357" xml-lang="en-US" l10n="U" oldref="142"> +<item type="input">=TYPE(C2)</item> returns 2 as a result.</paragraph> +<paragraph role="paragraph" id="par_id3148980" xml-lang="en-US" l10n="U" oldref="143"> +<item type="input">=TYPE(D9)</item> returns 1 as a result.</paragraph> +</section> +<section id="cell"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3155509"><bookmark_value>CELL function</bookmark_value> +<bookmark_value>cell information</bookmark_value> +<bookmark_value>information on cells</bookmark_value> +</bookmark><comment>mw added two entries</comment> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_ZELLE" id="bm_id3159412" localize="false"/> +<paragraph role="heading" id="hd_id3155509" xml-lang="en-US" level="2" l10n="U" oldref="154">CELL</paragraph> +<paragraph role="paragraph" id="par_id3153196" xml-lang="en-US" l10n="U" oldref="155"><ahelp hid="HID_FUNC_ZELLE">Returns information on address, formatting or contents of a cell.</ahelp></paragraph> +<paragraph role="heading" id="hd_id3149323" xml-lang="en-US" level="3" l10n="U" oldref="156">Syntax</paragraph> +<paragraph role="code" id="par_id3147355" xml-lang="en-US" l10n="U" oldref="157">CELL("InfoType"; Reference)</paragraph> +<paragraph role="paragraph" id="par_id3154716" xml-lang="en-US" l10n="U" oldref="158"> +<emph>InfoType</emph> is the character string that specifies the type of information. The character string is always in English. Upper or lower case is optional.</paragraph> +<table id="tbl_id3152470"> +<tablerow> +<tablecell> +<paragraph role="tablehead" id="par_id3150636" xml-lang="en-US" l10n="U" oldref="165">InfoType</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablehead" id="par_id3149344" xml-lang="en-US" l10n="U" oldref="166">Meaning</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph role="code" id="par_id3153266" xml-lang="en-US" l10n="U" oldref="167">COL</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablecontent" id="par_id3156204" xml-lang="en-US" l10n="U" oldref="168">Returns the number of the referenced column.</paragraph> +<paragraph role="tablecontent" id="par_id3150094" xml-lang="en-US" l10n="U" oldref="162"> +<item type="input">=CELL("COL";D2)</item> returns 4.</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph role="code" id="par_id3151276" xml-lang="en-US" l10n="U" oldref="169">ROW</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablecontent" id="par_id3147583" xml-lang="en-US" l10n="U" oldref="170">Returns the number of the referenced row.</paragraph> +<paragraph role="tablecontent" id="par_id3151222" xml-lang="en-US" l10n="U" oldref="163"> +<item type="input">=CELL("ROW";D2)</item> returns 2.</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph role="code" id="par_id3159217" xml-lang="en-US" l10n="U" oldref="171">SHEET</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablecontent" id="par_id3151201" xml-lang="en-US" l10n="U" oldref="172">Returns the number of the referenced sheet.</paragraph> +<paragraph role="tablecontent" id="par_id3149169" xml-lang="en-US" l10n="U" oldref="164"> +<item type="input">=CELL("Sheet";Sheet3.D2)</item> returns 3.</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph role="code" id="par_id3149431" xml-lang="en-US" l10n="U" oldref="173">ADDRESS</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablecontent" id="par_id3156054" xml-lang="en-US" l10n="U" oldref="174">Returns the absolute address of the referenced cell.</paragraph> +<paragraph role="tablecontent" id="par_id3154136" xml-lang="en-US" l10n="U" oldref="175"> +<item type="input">=CELL("ADDRESS";D2)</item> returns $D$2.</paragraph> +<paragraph role="tablecontent" id="par_id3159198" xml-lang="en-US" l10n="U" oldref="176"> +<item type="input">=CELL("ADDRESS";Sheet3.D2)</item> returns $Sheet3.$D$2.</paragraph> +<paragraph role="tablecontent" id="par_id3150245" xml-lang="en-US" l10n="U" oldref="177"> +<item type="input">=CELL("ADDRESS";'X:\dr\test.sxc'#$Sheet1.D2)</item> returns 'file:///X:/dr/test.sxc'#$Sheet1.$D$2.</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph role="code" id="par_id3146811" xml-lang="en-US" l10n="U" oldref="178">FILENAME</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablecontent" id="par_id3151328" xml-lang="en-US" l10n="U" oldref="179">Returns the file name and the sheet number of the referenced cell.</paragraph> +<paragraph role="tablecontent" id="par_id3148896" xml-lang="en-US" l10n="U" oldref="180"> +<item type="input">=CELL("FILENAME";D2)</item> returns 'file:///X:/dr/own.sxc'#$Sheet1, if the formula in the current document X:\dr\own.sxc is located in Sheet1.</paragraph> +<paragraph role="tablecontent" id="par_id3155144" xml-lang="en-US" l10n="U" oldref="181"> +<item type="input">=CELL("FILENAME";'X:\dr\test.sxc'#$Sheet1.D2)</item> returns 'file:///X:/dr/test.sxc'#$Sheet1.</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph role="code" id="par_id3151381" xml-lang="en-US" l10n="U" oldref="182">COORD</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablecontent" id="par_id3151004" xml-lang="en-US" l10n="U" oldref="183">Returns the complete cell address in Lotus(TM) notation.</paragraph> +<paragraph role="tablecontent" id="par_id3159104" xml-lang="en-US" l10n="U" oldref="184"> +<item type="input">=CELL("COORD"; D2)</item> returns $A:$D$2.</paragraph> +<paragraph role="tablecontent" id="par_id3163720" xml-lang="en-US" l10n="U" oldref="185"> +<item type="input">=CELL("COORD"; Sheet3.D2)</item> returns $C:$D$2.</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph role="code" id="par_id3155910" xml-lang="en-US" l10n="U" oldref="186">CONTENTS</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablecontent" id="par_id3156041" xml-lang="en-US" l10n="U" oldref="187">Returns the contents of the referenced cell, without any formatting.</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph role="code" id="par_id3151069" xml-lang="en-US" l10n="U" oldref="188">TYPE</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablecontent" id="par_id3155344" xml-lang="en-US" l10n="U" oldref="189">Returns the type of cell contents.</paragraph> +<paragraph role="tablecontent" id="par_id3145217" xml-lang="en-US" l10n="U" oldref="190">b = blank. empty cell</paragraph> +<paragraph role="tablecontent" id="par_id3155176" xml-lang="en-US" l10n="U" oldref="191">l = label. Text, result of a formula as text</paragraph> +<paragraph role="tablecontent" id="par_id3147280" xml-lang="en-US" l10n="U" oldref="192">v = value. Value, result of a formula as a number</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph role="code" id="par_id3156348" xml-lang="en-US" l10n="U" oldref="193">WIDTH</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablecontent" id="par_id3154920" xml-lang="en-US" l10n="U" oldref="194">Returns the width of the referenced column. The unit is the number of zeros (0) that fit into the column in the default text and the default size.</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph role="code" id="par_id3152355" xml-lang="en-US" l10n="U" oldref="195">PREFIX</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablecontent" id="par_id3154230" xml-lang="en-US" l10n="U" oldref="196">Returns the alignment of the referenced cell.</paragraph> +<paragraph role="tablecontent" id="par_id3155946" xml-lang="en-US" l10n="U" oldref="197">' = align left or left-justified</paragraph> +<paragraph role="tablecontent" id="par_id3147220" xml-lang="en-US" l10n="U" oldref="198">" = align right</paragraph> +<paragraph role="tablecontent" id="par_id3149038" xml-lang="en-US" l10n="U" oldref="199">^ = centered</paragraph> +<paragraph role="tablecontent" id="par_id3153129" xml-lang="en-US" l10n="U" oldref="200">\ = repeating (currently inactive)</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph role="code" id="par_id3154406" xml-lang="en-US" l10n="U" oldref="201">PROTECT</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablecontent" id="par_id3145127" xml-lang="en-US" l10n="U" oldref="202">Returns the status of the cell protection for the cell.</paragraph> +<paragraph role="tablecontent" id="par_id3155794" xml-lang="en-US" l10n="U" oldref="203">1 = cell is protected</paragraph> +<paragraph role="tablecontent" id="par_id3155072" xml-lang="en-US" l10n="U" oldref="204">0 = cell is not protected</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph role="code" id="par_id3156178" xml-lang="en-US" l10n="U" oldref="205">FORMAT</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablecontent" id="par_id3150220" xml-lang="en-US" l10n="U" oldref="206">Returns a character string that indicates the number format.</paragraph> +<paragraph role="tablecontent" id="par_id3153824" xml-lang="en-US" l10n="U" oldref="207">, = number with thousands separator</paragraph> +<paragraph role="tablecontent" id="par_id3153837" xml-lang="en-US" l10n="U" oldref="208">F = number without thousands separator</paragraph> +<paragraph role="tablecontent" id="par_id3150318" xml-lang="en-US" l10n="U" oldref="209">C = currency format</paragraph> +<paragraph role="tablecontent" id="par_id3153168" xml-lang="en-US" l10n="U" oldref="210">S = exponential representation, for example, 1.234+E56</paragraph> +<paragraph role="tablecontent" id="par_id3153515" xml-lang="en-US" l10n="U" oldref="211">P = percentage</paragraph> +<paragraph role="tablecontent" id="par_id3154375" xml-lang="en-US" l10n="U" oldref="212">In the above formats, the number of decimal places after the decimal separator is given as a number. Example: the number format #,##0.0 returns ,1 and the number format 00.000% returns P3</paragraph> +<paragraph role="tablecontent" id="par_id3150575" xml-lang="en-US" l10n="U" oldref="213">D1 = MMM-D-YY, MM-D-YY and similar formats</paragraph> +<paragraph role="tablecontent" id="par_id3150589" xml-lang="en-US" l10n="U" oldref="214">D2 = DD-MM</paragraph> +<paragraph role="tablecontent" id="par_id3151034" xml-lang="en-US" l10n="U" oldref="215">D3 = MM-YY</paragraph> +<paragraph role="tablecontent" id="par_id3156371" xml-lang="en-US" l10n="U" oldref="216">D4 = DD-MM-YYYY HH:MM:SS</paragraph> +<paragraph role="tablecontent" id="par_id3157881" xml-lang="en-US" l10n="U" oldref="217">D5 = MM-DD</paragraph> +<paragraph role="tablecontent" id="par_id3157894" xml-lang="en-US" l10n="U" oldref="218">D6 = HH:MM:SS AM/PM</paragraph> +<paragraph role="tablecontent" id="par_id3154068" xml-lang="en-US" l10n="U" oldref="219">D7 = HH:MM AM/PM</paragraph> +<paragraph role="tablecontent" id="par_id3150286" xml-lang="en-US" l10n="U" oldref="220">D8 = HH:MM:SS</paragraph> +<paragraph role="tablecontent" id="par_id3145756" xml-lang="en-US" l10n="U" oldref="221">D9 = HH:MM</paragraph> +<paragraph role="tablecontent" id="par_id3145768" xml-lang="en-US" l10n="U" oldref="222">G = All other formats</paragraph> +<paragraph role="tablecontent" id="par_id3153375" xml-lang="en-US" l10n="U" oldref="223">- (Minus) at the end = negative numbers are formatted in color</paragraph> +<paragraph role="tablecontent" id="par_id3155545" xml-lang="en-US" l10n="U" oldref="224">() (brackets) at the end = there is an opening bracket in the format code</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph role="code" id="par_id3154594" xml-lang="en-US" l10n="U" oldref="225">COLOR</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablecontent" id="par_id3152922" xml-lang="en-US" l10n="U" oldref="226">Returns 1, if negative values have been formatted in color, otherwise 0.</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph role="code" id="par_id3145563" xml-lang="en-US" l10n="U" oldref="227">PARENTHESES</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablecontent" id="par_id3156072" xml-lang="en-US" l10n="U" oldref="228">Returns 1 if the format code contains an opening bracket (, otherwise 0.</paragraph> +</tablecell> +</tablerow> +</table> + +<paragraph role="paragraph" id="par_id3156090" xml-lang="en-US" l10n="U" oldref="159"> +<emph>Reference</emph> (list of options) is the position of the cell to be examined. If <emph>Reference</emph> is a range, the cell moves to the top left of the range. If <emph>Reference</emph> is missing, $[officename] Calc uses the position of the cell in which this formula is located. Microsoft Excel uses the reference of the cell in which the cursor is positioned.</paragraph> +</section> +</sort> +<section id="relatedtopics"> +<embed href="text/scalc/01/04060100.xhp#drking"/> +</section> +</body> +</helpdocument> diff --git a/source/text/scalc/01/04060105.xhp b/source/text/scalc/01/04060105.xhp new file mode 100644 index 0000000000..339556b1e9 --- /dev/null +++ b/source/text/scalc/01/04060105.xhp @@ -0,0 +1,178 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> + +<!-- +*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************ + --> + + +<meta> + <topic id="textscalc0104060105xml" indexer="include"> + <title xml-lang="en-US" id="tit">Logical Functions</title> + <filename>/text/scalc/01/04060105.xhp</filename> + </topic> + </meta> + <body> +<bookmark xml-lang="en-US" branch="index" id="bm_id3153484"><bookmark_value>logical functions</bookmark_value> + <bookmark_value>Function Wizard; logical</bookmark_value> + <bookmark_value>functions; logical functions</bookmark_value> +</bookmark> +<paragraph xml-lang="en-US" id="hd_id3153484" role="heading" level="1" l10n="U" oldref="1">Logical Functions</paragraph> + <paragraph xml-lang="en-US" id="par_id3149312" role="paragraph" l10n="U" oldref="2"><variable id="logischtext">This category contains the <emph>Logical</emph> functions. +</variable></paragraph> + <section id="howtoget"> + <embed href="text/scalc/00/00000404.xhp#eikalo"/> + </section> +<sort order="asc"> +<section id="Section6"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3147505"><bookmark_value>AND function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_UND" id="bm_id3145320" localize="false"/> +<paragraph xml-lang="en-US" id="hd_id3147505" role="heading" level="2" l10n="U" + oldref="29">AND</paragraph> + <paragraph xml-lang="en-US" id="par_id3153959" role="paragraph" l10n="U" oldref="65"><ahelp hid="HID_FUNC_UND">Returns TRUE if all arguments are TRUE.</ahelp> If one of the elements is FALSE, this function returns the FALSE value.</paragraph> + <paragraph xml-lang="en-US" id="par_id3146100" role="paragraph" l10n="U" oldref="66">The arguments are either logical expressions themselves (TRUE, 1<5, 2+3=7, B8<10) that return logical values, or arrays (A1:C3) containing logical values.</paragraph> + <paragraph xml-lang="en-US" id="par_id3150538" role="note" l10n="CHG" oldref="67">When a function expects a single value, but you entered a cell range, then the value from the cell range is taken that is in the same column or row as the formula.<comment>UFI: fixed #i18547#</comment></paragraph> + <paragraph xml-lang="en-US" id="par_id3149128" role="note" l10n="CHG" oldref="68">If the entered range is outside of the current column or row of the formula, the function returns the error value #VALUE!</paragraph> + <paragraph xml-lang="en-US" id="hd_id3150374" role="heading" level="3" l10n="U" + oldref="31">Syntax</paragraph> + <paragraph xml-lang="en-US" id="par_id3159123" role="code" l10n="U" oldref="32">AND(LogicalValue1; LogicalValue2 ...LogicalValue30)</paragraph> + <paragraph xml-lang="en-US" id="par_id3150038" role="paragraph" l10n="CHG" oldref="33"> + <emph>LogicalValue1; LogicalValue2 ...LogicalValue30</emph> are conditions to be checked. All conditions can be either TRUE or FALSE. If a range is entered as a parameter, the function uses the value from the range that is in the current column or row. The result is TRUE if the logical value in all cells within the cell range is TRUE.</paragraph> + <paragraph xml-lang="en-US" id="hd_id3149143" role="heading" level="3" l10n="U" + oldref="34">Example</paragraph> + <paragraph xml-lang="en-US" id="par_id3153123" role="paragraph" l10n="U" oldref="35">The logical values of entries 12<13; 14>12, and 7<6 are to be checked:</paragraph> + <paragraph xml-lang="en-US" id="par_id3145632" role="paragraph" l10n="U" oldref="36"> + <item type="input">=AND(12<13;14>12;7<6)</item> returns FALSE.</paragraph> + <paragraph xml-lang="en-US" id="par_id3149946" role="paragraph" l10n="U" oldref="60"> + <item type="input">=AND (FALSE;TRUE)</item> returns FALSE.</paragraph> + </section> + <section id="Section5"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3149015"><bookmark_value>FALSE function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_FALSCH" id="bm_id3154678" localize="false"/> +<paragraph xml-lang="en-US" id="hd_id3149015" role="heading" level="2" l10n="U" oldref="3">FALSE</paragraph> + <paragraph xml-lang="en-US" id="par_id3149890" role="paragraph" l10n="U" oldref="4"><ahelp hid="HID_FUNC_FALSCH">Returns the logical value FALSE.</ahelp> The FALSE() function does not require any arguments, and always returns the logical value FALSE.</paragraph> + <paragraph xml-lang="en-US" id="hd_id3146939" role="heading" level="3" l10n="U" oldref="5">Syntax</paragraph> + <paragraph xml-lang="en-US" id="par_id3150030" role="code" l10n="U" oldref="6">FALSE()</paragraph> + <paragraph xml-lang="en-US" id="hd_id3150697" role="heading" level="3" l10n="U" oldref="7">Example</paragraph> + <paragraph xml-lang="en-US" id="par_id3154842" role="paragraph" l10n="CHG" oldref="8"> + <item type="input">=FALSE()</item> returns FALSE</paragraph> + <paragraph xml-lang="en-US" id="par_id3147468" role="paragraph" l10n="CHG" oldref="9"> + <item type="input">=NOT(FALSE())</item> returns TRUE</paragraph> + </section> + <section id="Section4"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3150141"><bookmark_value>IF function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_WENN" id="bm_id3152789" localize="false"/> +<paragraph xml-lang="en-US" id="hd_id3150141" role="heading" level="2" l10n="U" + oldref="48">IF</paragraph> + <paragraph xml-lang="en-US" id="par_id3148740" role="paragraph" l10n="U" oldref="49"><ahelp hid="HID_FUNC_WENN">Specifies a logical test to be performed.</ahelp></paragraph> + <paragraph xml-lang="en-US" id="hd_id3153325" role="heading" level="3" l10n="U" + oldref="50">Syntax</paragraph> + <paragraph xml-lang="en-US" id="par_id3154558" role="code" l10n="CHG" oldref="51">IF(Test; ThenValue; OtherwiseValue)</paragraph> + <paragraph xml-lang="en-US" id="par_id3149727" role="paragraph" l10n="U" oldref="52"> + <emph>Test</emph> is any value or expression that can be TRUE or FALSE.</paragraph> + <paragraph xml-lang="en-US" id="par_id3155828" role="paragraph" l10n="U" oldref="53"> + <emph>ThenValue</emph> (optional) is the value that is returned if the logical test is TRUE.</paragraph> + <paragraph xml-lang="en-US" id="par_id3154811" role="paragraph" l10n="U" oldref="54"> + <emph>OtherwiseValue</emph> (optional) is the value that is returned if the logical test is FALSE.</paragraph> + <paragraph xml-lang="en-US" id="par_idN107FA" role="paragraph" l10n="NEW"> + <embedvar href="text/scalc/00/00000004.xhp#optional"/> + </paragraph> + <paragraph xml-lang="en-US" id="hd_id3149507" role="heading" level="3" l10n="U" + oldref="55">Examples</paragraph> + <paragraph xml-lang="en-US" id="par_id3150867" role="paragraph" l10n="U" oldref="57"> + <item type="input">=IF(A1>5;100;"too small")</item> If the value in A1 is higher than 5, the value 100 is entered in the current cell; otherwise, the text “too small” (without quotes) is entered.</paragraph> + </section> + <section id="Section3"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3155954"><bookmark_value>NOT function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_NICHT" id="bm_id3145168" localize="false"/> +<paragraph xml-lang="en-US" id="hd_id3155954" role="heading" level="2" l10n="U" + oldref="12">NOT</paragraph> + <paragraph xml-lang="en-US" id="par_id3153570" role="paragraph" l10n="CHG" oldref="13"><ahelp hid="HID_FUNC_NICHT">Complements (inverts) a logical value.</ahelp></paragraph> + <paragraph xml-lang="en-US" id="hd_id3147372" role="heading" level="3" l10n="U" + oldref="14">Syntax</paragraph> + <paragraph xml-lang="en-US" id="par_id3157996" role="code" l10n="U" oldref="15">NOT(LogicalValue)</paragraph> + <paragraph xml-lang="en-US" id="par_id3148766" role="paragraph" l10n="CHG" oldref="16"> + <emph>LogicalValue</emph> is any value to be complemented.</paragraph> + <paragraph xml-lang="en-US" id="hd_id3149884" role="heading" level="3" l10n="U" + oldref="17">Example</paragraph> + <paragraph xml-lang="en-US" id="par_id3150132" role="paragraph" l10n="CHG" oldref="18"> + <item type="input">=NOT(A)</item>. If A=TRUE then NOT(A) will evaluate FALSE.</paragraph> + </section> + <section id="Section2"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3148394"><bookmark_value>OR function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_ODER" id="bm_id3155620" localize="false"/> +<paragraph xml-lang="en-US" id="hd_id3148394" role="heading" level="2" l10n="U" + oldref="20">OR</paragraph> + <paragraph xml-lang="en-US" id="par_id3156060" role="paragraph" l10n="U" oldref="61"><ahelp hid="HID_FUNC_ODER">Returns TRUE if at least one argument is TRUE.</ahelp> This function returns the value FALSE, if all the arguments have the logical value FALSE.</paragraph> + <paragraph xml-lang="en-US" id="par_id3148771" role="paragraph" l10n="U" oldref="62">The arguments are either logical expressions themselves (TRUE, 1<5, 2+3=7, B8<10) that return logical values, or arrays (A1:C3) containing logical values.</paragraph> + <paragraph xml-lang="en-US" id="par_id3153546" role="note" l10n="CHG" oldref="63">When a function expects a single value, but you entered a cell range, then the value from the cell range is taken that is in the same column or row as the formula.</paragraph> + <paragraph xml-lang="en-US" id="par_id3149027" role="note" l10n="CHG" oldref="64">If the entered range is outside of the current column or row of the formula, the function returns the error value #VALUE!</paragraph> + <paragraph xml-lang="en-US" id="hd_id3155517" role="heading" level="3" l10n="U" + oldref="22">Syntax</paragraph> + <paragraph xml-lang="en-US" id="par_id3150468" role="code" l10n="U" oldref="23">OR(LogicalValue1; LogicalValue2 ...LogicalValue30)</paragraph> + <paragraph xml-lang="en-US" id="par_id3155819" role="paragraph" l10n="CHG" oldref="24"> + <emph>LogicalValue1; LogicalValue2 ...LogicalValue30</emph> are conditions to be checked. All conditions can be either TRUE or FALSE. If a range is entered as a parameter, the function uses the value from the range that is in the current column or row.<comment>UFI: first try to fix bugtraq 4905779</comment></paragraph> + <paragraph xml-lang="en-US" id="hd_id3153228" role="heading" level="3" l10n="U" + oldref="25">Example</paragraph> + <paragraph xml-lang="en-US" id="par_id3154870" role="paragraph" l10n="U" oldref="26">The logical values of entries 12<11; 13>22, and 45=45 are to be checked.</paragraph> + <paragraph xml-lang="en-US" id="par_id3155371" role="paragraph" l10n="U" oldref="27"> + <item type="input">=OR(12<11;13>22;45=45)</item> returns TRUE.</paragraph> + <paragraph xml-lang="en-US" id="par_id3158412" role="paragraph" l10n="U" oldref="59"> + <item type="input">=OR(FALSE;TRUE)</item> returns TRUE.</paragraph> + </section> + <section id="Section1"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3156256"><bookmark_value>TRUE function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_WAHR" id="bm_id3148426" localize="false"/> +<paragraph xml-lang="en-US" id="hd_id3156256" role="heading" level="2" l10n="U" + oldref="38">TRUE</paragraph> + <paragraph xml-lang="en-US" id="par_id3155985" role="paragraph" l10n="U" oldref="39"><ahelp hid="HID_FUNC_WAHR">The logical value is set to TRUE.</ahelp> The TRUE() function does not require any arguments, and always returns the logical value TRUE.</paragraph> + <paragraph xml-lang="en-US" id="hd_id3153717" role="heading" level="3" l10n="U" + oldref="40">Syntax</paragraph> + <paragraph xml-lang="en-US" id="par_id3152590" role="code" l10n="U" oldref="41">TRUE()</paragraph> + <paragraph xml-lang="en-US" id="hd_id3147175" role="heading" level="3" l10n="U" + oldref="42">Example</paragraph> + <paragraph xml-lang="en-US" id="par_id3146148" role="paragraph" l10n="U" oldref="43">If A=TRUE and B=FALSE the following examples appear:</paragraph> + <paragraph xml-lang="en-US" id="par_id3083285" role="paragraph" l10n="U" oldref="44"> + <item type="input">=AND(A;B)</item> returns FALSE</paragraph> + <paragraph xml-lang="en-US" id="par_id3083444" role="paragraph" l10n="U" oldref="45"> + <item type="input">=OR(A;B)</item> returns TRUE</paragraph> + <paragraph xml-lang="en-US" id="par_id3154314" role="paragraph" l10n="U" oldref="46"> + <item type="input">=NOT(AND(A;B))</item> returns TRUE</paragraph> + </section> +</sort> +<section id="relatedtopics"> + <embed href="text/scalc/01/04060100.xhp#drking"/> + </section> + </body> +</helpdocument>
\ No newline at end of file diff --git a/source/text/scalc/01/04060106.xhp b/source/text/scalc/01/04060106.xhp new file mode 100644 index 0000000000..e80b11f26a --- /dev/null +++ b/source/text/scalc/01/04060106.xhp @@ -0,0 +1,1497 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> + +<!-- +*********************************************************************** +* + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * +************************************************************************ +--> + +<meta> +<topic id="textscalc0104060106xml" indexer="include"> +<title xml-lang="en-US" id="tit">Mathematical Functions</title> +<filename>/text/scalc/01/04060106.xhp</filename> +</topic> +</meta> +<body> +<bookmark xml-lang="en-US" branch="index" id="bm_id3147124"><bookmark_value>mathematical functions</bookmark_value> +<bookmark_value>Function Wizard; mathematical</bookmark_value> +<bookmark_value>functions; mathematical functions</bookmark_value> +<bookmark_value>trigonometric functions</bookmark_value> +</bookmark> +<paragraph xml-lang="en-US" id="hd_id3147124" role="heading" level="1" l10n="U" oldref="1">Mathematical Functions</paragraph> +<paragraph xml-lang="en-US" id="par_id3154943" role="paragraph" l10n="CHG" oldref="2"><variable id="mathematiktext">This category contains the <emph>Mathematical</emph> functions for Calc. +</variable> To open the <emph>Function Wizard</emph>, choose <link href="text/scalc/01/04060000.xhp" name="Insert - Function"><emph>Insert - Function</emph></link>.</paragraph> +<sort> +<section id="Section1"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3146944"><bookmark_value>ABS function</bookmark_value> +<bookmark_value>absolute values</bookmark_value> +<bookmark_value>values;absolute</bookmark_value> +</bookmark><comment>mw added two entries</comment> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_ABS" id="bm_id3150695" localize="false"/> +<paragraph xml-lang="en-US" id="hd_id3146944" role="heading" level="2" l10n="U" +oldref="33">ABS</paragraph> +<paragraph xml-lang="en-US" id="par_id3154546" role="paragraph" l10n="U" oldref="34"><ahelp hid="HID_FUNC_ABS">Returns the absolute value of a number.</ahelp></paragraph> +<paragraph xml-lang="en-US" id="hd_id3154843" role="heading" level="3" l10n="U" +oldref="35">Syntax</paragraph> +<paragraph xml-lang="en-US" id="par_id3147475" role="code" l10n="U" oldref="36">ABS(Number)</paragraph> +<paragraph xml-lang="en-US" id="par_id3148438" role="paragraph" l10n="CHG" oldref="37"><emph>Number</emph> is the number whose absolute value is to be calculated. The absolute value of a number is its value without the +/- sign.</paragraph> +<paragraph xml-lang="en-US" id="hd_id3155823" role="heading" level="3" l10n="U" +oldref="38">Example</paragraph> +<paragraph xml-lang="en-US" id="par_id3152787" role="paragraph" l10n="CHG" oldref="39"> +<item type="input">=ABS(-56)</item> returns 56.</paragraph> +<paragraph xml-lang="en-US" id="par_id3148752" role="paragraph" l10n="CHG" oldref="40"> +<item type="input">=ABS(12)</item> returns 12.</paragraph> +<paragraph xml-lang="en-US" id="par_id320139" role="paragraph" l10n="NEW"> +<item type="input">=ABS(0)</item> returns 0.<comment>see also SIGN</comment></paragraph> +</section> +<section id="Section62"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3150896"><bookmark_value>COUNTBLANK function</bookmark_value> +<bookmark_value>counting;empty cells</bookmark_value> +<bookmark_value>empty cells;counting</bookmark_value> +</bookmark><comment>mw added two entries</comment> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_ANZAHLLEEREZELLEN" id="bm_id3149730" localize="false"/> +<paragraph xml-lang="en-US" id="hd_id3150896" role="heading" level="2" l10n="U" +oldref="42">COUNTBLANK</paragraph> +<paragraph xml-lang="en-US" id="par_id3155260" role="paragraph" l10n="CHG" oldref="43"><ahelp hid="HID_FUNC_ANZAHLLEEREZELLEN">Returns the number of empty cells.</ahelp></paragraph> +<paragraph xml-lang="en-US" id="hd_id3145144" role="heading" level="3" l10n="U" +oldref="44">Syntax</paragraph> +<paragraph xml-lang="en-US" id="par_id3153931" role="code" l10n="U" oldref="45">COUNTBLANK(Range)</paragraph> +<paragraph xml-lang="en-US" id="par_id3149512" role="paragraph" l10n="CHG" oldref="46"> Returns the number of empty cells in the cell range <emph>Range</emph>.</paragraph> +<paragraph xml-lang="en-US" id="hd_id3146139" role="heading" level="3" l10n="U" +oldref="47">Example</paragraph> +<paragraph xml-lang="en-US" id="par_id3148586" role="paragraph" l10n="CHG" oldref="48"> +<item type="input">=COUNTBLANK(A1:B2)</item> returns 4 if cells A1, A2, B1, and B2 are all empty.</paragraph><comment>see also COUNTIF</comment> +</section> +<section id="Section61"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3153114"><bookmark_value>ACOS function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_ARCCOS" id="bm_id3155952" localize="false"/> +<paragraph xml-lang="en-US" id="hd_id3153114" role="heading" level="2" l10n="U" +oldref="50">ACOS</paragraph> +<paragraph xml-lang="en-US" id="par_id3145163" role="paragraph" l10n="CHG" oldref="51"><ahelp hid="HID_FUNC_ARCCOS">Returns the inverse trigonometric cosine of a number.</ahelp></paragraph> +<paragraph xml-lang="en-US" id="hd_id3153565" role="heading" level="3" l10n="U" +oldref="52">Syntax</paragraph> +<paragraph xml-lang="en-US" id="par_id3150020" role="code" l10n="U" oldref="53">ACOS(Number)</paragraph> +<paragraph xml-lang="en-US" id="par_id3159134" role="paragraph" l10n="CHG" oldref="54"> This function returns the inverse trigonometric cosine of <emph>Number</emph>, that is the angle (in radians) whose cosine is Number. The angle returned is between 0 and PI.</paragraph> +<paragraph xml-lang="en-US" id="par_id679647" role="paragraph" l10n="NEW">To return the angle in degrees, use the DEGREES function.</paragraph> +<paragraph xml-lang="en-US" id="hd_id3149882" role="heading" level="3" l10n="U" +oldref="55">Example</paragraph> +<paragraph xml-lang="en-US" id="par_id3150128" role="paragraph" l10n="CHG" oldref="56"> +<item type="input">=ACOS(-1)</item> returns 3.14159265358979 (PI radians)</paragraph> +<paragraph xml-lang="en-US" id="par_id8792382" role="paragraph" l10n="NEW"> +<item type="input">=DEGREES(ACOS(0.5))</item> returns 60. The cosine of 60 degrees is 0.5.</paragraph><comment>see also COS, SIN, TAN, COT, ASIN, ATAN, ATAN2, ACOT </comment> +</section> +<section id="Section60"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3145355"><bookmark_value>ACOSH function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_ARCOSHYP" id="bm_id3148386" localize="false"/> +<paragraph xml-lang="en-US" id="hd_id3145355" role="heading" level="2" l10n="U" +oldref="60">ACOSH</paragraph> +<paragraph xml-lang="en-US" id="par_id3157993" role="paragraph" l10n="U" oldref="61"><ahelp hid="HID_FUNC_ARCOSHYP">Returns the inverse hyperbolic cosine of a number.</ahelp></paragraph> +<paragraph xml-lang="en-US" id="hd_id3145295" role="heading" level="3" l10n="U" +oldref="62">Syntax</paragraph> +<paragraph xml-lang="en-US" id="par_id3151017" role="code" l10n="U" oldref="63">ACOSH(Number)</paragraph> +<paragraph xml-lang="en-US" id="par_id3149000" role="paragraph" l10n="CHG" oldref="64"> This function returns the inverse hyperbolic cosine of <emph>Number</emph>, that is the number whose hyperbolic cosine is Number. </paragraph> +<paragraph xml-lang="en-US" id="par_id6393932" role="paragraph" l10n="NEW"> Number must be greater than or equal to 1.</paragraph> +<paragraph xml-lang="en-US" id="hd_id3150566" role="heading" level="3" l10n="U" +oldref="65">Example</paragraph> +<paragraph xml-lang="en-US" id="par_id3145629" role="paragraph" l10n="CHG" oldref="66"> +<item type="input">=ACOSH(1)</item> returns 0.</paragraph> +<paragraph xml-lang="en-US" id="par_id951567" role="paragraph" l10n="NEW"> +<item type="input">=ACOSH(COSH(4))</item> returns 4.</paragraph><comment>see also ASINH, ATANH, ACOTH, COSH, SINH, TANH, COTH</comment> +</section> +<section id="Section59"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3149027"><bookmark_value>ACOT function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_ARCCOT" id="bm_id3154634" localize="false"/> +<paragraph xml-lang="en-US" id="hd_id3149027" role="heading" level="2" l10n="U" +oldref="70">ACOT</paragraph> +<paragraph xml-lang="en-US" id="par_id3155818" role="paragraph" l10n="CHG" oldref="71"><ahelp hid="HID_FUNC_ARCCOT">Returns the inverse cotangent (the arccotangent) of the given number.</ahelp></paragraph> +<paragraph xml-lang="en-US" id="hd_id3153225" role="heading" level="3" l10n="U" +oldref="72">Syntax</paragraph> +<paragraph xml-lang="en-US" id="par_id3158419" role="code" l10n="U" oldref="73">ACOT(Number)</paragraph> +<paragraph xml-lang="en-US" id="par_id3154948" role="paragraph" l10n="CHG" oldref="74"> This function returns the inverse trigonometric cotangent of <emph>Number</emph>, that is the angle (in radians) whose cotangent is Number. The angle returned is between 0 and PI.</paragraph> +<paragraph xml-lang="en-US" id="par_id5834528" role="paragraph" l10n="NEW">To return the angle in degrees, use the DEGREES function.</paragraph> +<paragraph xml-lang="en-US" id="hd_id3147538" role="heading" level="3" l10n="U" +oldref="75">Example</paragraph> +<paragraph xml-lang="en-US" id="par_id3155375" role="paragraph" l10n="CHG" oldref="76"> +<item type="input">=ACOT(1)</item> returns 0.785398163397448 (PI/4 radians).</paragraph> +<paragraph xml-lang="en-US" id="par_id8589434" role="paragraph" l10n="NEW"> +<item type="input">=DEGREES(ACOT(1))</item> returns 45. The tangent of 45 degrees is 1. </paragraph><comment>see also COS, SIN, TAN, COT, ACOS, ASIN, ATAN, ATAN2 </comment> +</section> +<section id="Section58"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3148426"><bookmark_value>ACOTH function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_ARCOTHYP" id="bm_id3149777" localize="false"/> +<paragraph xml-lang="en-US" id="hd_id3148426" role="heading" level="2" l10n="U" +oldref="80">ACOTH</paragraph> +<paragraph xml-lang="en-US" id="par_id3147478" role="paragraph" l10n="U" oldref="81"><ahelp hid="HID_FUNC_ARCOTHYP">Returns the inverse hyperbolic cotangent of the given number.</ahelp></paragraph> +<paragraph xml-lang="en-US" id="hd_id3152585" role="heading" level="3" l10n="U" +oldref="82">Syntax</paragraph> +<paragraph xml-lang="en-US" id="par_id3147172" role="code" l10n="U" oldref="83">ACOTH(Number)</paragraph> +<paragraph xml-lang="en-US" id="par_id3146155" role="paragraph" l10n="CHG" oldref="84"> This function returns the inverse hyperbolic cotangent of <emph>Number</emph>, that is the number whose hyperbolic cotangent is Number.</paragraph> +<paragraph xml-lang="en-US" id="par_id5818659" role="paragraph" l10n="NEW">An error results if Number is between -1 and 1 inclusive.</paragraph> +<paragraph xml-lang="en-US" id="hd_id3083452" role="heading" level="3" l10n="U" +oldref="85">Example</paragraph> +<paragraph xml-lang="en-US" id="par_id3150608" role="paragraph" l10n="CHG" oldref="86"> +<item type="input">=ACOTH(1.1)</item> returns inverse hyperbolic cotangent of 1.1, approximately 1.52226.</paragraph><comment>see also ACOSH, ASINH, ATANH, COSH, SINH, TANH, COTH</comment> +</section> +<section id="Section57"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3145084"><bookmark_value>ASIN function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_ARCSIN" id="bm_id3149280" localize="false"/> +<paragraph xml-lang="en-US" id="hd_id3145084" role="heading" level="2" l10n="U" +oldref="90">ASIN</paragraph> +<paragraph xml-lang="en-US" id="par_id3156296" role="paragraph" l10n="CHG" oldref="91"><ahelp hid="HID_FUNC_ARCSIN">Returns the inverse trigonometric sine of a number.</ahelp></paragraph> +<paragraph xml-lang="en-US" id="hd_id3149716" role="heading" level="3" l10n="U" +oldref="92">Syntax</paragraph> +<paragraph xml-lang="en-US" id="par_id3156305" role="code" l10n="U" oldref="93">ASIN(Number)</paragraph> +<paragraph xml-lang="en-US" id="par_id3150964" role="paragraph" l10n="CHG" oldref="94"> This function returns the inverse trigonometric sine of <emph>Number</emph>, that is the angle (in radians) whose sine is Number. The angle returned is between -PI/2 and +PI/2.</paragraph> +<paragraph xml-lang="en-US" id="par_id203863" role="paragraph" l10n="NEW">To return the angle in degrees, use the DEGREES function.</paragraph> +<paragraph xml-lang="en-US" id="hd_id3149448" role="heading" level="3" l10n="U" +oldref="95">Example</paragraph> +<paragraph xml-lang="en-US" id="par_id3156100" role="paragraph" l10n="CHG" oldref="96"> +<item type="input">=ASIN(0)</item> returns 0.</paragraph> +<paragraph xml-lang="en-US" id="par_id6853846" role="paragraph" l10n="NEW"> +<item type="input">=ASIN(1)</item> returns 1.5707963267949 (PI/2 radians). </paragraph> +<paragraph xml-lang="en-US" id="par_id8772240" role="paragraph" l10n="NEW"> +<item type="input">=DEGREES(ASIN(0.5))</item> returns 30. The sine of 30 degrees is 0.5.</paragraph><comment>see also COS, SIN, TAN, COT, ACOS, ATAN, ATAN2, ACOT </comment> +</section> +<section id="Section56"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3151266"><bookmark_value>ASINH function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_ARSINHYP" id="bm_id3145206" localize="false"/> +<paragraph xml-lang="en-US" id="hd_id3151266" role="heading" level="2" l10n="U" +oldref="100">ASINH</paragraph> +<paragraph xml-lang="en-US" id="par_id3147077" role="paragraph" l10n="U" oldref="101"><ahelp hid="HID_FUNC_ARSINHYP">Returns the inverse hyperbolic sine of a number.</ahelp></paragraph> +<paragraph xml-lang="en-US" id="hd_id3150763" role="heading" level="3" l10n="U" +oldref="102">Syntax</paragraph> +<paragraph xml-lang="en-US" id="par_id3150882" role="code" l10n="U" oldref="103">ASINH(Number)</paragraph> +<paragraph xml-lang="en-US" id="par_id3147621" role="paragraph" l10n="CHG" oldref="104"> This function returns the inverse hyperbolic sine of <emph>Number</emph>, that is the number whose hyperbolic sine is Number. </paragraph> +<paragraph xml-lang="en-US" id="hd_id3153212" role="heading" level="3" l10n="U" +oldref="105">Example</paragraph> +<paragraph xml-lang="en-US" id="par_id3156120" role="paragraph" l10n="CHG" oldref="106"> +<item type="input">=ASINH(-90)</item> returns approximately -5.1929877.</paragraph> +<paragraph xml-lang="en-US" id="par_id4808496" role="paragraph" l10n="NEW"> +<item type="input">=ASINH(SINH(4))</item> returns 4.</paragraph><comment>see also ACOSH, ATANH, ACOTH, +COSH, SINH, TANH, COTH</comment> +</section> +<section id="Section55"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3155996"><bookmark_value>ATAN function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_ARCTAN" id="bm_id3154743" localize="false"/> +<paragraph xml-lang="en-US" id="hd_id3155996" role="heading" level="2" l10n="U" +oldref="110">ATAN</paragraph> +<paragraph xml-lang="en-US" id="par_id3149985" role="paragraph" l10n="CHG" oldref="111"><ahelp hid="HID_FUNC_ARCTAN">Returns the inverse trigonometric tangent of a number.</ahelp></paragraph> +<paragraph xml-lang="en-US" id="hd_id3151294" role="heading" level="3" l10n="U" +oldref="112">Syntax</paragraph> +<paragraph xml-lang="en-US" id="par_id3150261" role="code" l10n="U" oldref="113">ATAN(Number)</paragraph> +<paragraph xml-lang="en-US" id="par_id3147267" role="paragraph" l10n="CHG" oldref="114"> This function returns the inverse trigonometric tangent of <emph>Number</emph>, that is the angle (in radians) whose tangent is Number. The angle returned is between -PI/2 and PI/2.</paragraph> +<paragraph xml-lang="en-US" id="par_id6293527" role="paragraph" l10n="NEW">To return the angle in degrees, use the DEGREES function.</paragraph> +<paragraph xml-lang="en-US" id="hd_id3154054" role="heading" level="3" l10n="U" +oldref="115">Example</paragraph> +<paragraph xml-lang="en-US" id="par_id3143229" role="paragraph" l10n="CHG" oldref="116"> +<item type="input">=ATAN(1)</item> returns 0.785398163397448 (PI/4 radians).</paragraph> +<paragraph xml-lang="en-US" id="par_id8746299" role="paragraph" l10n="NEW"> +<item type="input">=DEGREES(ATAN(1))</item> returns 45. The tangent of 45 degrees is 1.</paragraph><comment>see also COS, SIN, TAN, COT, +ACOS, ASIN, ATAN2, ACOT </comment> +</section> +<section id="Section54"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3153983"><bookmark_value>ATAN2 function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_ARCTAN2" id="bm_id3159180" localize="false"/> +<paragraph xml-lang="en-US" id="hd_id3153983" role="heading" level="2" l10n="U" +oldref="120">ATAN2</paragraph> +<paragraph xml-lang="en-US" id="par_id3154297" role="paragraph" l10n="CHG" oldref="121"><ahelp hid="HID_FUNC_ARCTAN2">Returns the inverse trigonometric tangent of the specified x and y coordinates.</ahelp></paragraph> +<paragraph xml-lang="en-US" id="hd_id3149758" role="heading" level="3" l10n="U" +oldref="122">Syntax</paragraph> +<paragraph xml-lang="en-US" id="par_id3156013" role="code" l10n="CHG" oldref="123">ATAN2(NumberX; NumberY)</paragraph> +<paragraph xml-lang="en-US" id="par_id3151168" role="paragraph" l10n="CHG" oldref="124"><emph>NumberX</emph> is the value of the x coordinate.</paragraph> +<paragraph xml-lang="en-US" id="par_id3152798" role="paragraph" l10n="CHG" oldref="125"><emph>NumberY</emph> is the value of the y coordinate.</paragraph> +<paragraph xml-lang="en-US" id="par_id5036164" role="paragraph" l10n="NEW">ATAN2 returns the inverse trigonometric tangent, that is, the angle (in radians) between the x-axis and a line from point NumberX, NumberY to the origin. The angle returned is between -PI and PI.</paragraph> +<paragraph xml-lang="en-US" id="par_id3001800" role="paragraph" l10n="NEW">To return the angle in degrees, use the DEGREES function.</paragraph> +<paragraph xml-lang="en-US" id="hd_id3145663" role="heading" level="3" l10n="U" +oldref="126">Example</paragraph> +<paragraph xml-lang="en-US" id="par_id3154692" role="paragraph" l10n="CHG" oldref="127"> +<item type="input">=ATAN2(20;20)</item> returns 0.785398163397448 (PI/4 radians).</paragraph> +<paragraph xml-lang="en-US" id="par_id1477095" role="paragraph" l10n="NEW"> +<item type="input">=DEGREES(ATAN2(12.3;12.3))</item> returns 45. The tangent of 45 degrees is 1.</paragraph><comment>see also COS, SIN, TAN, COT, +ACOS, ASIN, ATAN, ACOT </comment> +</section> +<section id="Section53"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3155398"><bookmark_value>ATANH function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_ARTANHYP" id="bm_id3154939" localize="false"/> +<paragraph xml-lang="en-US" id="hd_id3155398" role="heading" level="2" l10n="U" +oldref="130">ATANH</paragraph> +<paragraph xml-lang="en-US" id="par_id3148829" role="paragraph" l10n="U" oldref="131"><ahelp hid="HID_FUNC_ARTANHYP">Returns the inverse hyperbolic tangent of a number.</ahelp></paragraph> +<paragraph xml-lang="en-US" id="hd_id3146997" role="heading" level="3" l10n="U" +oldref="132">Syntax</paragraph> +<paragraph xml-lang="en-US" id="par_id3149912" role="code" l10n="U" oldref="133">ATANH(Number)</paragraph> +<paragraph xml-lang="en-US" id="par_id3150521" role="paragraph" l10n="CHG" oldref="134"> This function returns the inverse hyperbolic tangent of <emph>Number</emph>, that is the number whose hyperbolic tangent is Number. </paragraph> +<paragraph xml-lang="en-US" id="par_id9357280" role="paragraph" l10n="NEW"> Number must obey the condition -1 < number < 1.</paragraph> +<paragraph xml-lang="en-US" id="hd_id3148450" role="heading" level="3" l10n="U" +oldref="135">Example</paragraph> +<paragraph xml-lang="en-US" id="par_id3145419" role="paragraph" l10n="CHG" oldref="136"> +<item type="input">=ATANH(0)</item> returns 0.</paragraph><comment>see also ACOSH, ASINH, ACOTH, +COSH, SINH, TANH, COTH</comment> +</section> +<section id="Section52"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3153062"><bookmark_value>COS function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_COS" id="bm_id3158408" localize="false"/> +<paragraph xml-lang="en-US" id="hd_id3153062" role="heading" level="2" l10n="U" +oldref="149">COS</paragraph> +<paragraph xml-lang="en-US" id="par_id3148803" role="paragraph" l10n="CHG" oldref="150"><ahelp hid="HID_FUNC_COS">Returns the cosine of the given angle (in radians).</ahelp></paragraph> +<paragraph xml-lang="en-US" id="hd_id3150779" role="heading" level="3" l10n="U" +oldref="151">Syntax</paragraph> +<paragraph xml-lang="en-US" id="par_id3154213" role="code" l10n="U" oldref="152">COS(Number)</paragraph> +<paragraph xml-lang="en-US" id="par_id3154285" role="paragraph" l10n="CHG" oldref="153"> Returns the (trigonometric) cosine of <emph>Number</emph>, the angle in radians.</paragraph> +<paragraph xml-lang="en-US" id="par_id831019" role="paragraph" l10n="NEW">To return the cosine of an angle in degrees, use the RADIANS function.</paragraph> +<paragraph xml-lang="en-US" id="hd_id3153579" role="heading" level="3" l10n="U" +oldref="154">Examples</paragraph> +<paragraph xml-lang="en-US" id="par_id3147240" role="paragraph" l10n="U" oldref="155"> +<item type="input">=COS(PI()/2)</item> returns 0, the cosine of PI/2 radians.</paragraph> +<paragraph xml-lang="en-US" id="par_id3147516" role="paragraph" l10n="U" oldref="156"> +<item type="input">=COS(RADIANS(60))</item> returns 0.5, the cosine of 60 degrees.</paragraph><comment>see also SIN, TAN, COT, +ACOS, ASIN, ATAN, ATAN2, ACOT </comment> +</section> +<section id="Section51"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3154277"><bookmark_value>COSH function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_COSHYP" id="bm_id3149158" localize="false"/> +<paragraph xml-lang="en-US" id="hd_id3154277" role="heading" level="2" l10n="U" +oldref="159">COSH</paragraph> +<paragraph xml-lang="en-US" id="par_id3146946" role="paragraph" l10n="U" oldref="160"><ahelp hid="HID_FUNC_COSHYP">Returns the hyperbolic cosine of a number.</ahelp></paragraph> +<paragraph xml-lang="en-US" id="hd_id3149792" role="heading" level="3" l10n="U" +oldref="161">Syntax</paragraph> +<paragraph xml-lang="en-US" id="par_id3166440" role="code" l10n="U" oldref="162">COSH(Number)</paragraph> +<paragraph xml-lang="en-US" id="par_id3150710" role="paragraph" l10n="CHG" oldref="163">Returns the hyperbolic cosine of <emph>Number</emph>.</paragraph> +<paragraph xml-lang="en-US" id="hd_id3153234" role="heading" level="3" l10n="U" +oldref="164">Example</paragraph> +<paragraph xml-lang="en-US" id="par_id3154099" role="paragraph" l10n="CHG" oldref="165"> +<item type="input">=COSH(0)</item> returns 1, the hyperbolic cosine of 0.</paragraph><comment>see also SINH, TANH, COTH, +ACOSH, ASINH, ATANH, ACOTH, </comment> +</section> +<section id="Section50"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3152888"><bookmark_value>COT function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_COT" id="bm_id3153392" localize="false"/> +<paragraph xml-lang="en-US" id="hd_id3152888" role="heading" level="2" l10n="U" +oldref="169">COT</paragraph> +<paragraph xml-lang="en-US" id="par_id3153679" role="paragraph" l10n="CHG" oldref="170"><ahelp hid="HID_FUNC_COT">Returns the cotangent of the given angle (in radians).</ahelp></paragraph> +<paragraph xml-lang="en-US" id="hd_id3152943" role="heading" level="3" l10n="U" +oldref="171">Syntax</paragraph> +<paragraph xml-lang="en-US" id="par_id3154856" role="code" l10n="U" oldref="172">COT(Number)</paragraph> +<paragraph xml-lang="en-US" id="par_id3149969" role="paragraph" l10n="CHG" oldref="173"> Returns the (trigonometric) cotangent of <emph>Number</emph>, the angle in radians.</paragraph> +<paragraph xml-lang="en-US" id="par_id3444624" role="paragraph" l10n="NEW">To return the cotangent of an angle in degrees, use the RADIANS function.</paragraph> +<paragraph xml-lang="en-US" id="par_id6814477" role="paragraph" l10n="NEW">The cotangent of an angle is equivalent to 1 divided by the tangent of that angle.</paragraph> +<paragraph xml-lang="en-US" id="hd_id3149800" role="heading" level="3" l10n="U" +oldref="174">Examples:</paragraph> +<paragraph xml-lang="en-US" id="par_id3148616" role="paragraph" l10n="CHG" oldref="175"> +<item type="input">=COT(PI()/4)</item> returns 1, the cotangent of PI/4 radians.</paragraph> +<paragraph xml-lang="en-US" id="par_id3148986" role="paragraph" l10n="CHG" oldref="176"> +<item type="input">=COT(RADIANS(45))</item> returns 1, the cotangent of 45 degrees.</paragraph><comment>see also COS, SIN, TAN, +ACOS, ASIN, ATAN, ATAN2, ACOT </comment> +</section> +<section id="Section49"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3154337"><bookmark_value>COTH function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_COTHYP" id="bm_id3148650" localize="false"/> +<paragraph xml-lang="en-US" id="hd_id3154337" role="heading" level="2" l10n="U" +oldref="178">COTH</paragraph> +<paragraph xml-lang="en-US" id="par_id3149419" role="paragraph" l10n="U" oldref="179"><ahelp hid="HID_FUNC_COTHYP">Returns the hyperbolic cotangent of a given number (angle).</ahelp></paragraph> +<paragraph xml-lang="en-US" id="hd_id3149242" role="heading" level="3" l10n="U" +oldref="180">Syntax</paragraph> +<paragraph xml-lang="en-US" id="par_id3143280" role="code" l10n="U" oldref="181">COTH(Number)</paragraph> +<paragraph xml-lang="en-US" id="par_id3154799" role="paragraph" l10n="CHG" oldref="182"> Returns the hyperbolic cotangent of <emph>Number</emph>.</paragraph> +<paragraph xml-lang="en-US" id="hd_id3155422" role="heading" level="3" l10n="U" +oldref="183">Example</paragraph> +<paragraph xml-lang="en-US" id="par_id3144754" role="paragraph" l10n="CHG" oldref="184"> +<item type="input">=COTH(1)</item> returns the hyperbolic cotangent of 1, approximately 1.3130.</paragraph><comment>see also COSH, SINH, TANH, +ACOSH, ASINH, ATANH, ACOTH, </comment> +</section> +<section id="Section64"> +<bookmark xml-lang="en-US" branch="index" id="bm_id6110552"><bookmark_value>CSC function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_COSECANT" id="bm_id5645316" localize="false"/> +<paragraph xml-lang="en-US" id="hd_id9523234" role="heading" level="2" l10n="U" +oldref="149">CSC</paragraph> +<paragraph xml-lang="en-US" id="par_id4896433" role="paragraph" l10n="CHG" oldref="150"><ahelp hid="HID_FUNC_COSECANT">Returns the cosecant of the given angle (in radians). The cosecant of an angle is equivalent to 1 divided by the sine of that angle</ahelp></paragraph> +<paragraph xml-lang="en-US" id="hd_id3534032" role="heading" level="3" l10n="U" +oldref="151">Syntax</paragraph> +<paragraph xml-lang="en-US" id="par_id4571344" role="code" l10n="U" oldref="152">CSC(Number)</paragraph> +<paragraph xml-lang="en-US" id="par_id9859164" role="paragraph" l10n="CHG" oldref="153"> Returns the (trigonometric) cosecant of <emph>Number</emph>, the angle in radians.</paragraph> +<paragraph xml-lang="en-US" id="par_id3428494" role="paragraph" l10n="NEW">To return the cosecant of an angle in degrees, use the RADIANS function.</paragraph> +<paragraph xml-lang="en-US" id="hd_id2577161" role="heading" level="3" l10n="U" +oldref="154">Examples</paragraph> +<paragraph xml-lang="en-US" id="par_id3736803" role="paragraph" l10n="U" oldref="155"> +<item type="input">=CSC(PI()/4)</item> returns approximately 1.4142135624, the inverse of the sine of PI/4 radians.</paragraph> +<paragraph xml-lang="en-US" id="par_id6016818" role="paragraph" l10n="U" oldref="156"> +<item type="input">=CSC(RADIANS(30))</item> returns 2, the cosecant of 30 degrees.</paragraph><comment>see also SIN, TAN, COT, SEC, +ACOS, ASIN, ATAN, ATAN2, ACOT </comment> +</section> +<section id="Section66"> +<bookmark xml-lang="en-US" branch="index" id="bm_id9288877"><bookmark_value>CSCH function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_COSECANTHYP" id="bm_id9532490" localize="false"/> +<paragraph xml-lang="en-US" id="hd_id4325650" role="heading" level="2" l10n="U" +oldref="159">CSCH</paragraph> +<paragraph xml-lang="en-US" id="par_id579916" role="paragraph" l10n="U" oldref="160"><ahelp hid="HID_FUNC_COSECANTHYP">Returns the hyperbolic cosecant of a number.</ahelp></paragraph> +<paragraph xml-lang="en-US" id="hd_id5336768" role="heading" level="3" l10n="U" +oldref="161">Syntax</paragraph> +<paragraph xml-lang="en-US" id="par_id3108851" role="code" l10n="U" oldref="162">CSCH(Number)</paragraph> +<paragraph xml-lang="en-US" id="par_id1394188" role="paragraph" l10n="CHG" oldref="163">Returns the hyperbolic cosecant of <emph>Number</emph>.</paragraph> +<paragraph xml-lang="en-US" id="hd_id6037477" role="heading" level="3" l10n="U" +oldref="164">Example</paragraph> +<paragraph xml-lang="en-US" id="par_id5426085" role="paragraph" l10n="CHG" oldref="165"> +<item type="input">=CSCH(1)</item> returns approximately 0.8509181282, the hyperbolic cosecant of 1.</paragraph><comment>see also SINH, TANH, COTH, SECH,ACOSH, ASINH, ATANH, ACOTH, </comment> +</section> +<section id="Section48"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3145314"><bookmark_value>DEGREES function</bookmark_value> +<bookmark_value>converting;radians, into degrees</bookmark_value> +</bookmark><comment>mw added one entry</comment> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_DEG" id="bm_id3153946" localize="false"/> +<paragraph xml-lang="en-US" id="hd_id3145314" role="heading" level="2" l10n="U" +oldref="188">DEGREES</paragraph> +<paragraph xml-lang="en-US" id="par_id3149939" role="paragraph" l10n="U" oldref="189"><ahelp hid="HID_FUNC_DEG">Converts radians into degrees.</ahelp></paragraph> +<paragraph xml-lang="en-US" id="hd_id3150623" role="heading" level="3" l10n="U" +oldref="190">Syntax</paragraph> +<paragraph xml-lang="en-US" id="par_id3145600" role="code" l10n="CHG" oldref="191">DEGREES(Number)</paragraph> +<paragraph xml-lang="en-US" id="par_id3149484" role="paragraph" l10n="CHG" oldref="192"><emph>Number</emph> is the angle in radians to be converted to degrees.</paragraph> +<paragraph xml-lang="en-US" id="hd_id3669545" role="heading" level="3" l10n="NEW">Example</paragraph> +<paragraph xml-lang="en-US" id="par_id3459578" role="paragraph" l10n="NEW"> +<item type="input">=DEGREES(PI())</item> returns 180 degrees.</paragraph><comment>see also RADIANS</comment> +</section> +<section id="Section47"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3148698"><bookmark_value>EXP function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_EXP" id="bm_id3154625" localize="false"/> +<paragraph xml-lang="en-US" id="hd_id3148698" role="heading" level="2" l10n="U" +oldref="198">EXP</paragraph> +<paragraph xml-lang="en-US" id="par_id3150592" role="paragraph" l10n="CHG" oldref="199"><ahelp hid="HID_FUNC_EXP">Returns e raised to the power of a number.</ahelp> The constant e has a value of approximately 2.71828182845904.</paragraph> +<paragraph xml-lang="en-US" id="hd_id3150351" role="heading" level="3" l10n="U" +oldref="200">Syntax</paragraph> +<paragraph xml-lang="en-US" id="par_id3146786" role="code" l10n="U" oldref="201">EXP(Number)</paragraph> +<paragraph xml-lang="en-US" id="par_id3155608" role="paragraph" l10n="U" oldref="202"><emph>Number</emph> is the power to which e is to be raised.</paragraph> +<paragraph xml-lang="en-US" id="hd_id3154418" role="heading" level="3" l10n="U" +oldref="203">Example</paragraph> +<paragraph xml-lang="en-US" id="par_id3156340" role="paragraph" l10n="CHG" oldref="204"> +<item type="input">=EXP(1)</item> returns 2.71828182845904, the mathematical constant e to Calc's accuracy.</paragraph><comment>see also POWER, LN, </comment> +</section> +<section id="Section46"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3145781"><bookmark_value>FACT function</bookmark_value> +<bookmark_value>factorials;numbers</bookmark_value> +</bookmark><comment>mw added one entry</comment> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_FAKULTAET" id="bm_id3153886" localize="false"/> +<paragraph xml-lang="en-US" id="hd_id3145781" role="heading" level="2" l10n="U" +oldref="208">FACT</paragraph> +<paragraph xml-lang="en-US" id="par_id3151109" role="paragraph" l10n="CHG" oldref="209"><ahelp hid="HID_FUNC_FAKULTAET">Returns the factorial of a number.</ahelp></paragraph> +<paragraph xml-lang="en-US" id="hd_id3146902" role="heading" level="3" l10n="U" +oldref="210">Syntax</paragraph> +<paragraph xml-lang="en-US" id="par_id3154661" role="code" l10n="U" oldref="211">FACT(Number)</paragraph> +<paragraph xml-lang="en-US" id="par_id3152952" role="paragraph" l10n="CHG" oldref="212"> Returns Number!, the factorial of <emph>Number</emph>, calculated as 1*2*3*4* ... * Number.</paragraph> +<paragraph xml-lang="en-US" id="par_id3834650" role="paragraph" l10n="NEW">=FACT(0) returns 1 by definition. </paragraph> +<paragraph xml-lang="en-US" id="par_id8429517" role="paragraph" l10n="NEW">The factorial of a negative number returns the "invalid argument" error.</paragraph> +<paragraph xml-lang="en-US" id="hd_id3154569" role="heading" level="3" l10n="U" +oldref="213">Example</paragraph> +<paragraph xml-lang="en-US" id="par_id3154476" role="paragraph" l10n="CHG" oldref="216"> +<item type="input">=FACT(3)</item> returns 6.</paragraph> +<paragraph xml-lang="en-US" id="par_id3147525" role="paragraph" l10n="CHG" oldref="214"> +<item type="input">=FACT(0)</item> returns 1.</paragraph><comment>see also FACTDOUBLE, MULTINOMIAL, PRODUCT </comment> +</section> +<section id="Section45"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3159084"><bookmark_value>INT function</bookmark_value> +<bookmark_value>numbers;rounding down to next integer</bookmark_value> +<bookmark_value>rounding;down to next integer</bookmark_value> +</bookmark><comment>mw added two entries</comment> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_GANZZAHL" id="bm_id3151311" localize="false"/> +<paragraph xml-lang="en-US" id="hd_id3159084" role="heading" level="2" l10n="U" +oldref="218">INT</paragraph> +<paragraph xml-lang="en-US" id="par_id3158441" role="paragraph" l10n="U" oldref="219"><ahelp hid="HID_FUNC_GANZZAHL">Rounds a number down to the nearest integer.</ahelp></paragraph> +<paragraph xml-lang="en-US" id="hd_id3146132" role="heading" level="3" l10n="U" +oldref="220">Syntax</paragraph> +<paragraph xml-lang="en-US" id="par_id3156146" role="code" l10n="U" oldref="221">INT(Number)</paragraph> +<paragraph xml-lang="en-US" id="par_id3154117" role="paragraph" l10n="CHG" oldref="222">Returns <emph>Number</emph> rounded down to the nearest integer.</paragraph> +<paragraph xml-lang="en-US" id="par_id153508" role="paragraph" l10n="NEW">Negative numbers round down to the integer below.</paragraph> +<paragraph xml-lang="en-US" id="hd_id3155118" role="heading" level="3" l10n="U" +oldref="223">Example</paragraph> +<paragraph xml-lang="en-US" id="par_id3156267" role="paragraph" l10n="CHG" oldref="224"> +<item type="input">=INT(5.7)</item> returns 5.</paragraph> +<paragraph xml-lang="en-US" id="par_id3147323" role="paragraph" l10n="CHG" oldref="225"> +<item type="input">=INT(-1.3)</item> returns -2.</paragraph><comment>see also TRUNC, ROUND, ROUNDDOWN, ROUNDUP, +CEILING, FLOOR, EVEN, ODD, MROUND, </comment> +</section> +<section id="Section44"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3150938"><bookmark_value>EVEN function</bookmark_value> +<bookmark_value>numbers;rounding up/down to even integers</bookmark_value> +<bookmark_value>rounding;up/down to even integers</bookmark_value> +</bookmark><comment>mw added two entries</comment> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_GERADE" id="bm_id3150949" localize="false"/> +<paragraph xml-lang="en-US" id="hd_id3150938" role="heading" level="2" l10n="U" +oldref="227">EVEN</paragraph> +<paragraph xml-lang="en-US" id="par_id3149988" role="paragraph" l10n="CHG" oldref="228"><ahelp hid="HID_FUNC_GERADE">Rounds a positive number up to the next even integer and a negative number down to the next even integer.</ahelp></paragraph> +<paragraph xml-lang="en-US" id="hd_id3148401" role="heading" level="3" l10n="U" +oldref="229">Syntax</paragraph> +<paragraph xml-lang="en-US" id="par_id3150830" role="code" l10n="U" oldref="230">EVEN(Number)</paragraph> +<paragraph xml-lang="en-US" id="par_id3153350" role="paragraph" l10n="CHG" oldref="231"> Returns <emph>Number</emph> rounded to the next even integer up, away from zero. </paragraph> +<paragraph xml-lang="en-US" id="hd_id3155508" role="heading" level="3" l10n="U" +oldref="232">Examples</paragraph> +<paragraph xml-lang="en-US" id="par_id3154361" role="paragraph" l10n="CHG" oldref="233"> +<item type="input">=EVEN(2.3)</item> returns 4.</paragraph> +<paragraph xml-lang="en-US" id="par_id8477736" role="paragraph" l10n="NEW"> +<item type="input">=EVEN(2)</item> returns 2.</paragraph> +<paragraph xml-lang="en-US" id="par_id159611" role="paragraph" l10n="NEW"> +<item type="input">=EVEN(0)</item> returns 0.</paragraph> +<paragraph xml-lang="en-US" id="par_id6097598" role="paragraph" l10n="NEW"> +<item type="input">=EVEN(-0.5)</item> returns -2.</paragraph><comment>see also CEILING, FLOOR, ODD, MROUND, +INT, TRUNC, ROUND, ROUNDDOWN, ROUNDUP</comment> +</section> +<section id="Section43"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3147356"><bookmark_value>GCD function</bookmark_value> +<bookmark_value>greatest common divisor</bookmark_value> +</bookmark><comment>mw added one entry</comment> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_GGT" id="bm_id3149737" localize="false"/> +<paragraph xml-lang="en-US" id="hd_id3147356" role="heading" level="2" l10n="U" +oldref="237">GCD</paragraph> +<paragraph xml-lang="en-US" id="par_id3152465" role="paragraph" l10n="U" oldref="238"><ahelp hid="HID_FUNC_GGT">Returns the greatest common divisor of two or more integers.</ahelp></paragraph> +<paragraph xml-lang="en-US" id="par_id2769249" role="paragraph" l10n="NEW">The greatest common divisor is the positive largest integer which will divide, without remainder, each of the given integers.</paragraph> +<paragraph xml-lang="en-US" id="hd_id3150643" role="heading" level="3" l10n="U" +oldref="239">Syntax</paragraph> +<paragraph xml-lang="en-US" id="par_id3154524" role="code" l10n="U" oldref="240">GCD(Integer1; Integer2; ...; Integer30)</paragraph> +<paragraph xml-lang="en-US" id="par_id3149340" role="paragraph" l10n="U" oldref="241"><emph>Integer1 To 30</emph> are up to 30 integers whose greatest common divisor is to be calculated.</paragraph> +<paragraph xml-lang="en-US" id="hd_id3147317" role="heading" level="3" l10n="U" +oldref="242">Example</paragraph> +<paragraph xml-lang="en-US" id="par_id3151285" role="paragraph" l10n="CHG" oldref="243"> +<item type="input">=GCD(16;32;24) </item>gives the result 8, because 8 is the largest number that can divide 16, 24 and 32 without a remainder.</paragraph> +<paragraph xml-lang="en-US" id="par_id1604663" role="paragraph" l10n="NEW"> +<item type="input">=GCD(B1:B3)</item> where cells B1, B2, B3 contain <item type="input">9</item>, <item type="input">12</item>, <item type="input">9</item> gives 3.</paragraph> +</section> +<section id="Section42"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3151221"><bookmark_value>GCD_ADD function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_GCD" id="bm_id3147578" localize="false"/> +<paragraph xml-lang="en-US" id="hd_id3151221" role="heading" level="2" l10n="E" +oldref="677">GCD_ADD</paragraph> +<paragraph xml-lang="en-US" id="par_id3153257" role="paragraph" l10n="U" oldref="678"><ahelp hid="HID_AAI_FUNC_GCD"> The result is the greatest common divisor of a list of numbers.</ahelp></paragraph> +<embed href="text/scalc/01/04060102.xhp#ADD_note"/> +<paragraph xml-lang="en-US" id="hd_id3147548" role="heading" level="3" l10n="U" +oldref="679">Syntax</paragraph> +<paragraph xml-lang="en-US" id="par_id3156205" role="code" l10n="U" oldref="680">GCD_ADD(Number(s))</paragraph> +<paragraph xml-lang="en-US" id="par_id3145150" role="paragraph" l10n="U" oldref="681"><emph>Number(s)</emph> is a list of up to 30 numbers.</paragraph> +<paragraph xml-lang="en-US" id="hd_id3150239" role="heading" level="3" l10n="U" +oldref="682">Example</paragraph> +<paragraph xml-lang="en-US" id="par_id3159192" role="paragraph" l10n="U" oldref="683"> +<item type="input">=GCD_ADD(5;15;25)</item> returns 5.</paragraph> +</section> +<section id="Section41"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3156048"><bookmark_value>ISEVEN function</bookmark_value> +<bookmark_value>even integers</bookmark_value> +</bookmark><comment>mw added one entry</comment> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_ISTGERADE" id="bm_id3149430" localize="false"/> +<paragraph xml-lang="en-US" id="hd_id3156048" role="heading" level="2" l10n="U" +oldref="245">ISEVEN<comment>link from Information cat</comment></paragraph> +<paragraph xml-lang="en-US" id="par_id3149169" role="paragraph" l10n="U" oldref="246"><ahelp hid="HID_FUNC_ISTGERADE">Returns TRUE if the value is an even integer, or FALSE if the value is odd.</ahelp></paragraph> +<paragraph xml-lang="en-US" id="hd_id3146928" role="heading" level="3" l10n="U" +oldref="247">Syntax</paragraph> +<paragraph xml-lang="en-US" id="par_id3151203" role="code" l10n="U" oldref="248">ISEVEN(Value)</paragraph> +<paragraph xml-lang="en-US" id="par_id3150491" role="paragraph" l10n="U" oldref="249"><emph>Value</emph> is the value to be checked.</paragraph> +<paragraph xml-lang="en-US" id="par_id3445844" role="paragraph" l10n="NEW">If Value is not an integer any digits after the decimal point are ignored. The sign of Value is also ignored.</paragraph> +<paragraph xml-lang="en-US" id="hd_id3154136" role="heading" level="3" l10n="U" +oldref="250">Example</paragraph> +<paragraph xml-lang="en-US" id="par_id3163813" role="paragraph" l10n="CHG" oldref="251"> +<item type="input">=ISEVEN(48)</item> returns TRUE</paragraph> +<paragraph xml-lang="en-US" id="par_id8378856" role="paragraph" l10n="NEW"> +<item type="input">=ISEVEN(33)</item> returns FALSE</paragraph> +<paragraph xml-lang="en-US" id="par_id7154759" role="paragraph" l10n="NEW"> +<item type="input">=ISEVEN(0)</item> returns TRUE</paragraph> +<paragraph xml-lang="en-US" id="par_id1912289" role="paragraph" l10n="NEW"> +<item type="input">=ISEVEN(-2.1)</item> returns TRUE</paragraph> +<paragraph xml-lang="en-US" id="par_id5627307" role="paragraph" l10n="NEW"> +<item type="input">=ISEVEN(3.999)</item> returns FALSE</paragraph><comment>see also ISODD </comment> +</section> +<section id="Section40"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3156034"><bookmark_value>ISODD function</bookmark_value> +<bookmark_value>odd integers</bookmark_value> +</bookmark><comment>mw added one entry</comment> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_ISTUNGERADE" id="bm_id3149298" localize="false"/> +<paragraph xml-lang="en-US" id="hd_id3156034" role="heading" level="2" l10n="U" +oldref="255">ISODD<comment>link from Information cat</comment></paragraph> +<paragraph xml-lang="en-US" id="par_id3155910" role="paragraph" l10n="U" oldref="256"><ahelp hid="HID_FUNC_ISTUNGERADE">Returns TRUE if the value is odd, or FALSE if the number is even.</ahelp></paragraph> +<paragraph xml-lang="en-US" id="hd_id3151006" role="heading" level="3" l10n="U" +oldref="257">Syntax</paragraph> +<paragraph xml-lang="en-US" id="par_id3151375" role="code" l10n="U" oldref="258">ISODD(value)</paragraph> +<paragraph xml-lang="en-US" id="par_id3155139" role="paragraph" l10n="U" oldref="259"><emph>Value</emph> is the value to be checked.</paragraph> +<paragraph xml-lang="en-US" id="par_id9027680" role="paragraph" l10n="NEW">If Value is not an integer any digits after the decimal point are ignored. The sign of Value is also ignored.</paragraph> +<paragraph xml-lang="en-US" id="hd_id3163723" role="heading" level="3" l10n="U" +oldref="260">Example</paragraph> +<paragraph xml-lang="en-US" id="par_id3155345" role="paragraph" l10n="CHG" oldref="261"> +<item type="input">=ISODD(33)</item> returns TRUE</paragraph> +<paragraph xml-lang="en-US" id="par_id9392986" role="paragraph" l10n="NEW"> +<item type="input">=ISODD(48)</item> returns FALSE</paragraph> +<paragraph xml-lang="en-US" id="par_id5971251" role="paragraph" l10n="NEW"> +<item type="input">=ISODD(3.999)</item> returns TRUE</paragraph> +<paragraph xml-lang="en-US" id="par_id4136478" role="paragraph" l10n="NEW"> +<item type="input">=ISODD(-3.1)</item> returns TRUE</paragraph><comment>see also ISEVEN</comment> +</section> +<section id="Section39"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3145213"><bookmark_value>LCM function</bookmark_value> +<bookmark_value>least common multiples</bookmark_value> +<bookmark_value>lowest common multiples</bookmark_value> +</bookmark><comment>mw added two entries</comment> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_KGV" id="bm_id3145225" localize="false"/> +<paragraph xml-lang="en-US" id="hd_id3145213" role="heading" level="2" l10n="U" +oldref="265">LCM</paragraph> +<paragraph xml-lang="en-US" id="par_id3146814" role="paragraph" l10n="U" oldref="266"><ahelp hid="HID_FUNC_KGV">Returns the least common multiple of one or more integers.</ahelp></paragraph> +<paragraph xml-lang="en-US" id="hd_id3148632" role="heading" level="3" l10n="U" +oldref="267">Syntax</paragraph> +<paragraph xml-lang="en-US" id="par_id3147279" role="code" l10n="U" oldref="268">LCM(Integer1; Integer2; ...; Integer30)</paragraph> +<paragraph xml-lang="en-US" id="par_id3156348" role="paragraph" l10n="U" oldref="269"><emph>Integer1 to 30</emph> are up to 30 integers whose lowest common multiple is to be calculated.</paragraph> +<paragraph xml-lang="en-US" id="hd_id3156431" role="heading" level="3" l10n="U" +oldref="270">Example</paragraph> +<paragraph xml-lang="en-US" id="par_id3154914" role="paragraph" l10n="U" oldref="271">If you enter the numbers <item type="input">512</item>;<item type="input">1024</item> and <item type="input">2000</item> in the Integer 1;2 and 3 text boxes, 128000 will be returned as the result.</paragraph> +</section> +<section id="Section38"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3154230"><bookmark_value>LCM_ADD function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_LCM" id="bm_id3147222" localize="false"/> +<paragraph xml-lang="en-US" id="hd_id3154230" role="heading" level="2" l10n="U" +oldref="684">LCM_ADD</paragraph> +<paragraph xml-lang="en-US" id="par_id3149036" role="paragraph" l10n="U" oldref="685"><ahelp hid="HID_AAI_FUNC_LCM"> The result is the lowest common multiple of a list of numbers.</ahelp></paragraph> +<embed href="text/scalc/01/04060102.xhp#ADD_note"/> +<paragraph xml-lang="en-US" id="hd_id3153132" role="heading" level="3" l10n="U" +oldref="686">Syntax</paragraph> +<paragraph xml-lang="en-US" id="par_id3154395" role="code" l10n="U" oldref="687">LCM_ADD(Number(s))</paragraph> +<paragraph xml-lang="en-US" id="par_id3147377" role="paragraph" l10n="U" oldref="688"><emph>Number(s)</emph> is a list of up to 30 numbers.</paragraph> +<paragraph xml-lang="en-US" id="hd_id3145122" role="heading" level="3" l10n="U" +oldref="689">Example</paragraph> +<paragraph xml-lang="en-US" id="par_id3145135" role="paragraph" l10n="U" oldref="690"> +<item type="input">=LCM_ADD(5;15;25)</item> returns 75.</paragraph> +</section> +<section id="Section37"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3155802"><bookmark_value>COMBIN function</bookmark_value> +<bookmark_value>number of combinations</bookmark_value> +</bookmark><comment>mw added one entry</comment> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_KOMBINATIONEN" id="bm_id3155077" localize="false"/> +<paragraph xml-lang="en-US" id="hd_id3155802" role="heading" level="2" l10n="U" +oldref="273">COMBIN<comment>should be statistical-->add a link there</comment></paragraph> +<paragraph xml-lang="en-US" id="par_id3156172" role="paragraph" l10n="CHG" oldref="274"><ahelp hid="HID_FUNC_KOMBINATIONEN">Returns the number of combinations for elements without repetition.</ahelp></paragraph> +<paragraph xml-lang="en-US" id="hd_id3156193" role="heading" level="3" l10n="U" +oldref="275">Syntax</paragraph> +<paragraph xml-lang="en-US" id="par_id3150223" role="code" l10n="CHG" oldref="276">COMBIN(Count1; Count2)</paragraph> +<paragraph xml-lang="en-US" id="par_id3150313" role="paragraph" l10n="CHG" oldref="277"><emph>Count1</emph> is the number of items in the set.</paragraph> +<paragraph xml-lang="en-US" id="par_id3153830" role="paragraph" l10n="CHG" oldref="278"><emph>Count2</emph> is the number of items to choose from the set.</paragraph> +<paragraph xml-lang="en-US" id="par_id6807458" role="paragraph" l10n="CHG">COMBIN returns the number of ordered ways to choose these items. For example if there are 3 items A, B and C in a set, you can choose 2 items in 3 different ways, namely AB, AC and BC.</paragraph> +<paragraph xml-lang="en-US" id="par_id7414471" role="paragraph" l10n="NEW">COMBIN implements the formula: Count1!/(Count2!*(Count1-Count2)!)</paragraph> +<paragraph xml-lang="en-US" id="hd_id3153171" role="heading" level="3" l10n="U" +oldref="279">Example</paragraph> +<paragraph xml-lang="en-US" id="par_id3153517" role="paragraph" l10n="CHG" oldref="280"> +<item type="input">=COMBIN(3;2)</item> returns 3.</paragraph><comment>see also COMBINA </comment> +</section> +<section id="Section36"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3150284"><bookmark_value>COMBINA function</bookmark_value> +<bookmark_value>number of combinations with repetitions</bookmark_value> +</bookmark><comment>mw added one entry</comment> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_KOMBINATIONEN2" id="bm_id3150295" localize="false"/> +<paragraph xml-lang="en-US" id="hd_id3150284" role="heading" level="2" l10n="U" +oldref="282">COMBINA<comment>should be statistical-->add a link there</comment></paragraph> +<paragraph xml-lang="en-US" id="par_id3157894" role="paragraph" l10n="CHG" oldref="283"><ahelp hid="HID_FUNC_KOMBINATIONEN2">Returns the number of combinations of a subset of items including repetitions.</ahelp></paragraph> +<paragraph xml-lang="en-US" id="hd_id3145752" role="heading" level="3" l10n="U" +oldref="284">Syntax</paragraph> +<paragraph xml-lang="en-US" id="par_id3145765" role="code" l10n="CHG" oldref="285">COMBINA(Count1; Count2)</paragraph> +<paragraph xml-lang="en-US" id="par_id3153372" role="paragraph" l10n="CHG" oldref="286"><emph>Count1</emph> is the number of items in the set.</paragraph> +<paragraph xml-lang="en-US" id="par_id3155544" role="paragraph" l10n="CHG" oldref="287"><emph>Count2</emph> is the number of items to choose from the set.</paragraph> +<paragraph xml-lang="en-US" id="par_id1997131" role="paragraph" l10n="CHG">COMBINA returns the number of unique ways to choose these items, where the order of choosing is irrelevant, and repetition of items is allowed. For example if there are 3 items A, B and C in a set, you can choose 2 items in 6 different ways, namely AA, AB, AC, BB, BC and CC.</paragraph> +<paragraph xml-lang="en-US" id="par_id2052064" role="paragraph" l10n="CHG">COMBINA implements the formula: (Count1+Count2-1)! / (Count2!(Count1-1)!)<comment>i88052</comment></paragraph> +<paragraph xml-lang="en-US" id="hd_id3154584" role="heading" level="3" l10n="U" +oldref="288">Example</paragraph> +<paragraph xml-lang="en-US" id="par_id3152904" role="paragraph" l10n="CHG" oldref="289"> +<item type="input">=COMBINA(3;2)</item> returns 6.</paragraph><comment>see also COMBIN</comment> +</section> +<section id="Section35"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3156086"><bookmark_value>TRUNC function</bookmark_value> +<bookmark_value>decimal places;cutting off</bookmark_value> +</bookmark><comment>mw added one entry</comment> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_KUERZEN" id="bm_id3157849" localize="false"/> +<paragraph xml-lang="en-US" id="hd_id3156086" role="heading" level="2" l10n="U" +oldref="291">TRUNC</paragraph> +<paragraph xml-lang="en-US" id="par_id3157866" role="paragraph" l10n="CHG" oldref="292"><ahelp hid="HID_FUNC_KUERZEN">Truncates a number by removing decimal places.</ahelp></paragraph> +<paragraph xml-lang="en-US" id="hd_id3148499" role="heading" level="3" l10n="U" +oldref="293">Syntax</paragraph> +<paragraph xml-lang="en-US" id="par_id3148511" role="code" l10n="U" oldref="294">TRUNC(Number; Count)</paragraph> +<paragraph xml-lang="en-US" id="par_id3150796" role="paragraph" l10n="CHG" oldref="295">Returns <emph>Number</emph> with at most <emph>Count</emph> decimal places. Excess decimal places are simply removed, irrespective of sign.</paragraph> +<paragraph xml-lang="en-US" id="par_id3150816" role="paragraph" l10n="CHG" oldref="296"> +<item type="literal">TRUNC(Number; 0)</item> behaves as <item type="literal">INT(Number)</item> for positive numbers, but effectively rounds towards zero for negative numbers.</paragraph> +<paragraph xml-lang="en-US" id="par_id3148548" role="warning" l10n="CHG" oldref="557">The <emph>visible</emph> decimal places of the result are specified in <switchinline select="sys"><caseinline select="MAC">%PRODUCTNAME - Preferences</caseinline><defaultinline>Tools - Options</defaultinline></switchinline> - <link href="text/shared/optionen/01060500.xhp">%PRODUCTNAME Calc - Calculate</link>.</paragraph> +<paragraph xml-lang="en-US" id="hd_id3152555" role="heading" level="3" l10n="U" +oldref="297">Example</paragraph> +<paragraph xml-lang="en-US" id="par_id3152569" role="paragraph" l10n="CHG" oldref="298"> +<item type="input">=TRUNC(1.239;2)</item> returns 1.23. The 9 is lost.</paragraph> +<paragraph xml-lang="en-US" id="par_id7050080" role="paragraph" l10n="NEW"> +<item type="input">=TRUNC(-1.234999;3)</item> returns -1.234. All the 9s are lost.</paragraph><comment>see also INT, ROUND, ROUNDDOWN, ROUNDUP, +CEILING, FLOOR, EVEN, ODD, MROUND</comment> +</section> +<section id="Section34"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3153601"><bookmark_value>LN function</bookmark_value> +<bookmark_value>natural logarithm</bookmark_value> +</bookmark><comment>mw added one entry</comment> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_LN" id="bm_id3153613" localize="false"/> +<paragraph xml-lang="en-US" id="hd_id3153601" role="heading" level="2" l10n="U" +oldref="301">LN</paragraph> +<paragraph xml-lang="en-US" id="par_id3154974" role="paragraph" l10n="CHG" oldref="302"><ahelp hid="HID_FUNC_LN">Returns the natural logarithm based on the constant e of a number.</ahelp> The constant e has a value of approximately 2.71828182845904.</paragraph> +<paragraph xml-lang="en-US" id="hd_id3154993" role="heading" level="3" l10n="U" +oldref="303">Syntax</paragraph> +<paragraph xml-lang="en-US" id="par_id3155284" role="code" l10n="U" oldref="304">LN(Number)</paragraph> +<paragraph xml-lang="en-US" id="par_id3155297" role="paragraph" l10n="U" oldref="305"><emph>Number</emph> is the value whose natural logarithm is to be calculated.</paragraph> +<paragraph xml-lang="en-US" id="hd_id3153852" role="heading" level="3" l10n="U" +oldref="306">Example</paragraph> +<paragraph xml-lang="en-US" id="par_id3153866" role="paragraph" l10n="CHG" oldref="307"> +<item type="input">=LN(3)</item> returns the natural logarithm of 3 (approximately 1.0986).</paragraph> +<paragraph xml-lang="en-US" id="par_id5747245" role="paragraph" l10n="NEW"> +<item type="input">=LN(EXP(321))</item> returns 321.</paragraph><comment>see also LOG, LOG10, EXP, </comment> +</section> +<section id="Section33"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3109813"><bookmark_value>LOG function</bookmark_value> +<bookmark_value>logarithms</bookmark_value> +</bookmark><comment>mw added one entry</comment> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_LOG" id="bm_id3109824" localize="false"/> +<paragraph xml-lang="en-US" id="hd_id3109813" role="heading" level="2" l10n="U" +oldref="311">LOG</paragraph> +<paragraph xml-lang="en-US" id="par_id3109841" role="paragraph" l10n="U" oldref="312"><ahelp hid="HID_FUNC_LOG">Returns the logarithm of a number to the specified base.</ahelp></paragraph> +<paragraph xml-lang="en-US" id="hd_id3144719" role="heading" level="3" l10n="U" +oldref="313">Syntax</paragraph> +<paragraph xml-lang="en-US" id="par_id3144732" role="code" l10n="U" oldref="314">LOG(Number; Base)</paragraph> +<paragraph xml-lang="en-US" id="par_id3144746" role="paragraph" l10n="U" oldref="315"><emph>Number</emph> is the value whose logarithm is to be calculated.</paragraph> +<paragraph xml-lang="en-US" id="par_id3152840" role="paragraph" l10n="CHG" oldref="316"><emph>Base</emph> (optional) is the base for the logarithm calculation. If omitted, Base 10 is assumed.</paragraph> +<paragraph xml-lang="en-US" id="hd_id3152860" role="heading" level="3" l10n="U" +oldref="317">Example</paragraph> +<paragraph xml-lang="en-US" id="par_id3154429" role="paragraph" l10n="CHG" oldref="318"> +<item type="input">=LOG(10;3)</item> returns the logarithm to base 3 of 10 (approximately 2.0959).</paragraph> +<paragraph xml-lang="en-US" id="par_id5577562" role="paragraph" l10n="NEW"> +<item type="input">=LOG(7^4;7)</item> returns 4.</paragraph><comment>see also LOG10, LN, POWER, </comment> +</section> +<section id="Section32"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3154187"><bookmark_value>LOG10 function</bookmark_value> +<bookmark_value>base-10 logarithm</bookmark_value> +</bookmark><comment>mw added one entry</comment> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_LOG10" id="bm_id3155460" localize="false"/> +<paragraph xml-lang="en-US" id="hd_id3154187" role="heading" level="2" l10n="U" +oldref="322">LOG10</paragraph> +<paragraph xml-lang="en-US" id="par_id3155476" role="paragraph" l10n="U" oldref="323"><ahelp hid="HID_FUNC_LOG10">Returns the base-10 logarithm of a number.</ahelp></paragraph> +<paragraph xml-lang="en-US" id="hd_id3155494" role="heading" level="3" l10n="U" +oldref="324">Syntax</paragraph> +<paragraph xml-lang="en-US" id="par_id3159294" role="code" l10n="U" oldref="325">LOG10(Number)</paragraph> +<paragraph xml-lang="en-US" id="par_id3159308" role="paragraph" l10n="CHG" oldref="326">Returns the logarithm to base 10 of <emph>Number</emph>.</paragraph> +<paragraph xml-lang="en-US" id="hd_id3159328" role="heading" level="3" l10n="U" +oldref="327">Example</paragraph> +<paragraph xml-lang="en-US" id="par_id3157916" role="paragraph" l10n="CHG" oldref="328"> +<item type="input">=LOG10(5)</item> returns the base-10 logarithm of 5 (approximately 0.69897).</paragraph><comment>see also LOG, LN, POWER </comment> +</section> +<section id="Section31"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3152518"><bookmark_value>CEILING function</bookmark_value> +<bookmark_value>rounding;up to multiples of significance</bookmark_value> +</bookmark><comment>mw added one entry</comment> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_OBERGRENZE" id="bm_id3152530" localize="false"/> +<paragraph xml-lang="en-US" id="hd_id3152518" role="heading" level="2" l10n="U" +oldref="332">CEILING</paragraph> +<paragraph xml-lang="en-US" id="par_id3153422" role="paragraph" l10n="CHG" oldref="558"><ahelp hid="HID_FUNC_OBERGRENZE">Rounds a number up to the nearest multiple of Significance.</ahelp></paragraph> +<paragraph xml-lang="en-US" id="hd_id3153440" role="heading" level="3" l10n="U" +oldref="334">Syntax</paragraph> +<paragraph xml-lang="en-US" id="par_id3153454" role="code" l10n="CHG" oldref="335">CEILING(Number; Significance; Mode)</paragraph> +<paragraph xml-lang="en-US" id="par_id3153467" role="paragraph" l10n="U" oldref="336"><emph>Number</emph> is the number that is to be rounded up.</paragraph> +<paragraph xml-lang="en-US" id="par_id3155000" role="paragraph" l10n="CHG" oldref="337"><emph>Significance</emph> is the number to whose multiple the value is to be rounded up.</paragraph> +<paragraph xml-lang="en-US" id="par_id3155020" role="paragraph" l10n="CHG" oldref="559"><emph>Mode</emph> is an optional value. If the Mode value is given and not equal to zero, and if Number and Significance are negative, then rounding is done based on the absolute value of Number. This parameter is ignored when exporting to MS Excel as Excel does not know any third parameter.</paragraph> +<paragraph xml-lang="en-US" id="par_id3163792" role="warning" l10n="CHG" oldref="629">If both parameters Number and Significance are negative and the Mode value is equal to zero or is not given, the results in $[officename] and Excel will differ after the import has been completed. If you export the spreadsheet to Excel, use Mode=1 to see the same results in Excel as in Calc.</paragraph> +<paragraph xml-lang="en-US" id="hd_id3145697" role="heading" level="3" l10n="U" +oldref="338">Example</paragraph> +<paragraph xml-lang="en-US" id="par_id3145710" role="paragraph" l10n="CHG" oldref="339"> +<item type="input">=CEILING(-11;-2)</item> returns -10</paragraph> +<paragraph xml-lang="en-US" id="par_id3145725" role="paragraph" l10n="CHG" oldref="340"> +<item type="input">=CEILING(-11;-2;0)</item> returns -10</paragraph> +<paragraph xml-lang="en-US" id="par_id3145740" role="paragraph" l10n="CHG" oldref="341"> +<item type="input">=CEILING(-11;-2;1)</item> returns -12</paragraph><comment>see also FLOOR, EVEN, ODD, MROUND, +INT, TRUNC, ROUND, ROUNDDOWN, ROUNDUP</comment> +</section> +<section id="Section30"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3157762"><bookmark_value>PI function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_PI" id="bm_id3157774" localize="false"/> +<paragraph xml-lang="en-US" id="hd_id3157762" role="heading" level="2" l10n="U" +oldref="343">PI</paragraph> +<paragraph xml-lang="en-US" id="par_id3157790" role="paragraph" l10n="CHG" oldref="344"><ahelp hid="HID_FUNC_PI">Returns 3.14159265358979, the value of the mathematical constant PI to 14 decimal places.</ahelp></paragraph> +<paragraph xml-lang="en-US" id="hd_id3157809" role="heading" level="3" l10n="U" +oldref="345">Syntax</paragraph> +<paragraph xml-lang="en-US" id="par_id3157822" role="code" l10n="U" oldref="346">PI()</paragraph> +<paragraph xml-lang="en-US" id="hd_id3157836" role="heading" level="3" l10n="U" +oldref="347">Example</paragraph> +<paragraph xml-lang="en-US" id="par_id3152370" role="paragraph" l10n="CHG" oldref="348"> +<item type="input">=PI()</item> returns 3.14159265358979.</paragraph> +</section> +<section id="Section29"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3152418"><bookmark_value>MULTINOMIAL function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_MULTINOMIAL" id="bm_id3152429" localize="false"/> +<paragraph xml-lang="en-US" id="hd_id3152418" role="heading" level="2" l10n="U" +oldref="635">MULTINOMIAL</paragraph> +<paragraph xml-lang="en-US" id="par_id3152454" role="paragraph" l10n="U" oldref="636"><ahelp hid="HID_AAI_FUNC_MULTINOMIAL"> Returns the factorial of the sum of the arguments divided by the product of the factorials of the arguments.</ahelp></paragraph> +<paragraph xml-lang="en-US" id="hd_id3155646" role="heading" level="3" l10n="U" +oldref="637">Syntax</paragraph> +<paragraph xml-lang="en-US" id="par_id3155660" role="code" l10n="U" oldref="638">MULTINOMIAL(Number(s))</paragraph> +<paragraph xml-lang="en-US" id="par_id3155673" role="paragraph" l10n="U" oldref="639"><emph>Number(s)</emph> is a list of up to 30 numbers.</paragraph> +<paragraph xml-lang="en-US" id="hd_id3155687" role="heading" level="3" l10n="U" +oldref="640">Example</paragraph> +<paragraph xml-lang="en-US" id="par_id3155701" role="paragraph" l10n="U" oldref="641"> +<item type="input">=MULTINOMIAL(F11:H11)</item> returns 1260, if F11 to H11 contain the values <item type="input">2</item>, <item type="input">3</item> and <item type="input">4</item>. This corresponds to the formula =(2+3+4)! / (2!*3!*4!)</paragraph> +</section> +<section id="Section28"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3155717"><bookmark_value>POWER function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_POTENZ" id="bm_id3155728" localize="false"/> +<paragraph xml-lang="en-US" id="hd_id3155717" role="heading" level="2" l10n="U" +oldref="350">POWER</paragraph> +<paragraph xml-lang="en-US" id="par_id3159495" role="paragraph" l10n="CHG" oldref="351"><ahelp hid="HID_FUNC_POTENZ">Returns a number raised to another number.</ahelp></paragraph> +<paragraph xml-lang="en-US" id="hd_id3159513" role="heading" level="3" l10n="U" +oldref="352">Syntax</paragraph> +<paragraph xml-lang="en-US" id="par_id3159526" role="code" l10n="U" oldref="353">POWER(Base; Exponent)</paragraph> +<paragraph xml-lang="en-US" id="par_id3159540" role="paragraph" l10n="CHG" oldref="354">Returns <emph>Base</emph> raised to the power of <emph>Exponent</emph>.</paragraph> +<paragraph xml-lang="en-US" id="par_id5081637" role="paragraph" l10n="NEW">The same result may be achieved by using the exponentiation operator ^:</paragraph> +<paragraph xml-lang="en-US" id="par_id9759514" role="code" l10n="NEW"> +<item type="literal">Base^Exponent</item> +</paragraph> +<paragraph xml-lang="en-US" id="hd_id3159580" role="heading" level="3" l10n="U" +oldref="356">Example</paragraph> +<paragraph xml-lang="en-US" id="par_id3159594" role="paragraph" l10n="CHG" oldref="357"> +<item type="input">=POWER(4;3)</item> returns 64, which is 4 to the power of 3.</paragraph> +<paragraph xml-lang="en-US" id="par_id1614429" role="paragraph" l10n="NEW">=4^3 also returns 4 to the power of 3.</paragraph><comment>see also EXP, LOG, SQRT</comment> +</section> +<section id="Section27"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3152651"><bookmark_value>SERIESSUM function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_SERIESSUM" id="bm_id3152662" localize="false"/> +<paragraph xml-lang="en-US" id="hd_id3152651" role="heading" level="2" l10n="U" +oldref="642">SERIESSUM</paragraph> +<paragraph xml-lang="en-US" id="par_id3152688" role="paragraph" l10n="CHG" oldref="643"><ahelp hid=".">Sums the first terms of a power series.</ahelp></paragraph> +<paragraph xml-lang="en-US" id="par_id3152708" role="paragraph" l10n="U" oldref="644">SERIESSUM(x;n;m;coefficients) = coefficient_1*x^n + coefficient_2*x^(n+m) + coefficient_3*x^(n+2m) +...+ coefficient_i*x^(n+(i-1)m)</paragraph> +<paragraph xml-lang="en-US" id="hd_id3152724" role="heading" level="3" l10n="U" +oldref="645">Syntax</paragraph> +<paragraph xml-lang="en-US" id="par_idN11BD9" role="code" l10n="NEW">SERIESSUM(X; N; M; Coefficients)</paragraph> +<paragraph xml-lang="en-US" id="par_id3152737" role="paragraph" l10n="CHG" oldref="646"><emph>X</emph> is the input value for the power series.</paragraph> +<paragraph xml-lang="en-US" id="par_id3144344" role="paragraph" l10n="CHG" oldref="647"><emph>N</emph> is the initial power</paragraph> +<paragraph xml-lang="en-US" id="par_id3144357" role="paragraph" l10n="CHG" oldref="648"><emph>M</emph> is the increment to increase N</paragraph> +<paragraph xml-lang="en-US" id="par_id3144370" role="paragraph" l10n="U" oldref="649"><emph>Coefficients</emph> is a series of coefficients. For each coefficient the series sum is extended by one section.</paragraph> +</section> +<section id="Section26"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3144386"><bookmark_value>PRODUCT function</bookmark_value> +<bookmark_value>numbers;multiplying</bookmark_value> +<bookmark_value>multiplying;numbers</bookmark_value> +</bookmark><comment>mw added two entries</comment> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_PRODUKT" id="bm_id3144397" localize="false"/> +<paragraph xml-lang="en-US" id="hd_id3144386" role="heading" level="2" l10n="U" +oldref="361">PRODUCT</paragraph> +<paragraph xml-lang="en-US" id="par_id3144414" role="paragraph" l10n="U" oldref="362"><ahelp hid="HID_FUNC_PRODUKT">Multiplies all the numbers given as arguments and returns the product.</ahelp></paragraph> +<paragraph xml-lang="en-US" id="hd_id3144433" role="heading" level="3" l10n="U" +oldref="363">Syntax</paragraph> +<paragraph xml-lang="en-US" id="par_id3144446" role="code" l10n="U" oldref="364">PRODUCT(Number1; Number2; ...; Number30)</paragraph> +<paragraph xml-lang="en-US" id="par_id3144460" role="paragraph" l10n="U" oldref="365"><emph>Number1 to 30</emph> are up to 30 arguments whose product is to be calculated.</paragraph> +<paragraph xml-lang="en-US" id="par_id1589098" role="paragraph" l10n="NEW">PRODUCT returns number1 * number2 * number3 * ...</paragraph> +<paragraph xml-lang="en-US" id="hd_id3144480" role="heading" level="3" l10n="U" +oldref="366">Example</paragraph> +<paragraph xml-lang="en-US" id="par_id3144494" role="paragraph" l10n="CHG" oldref="367"> +<item type="input">=PRODUCT(2;3;4)</item> returns 24.</paragraph><comment>see also FACT, SUM</comment> +</section> +<section id="Section25"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3160340"><bookmark_value>SUMSQ function</bookmark_value> +<bookmark_value>square number additions</bookmark_value> +<bookmark_value>sums;of square numbers</bookmark_value> +</bookmark><comment>mw added two entries</comment> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_QUADRATESUMME" id="bm_id3160351" localize="false"/> +<paragraph xml-lang="en-US" id="hd_id3160340" role="heading" level="2" l10n="U" +oldref="369">SUMSQ</paragraph> +<paragraph xml-lang="en-US" id="par_id3160368" role="paragraph" l10n="U" oldref="370"><ahelp hid="HID_FUNC_QUADRATESUMME">If you want to calculate the sum of the squares of numbers (totaling up of the squares of the arguments), enter these into the text fields.</ahelp></paragraph> +<paragraph xml-lang="en-US" id="hd_id3160388" role="heading" level="3" l10n="U" +oldref="371">Syntax</paragraph> +<paragraph xml-lang="en-US" id="par_id3160402" role="code" l10n="U" oldref="372">SUMSQ(Number1; Number2; ...; Number30)</paragraph> +<paragraph xml-lang="en-US" id="par_id3160415" role="paragraph" l10n="U" oldref="373"><emph>Number1 to 30</emph> are up to 30 arguments the sum of whose squares is to be calculated.</paragraph> +<paragraph xml-lang="en-US" id="hd_id3160436" role="heading" level="3" l10n="U" +oldref="374">Example</paragraph> +<paragraph xml-lang="en-US" id="par_id3160449" role="paragraph" l10n="U" oldref="375">If you enter the numbers <item type="input">2</item>; <item type="input">3</item> and <item type="input">4</item> in the Number 1; 2 and 3 text boxes, 29 is returned as the result.</paragraph> +</section> +<section id="Section24"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3158247"><bookmark_value>MOD function</bookmark_value> +<bookmark_value>remainders of divisions</bookmark_value> +</bookmark><comment>mw added one entry</comment> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_REST" id="bm_id3158259" localize="false"/> +<paragraph xml-lang="en-US" id="hd_id3158247" role="heading" level="2" l10n="U" +oldref="387">MOD</paragraph> +<paragraph xml-lang="en-US" id="par_id3158276" role="paragraph" l10n="CHG" oldref="388"><ahelp hid="HID_FUNC_REST">Returns the remainder when one integer is divided by another.</ahelp></paragraph> +<paragraph xml-lang="en-US" id="hd_id3158294" role="heading" level="3" l10n="U" +oldref="389">Syntax</paragraph> +<paragraph xml-lang="en-US" id="par_id3158308" role="code" l10n="U" oldref="390">MOD(Dividend; Divisor)</paragraph> +<paragraph xml-lang="en-US" id="par_id3158321" role="paragraph" l10n="CHG" oldref="391"> For integer arguments this function returns Dividend modulo Divisor, that is the remainder when <emph>Dividend</emph> is divided by <emph>Divisor</emph>.</paragraph> +<paragraph xml-lang="en-US" id="par_id3158341" role="paragraph" l10n="CHG" oldref="392">This function is implemented as <item type="literal">Dividend - Divisor * INT(Dividend/Divisor)</item> , and this formula gives the result if the arguments are not integer.</paragraph> +<paragraph xml-lang="en-US" id="hd_id3158361" role="heading" level="3" l10n="U" +oldref="393">Example</paragraph> +<paragraph xml-lang="en-US" id="par_id3158374" role="paragraph" l10n="CHG" oldref="394"> +<item type="input">=MOD(22;3)</item> returns 1, the remainder when 22 is divided by 3.</paragraph> +<paragraph xml-lang="en-US" id="par_id1278420" role="paragraph" l10n="NEW"> +<item type="input">=MOD(11.25;2.5)</item> returns 1.25.</paragraph><comment>see also QUOTIENT, INT, </comment> +</section> +<section id="Section23"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3144592"><bookmark_value>QUOTIENT function</bookmark_value> +<bookmark_value>divisions</bookmark_value> +</bookmark><comment>mw added one entry</comment> +<bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_QUOTIENT" id="bm_id3144603" localize="false"/> +<paragraph xml-lang="en-US" id="hd_id3144592" role="heading" level="2" l10n="E" +oldref="652">QUOTIENT</paragraph> +<paragraph xml-lang="en-US" id="par_id3144627" role="paragraph" l10n="CHG" oldref="653"><ahelp hid="HID_AAI_FUNC_QUOTIENT">Returns the integer part of a division operation.</ahelp></paragraph> +<paragraph xml-lang="en-US" id="hd_id3144646" role="heading" level="3" l10n="U" +oldref="654">Syntax</paragraph> +<paragraph xml-lang="en-US" id="par_id3144659" role="code" l10n="U" oldref="655">QUOTIENT(Numerator; Denominator)</paragraph> +<paragraph xml-lang="en-US" id="par_id9038972" role="paragraph" l10n="NEW">Returns the integer part of <emph>Numerator</emph> divided by <emph>Denominator</emph>.</paragraph> +<paragraph xml-lang="en-US" id="par_id7985168" role="paragraph" l10n="NEW">QUOTIENT is equivalent to <item type="literal">INT(numerator/denominator)</item>, except that it may report errors with different error codes.</paragraph> +<paragraph xml-lang="en-US" id="hd_id3144674" role="heading" level="3" l10n="U" +oldref="656">Example</paragraph> +<paragraph xml-lang="en-US" id="par_id3144687" role="paragraph" l10n="CHG" oldref="657"> +<item type="input">=QUOTIENT(11;3)</item> returns 3. The remainder of 2 is lost.</paragraph><comment>see also MOD, INT </comment> +</section> +<section id="Section22"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3144702"><bookmark_value>RADIANS function</bookmark_value> +<bookmark_value>converting;degrees, into radians</bookmark_value> +</bookmark><comment>mw added one entry</comment> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_RAD" id="bm_id3158008" localize="false"/> +<paragraph xml-lang="en-US" id="hd_id3144702" role="heading" level="2" l10n="U" +oldref="377">RADIANS</paragraph> +<paragraph xml-lang="en-US" id="par_id3158025" role="paragraph" l10n="U" oldref="378"><ahelp hid="HID_FUNC_RAD">Converts degrees to radians.</ahelp></paragraph> +<paragraph xml-lang="en-US" id="hd_id3158042" role="heading" level="3" l10n="U" +oldref="379">Syntax</paragraph> +<paragraph xml-lang="en-US" id="par_id3158055" role="code" l10n="U" oldref="380">RADIANS(Number)</paragraph> +<paragraph xml-lang="en-US" id="par_id3158069" role="paragraph" l10n="CHG" oldref="381"><emph>Number</emph> is the angle in degrees to be converted to radians.</paragraph> +<paragraph xml-lang="en-US" id="hd_id876186" role="heading" level="3" l10n="NEW">Example</paragraph> +<paragraph xml-lang="en-US" id="par_id3939634" role="paragraph" l10n="NEW"> +<item type="input">=RADIANS(90)</item> returns 1.5707963267949, which is PI/2 to Calc's accuracy.</paragraph><comment>see also DEGREES </comment> +</section> +<section id="Section21"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3158121"><bookmark_value>ROUND function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_RUNDEN" id="bm_id3158133" localize="false"/> +<paragraph xml-lang="en-US" id="hd_id3158121" role="heading" level="2" l10n="U" +oldref="398">ROUND</paragraph> +<paragraph xml-lang="en-US" id="par_id3158150" role="paragraph" l10n="CHG" oldref="399"><ahelp hid="HID_FUNC_RUNDEN">Rounds a number to a certain number of decimal places.</ahelp></paragraph> +<paragraph xml-lang="en-US" id="hd_id3158169" role="heading" level="3" l10n="U" +oldref="400">Syntax</paragraph> +<paragraph xml-lang="en-US" id="par_id3158182" role="code" l10n="U" oldref="401">ROUND(Number; Count)</paragraph> +<paragraph xml-lang="en-US" id="par_id3158196" role="paragraph" l10n="U" oldref="402">Returns <emph>Number</emph> rounded to <emph>Count</emph> decimal places. If Count is omitted or zero, the function rounds to the nearest integer. If Count is negative, the function rounds to the nearest 10, 100, 1000, etc.</paragraph> +<paragraph xml-lang="en-US" id="par_id599688" role="paragraph" l10n="NEW">This function rounds to the nearest number. See ROUNDDOWN and ROUNDUP for alternatives.</paragraph> +<paragraph xml-lang="en-US" id="hd_id3145863" role="heading" level="3" l10n="U" +oldref="404">Example</paragraph> +<paragraph xml-lang="en-US" id="par_id3145876" role="paragraph" l10n="CHG" oldref="405"> +<item type="input">=ROUND(2.348;2)</item> returns 2.35</paragraph> +<paragraph xml-lang="en-US" id="par_id3145899" role="paragraph" l10n="CHG" oldref="406"> +<item type="input">=ROUND(-32.4834;3)</item> returns -32.483. Change the cell format to see all decimals.</paragraph> +<paragraph xml-lang="en-US" id="par_id1371501" role="paragraph" l10n="NEW"> +<item type="input">=ROUND(2.348;0)</item> returns 2.</paragraph> +<paragraph xml-lang="en-US" id="par_id4661702" role="paragraph" l10n="NEW"> +<item type="input">=ROUND(2.5)</item> returns 3. </paragraph> +<paragraph xml-lang="en-US" id="par_id7868892" role="paragraph" l10n="NEW"> +<item type="input">=ROUND(987.65;-2)</item> returns 1000.</paragraph><comment>see also INT, TRUNC, ROUNDDOWN, ROUNDUP, +CEILING, FLOOR, EVEN, ODD, MROUND</comment> +</section> +<section id="Section20"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3145991"><bookmark_value>ROUNDDOWN function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_ABRUNDEN" id="bm_id3146003" localize="false"/> +<paragraph xml-lang="en-US" id="hd_id3145991" role="heading" level="2" l10n="U" +oldref="24">ROUNDDOWN</paragraph> +<paragraph xml-lang="en-US" id="par_id3146020" role="paragraph" l10n="CHG" oldref="25"><ahelp hid="HID_FUNC_ABRUNDEN">Rounds a number down, toward zero, to a certain precision.</ahelp></paragraph> +<paragraph xml-lang="en-US" id="hd_id3146037" role="heading" level="3" l10n="U" +oldref="26">Syntax</paragraph> +<paragraph xml-lang="en-US" id="par_id3146051" role="code" l10n="U" oldref="27">ROUNDDOWN(Number; Count)</paragraph> +<paragraph xml-lang="en-US" id="par_id3146064" role="paragraph" l10n="CHG" oldref="28">Returns <emph>Number</emph> rounded down (towards zero) to <emph>Count</emph> decimal places. If Count is omitted or zero, the function rounds down to an integer. If Count is negative, the function rounds down to the next 10, 100, 1000, etc.</paragraph> +<paragraph xml-lang="en-US" id="par_id2188787" role="paragraph" l10n="NEW">This function rounds towards zero. See ROUNDUP and ROUND for alternatives.</paragraph> +<paragraph xml-lang="en-US" id="hd_id3163164" role="heading" level="3" l10n="U" +oldref="30">Example</paragraph> +<paragraph xml-lang="en-US" id="par_id3163178" role="paragraph" l10n="CHG" oldref="31"> +<item type="input">=ROUNDDOWN(1.234;2)</item> returns 1.23.</paragraph> +<paragraph xml-lang="en-US" id="par_id5833307" role="paragraph" l10n="NEW"> +<item type="input">=ROUNDDOWN(45.67;0)</item> returns 45.</paragraph> +<paragraph xml-lang="en-US" id="par_id7726676" role="paragraph" l10n="NEW"> +<item type="input">=ROUNDDOWN(-45.67)</item> returns -45.</paragraph> +<paragraph xml-lang="en-US" id="par_id3729361" role="paragraph" l10n="NEW"> +<item type="input">=ROUNDDOWN(987.65;-2)</item> returns 900.</paragraph><comment>see also INT, TRUNC, ROUND, ROUNDUP, +CEILING, FLOOR, EVEN, ODD, MROUND</comment> +</section> +<section id="Section19"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3163268"><bookmark_value>ROUNDUP function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_AUFRUNDEN" id="bm_id3163280" localize="false"/> +<paragraph xml-lang="en-US" id="hd_id3163268" role="heading" level="2" l10n="U" +oldref="140">ROUNDUP</paragraph> +<paragraph xml-lang="en-US" id="par_id3163297" role="paragraph" l10n="CHG" oldref="141"><ahelp hid="HID_FUNC_AUFRUNDEN">Rounds a number up, away from zero, to a certain precision.</ahelp></paragraph> +<paragraph xml-lang="en-US" id="hd_id3163315" role="heading" level="3" l10n="U" +oldref="142">Syntax</paragraph> +<paragraph xml-lang="en-US" id="par_id3163328" role="code" l10n="U" oldref="143">ROUNDUP(Number; Count)</paragraph> +<paragraph xml-lang="en-US" id="par_id3163342" role="paragraph" l10n="CHG" oldref="144">Returns <emph>Number</emph> rounded up (away from zero) to <emph>Count</emph> decimal places. If Count is omitted or zero, the function rounds up to an integer. If Count is negative, the function rounds up to the next 10, 100, 1000, etc.</paragraph> +<paragraph xml-lang="en-US" id="par_id9573961" role="paragraph" l10n="NEW">This function rounds away from zero. See ROUNDDOWN and ROUND for alternatives.</paragraph> +<paragraph xml-lang="en-US" id="hd_id3163381" role="heading" level="3" l10n="U" +oldref="146">Example</paragraph> +<paragraph xml-lang="en-US" id="par_id3144786" role="paragraph" l10n="CHG" oldref="147"> +<item type="input">=ROUNDUP(1.1111;2)</item> returns 1.12.</paragraph> +<paragraph xml-lang="en-US" id="par_id7700430" role="paragraph" l10n="NEW"> +<item type="input">=ROUNDUP(1.2345;1)</item> returns 1.3.</paragraph> +<paragraph xml-lang="en-US" id="par_id1180455" role="paragraph" l10n="NEW"> +<item type="input">=ROUNDUP(45.67;0)</item> returns 46.</paragraph> +<paragraph xml-lang="en-US" id="par_id3405560" role="paragraph" l10n="NEW"> +<item type="input">=ROUNDUP(-45.67)</item> returns -46.</paragraph> +<paragraph xml-lang="en-US" id="par_id3409527" role="paragraph" l10n="NEW"> +<item type="input">=ROUNDUP(987.65;-2)</item> returns 1000.</paragraph><comment>see also INT, TRUNC, ROUND, ROUNDDOWN, +CEILING, FLOOR, EVEN, ODD, MROUND</comment> +</section> +<section id="Section63"> +<bookmark xml-lang="en-US" branch="index" id="bm_id5256537"><bookmark_value>SEC function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_SECANT" id="bm_id6577644" localize="false"/> +<paragraph xml-lang="en-US" id="hd_id5187204" role="heading" level="2" l10n="U" +oldref="149">SEC</paragraph> +<paragraph xml-lang="en-US" id="par_id9954962" role="paragraph" l10n="CHG" oldref="150"><ahelp hid="HID_FUNC_SECANT">Returns the secant of the given angle (in radians). The secant of an angle is equivalent to 1 divided by the cosine of that angle</ahelp></paragraph> +<paragraph xml-lang="en-US" id="hd_id422243" role="heading" level="3" l10n="U" +oldref="151">Syntax</paragraph> +<paragraph xml-lang="en-US" id="par_id2055913" role="code" l10n="U" oldref="152">SEC(Number)</paragraph> +<paragraph xml-lang="en-US" id="par_id9568170" role="paragraph" l10n="CHG" oldref="153"> Returns the (trigonometric) secant of <emph>Number</emph>, the angle in radians.</paragraph> +<paragraph xml-lang="en-US" id="par_id9047465" role="paragraph" l10n="NEW">To return the secant of an angle in degrees, use the RADIANS function.</paragraph> +<paragraph xml-lang="en-US" id="hd_id9878918" role="heading" level="3" l10n="U" +oldref="154">Examples</paragraph> +<paragraph xml-lang="en-US" id="par_id6935513" role="paragraph" l10n="U" oldref="155"> +<item type="input">=SEC(PI()/4)</item> returns approximately 1.4142135624, the inverse of the cosine of PI/4 radians.</paragraph> +<paragraph xml-lang="en-US" id="par_id3954287" role="paragraph" l10n="U" oldref="156"> +<item type="input">=SEC(RADIANS(60))</item> returns 2, the secant of 60 degrees.</paragraph><comment>see also SIN, TAN, COT, CSC, +ACOS, ASIN, ATAN, ATAN2, ACOT</comment> +</section> +<section id="Section65"> +<bookmark xml-lang="en-US" branch="index" id="bm_id840005"><bookmark_value>SECH function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_SECANTHYP" id="bm_id6301347" localize="false"/> +<paragraph xml-lang="en-US" id="hd_id8661934" role="heading" level="2" l10n="U" +oldref="159">SECH</paragraph> +<paragraph xml-lang="en-US" id="par_id408174" role="paragraph" l10n="U" oldref="160"><ahelp hid="HID_FUNC_SECANTHYP">Returns the hyperbolic secant of a number.</ahelp></paragraph> +<paragraph xml-lang="en-US" id="hd_id875988" role="heading" level="3" l10n="U" +oldref="161">Syntax</paragraph> +<paragraph xml-lang="en-US" id="par_id4985391" role="code" l10n="U" oldref="162">SECH(Number)</paragraph> +<paragraph xml-lang="en-US" id="par_id1952124" role="paragraph" l10n="CHG" oldref="163">Returns the hyperbolic secant of <emph>Number</emph>.</paragraph> +<paragraph xml-lang="en-US" id="hd_id9838764" role="heading" level="3" l10n="U" +oldref="164">Example</paragraph> +<paragraph xml-lang="en-US" id="par_id1187764" role="paragraph" l10n="CHG" oldref="165"> +<item type="input">=SECH(0)</item> returns 1, the hyperbolic secant of 0.</paragraph><comment>see also SINH, TANH, COTH, CSCH, +ACOSH, ASINH, ATANH, ACOTH</comment> +</section> +<section id="Section18"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3144877"><bookmark_value>SIN function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_SIN" id="bm_id3144889" localize="false"/> +<paragraph xml-lang="en-US" id="hd_id3144877" role="heading" level="2" l10n="U" +oldref="408">SIN</paragraph> +<paragraph xml-lang="en-US" id="par_id3144906" role="paragraph" l10n="CHG" oldref="409"><ahelp hid="HID_FUNC_SIN">Returns the sine of the given angle (in radians).</ahelp></paragraph> +<paragraph xml-lang="en-US" id="hd_id3144923" role="heading" level="3" l10n="U" +oldref="410">Syntax</paragraph> +<paragraph xml-lang="en-US" id="par_id3144937" role="code" l10n="U" oldref="411">SIN(Number)</paragraph> +<paragraph xml-lang="en-US" id="par_id3144950" role="paragraph" l10n="CHG" oldref="412">Returns the (trigonometric) sine of <emph>Number</emph>, the angle in radians.</paragraph> +<paragraph xml-lang="en-US" id="par_id8079470" role="paragraph" l10n="NEW">To return the sine of an angle in degrees, use the RADIANS function.</paragraph> +<paragraph xml-lang="en-US" id="hd_id3144969" role="heading" level="3" l10n="U" +oldref="413">Example</paragraph> +<paragraph xml-lang="en-US" id="par_id3144983" role="paragraph" l10n="CHG" oldref="414"> +<item type="input">=SIN(PI()/2)</item> returns 1, the sine of PI/2 radians.</paragraph> +<paragraph xml-lang="en-US" id="par_id3916440" role="paragraph" l10n="NEW"> +<item type="input">=SIN(RADIANS(30))</item> returns 0.5, the sine of 30 degrees.</paragraph><comment>see also COS, TAN, COT, +ACOS, ASIN, ATAN, ATAN2, ACOT </comment> +</section> +<section id="Section17"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3163397"><bookmark_value>SINH function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_SINHYP" id="bm_id3163409" localize="false"/> +<paragraph xml-lang="en-US" id="hd_id3163397" role="heading" level="2" l10n="U" +oldref="418">SINH</paragraph> +<paragraph xml-lang="en-US" id="par_id3163426" role="paragraph" l10n="U" oldref="419"><ahelp hid="HID_FUNC_SINHYP">Returns the hyperbolic sine of a number.</ahelp></paragraph> +<paragraph xml-lang="en-US" id="hd_id3163444" role="heading" level="3" l10n="U" +oldref="420">Syntax</paragraph> +<paragraph xml-lang="en-US" id="par_id3163457" role="code" l10n="U" oldref="421">SINH(Number)</paragraph> +<paragraph xml-lang="en-US" id="par_id3163471" role="paragraph" l10n="CHG" oldref="422">Returns the hyperbolic sine of <emph>Number</emph>.</paragraph> +<paragraph xml-lang="en-US" id="hd_id3163491" role="heading" level="3" l10n="U" +oldref="423">Example</paragraph> +<paragraph xml-lang="en-US" id="par_id3163504" role="paragraph" l10n="CHG" oldref="424"> +<item type="input">=SINH(0)</item> returns 0, the hyperbolic sine of 0.</paragraph><comment>see also COSH, TANH, COTH, +ACOSH, ASINH, ATANH, ACOTH</comment> +</section> +<section id="Section16"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3163596"><bookmark_value>SUM function</bookmark_value> +<bookmark_value>adding;numbers in cell ranges</bookmark_value> +</bookmark><comment>mw added one entry</comment> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_SUMME" id="bm_id3163608" localize="false"/> +<paragraph xml-lang="en-US" id="hd_id3163596" role="heading" level="2" l10n="U" +oldref="428">SUM</paragraph> +<paragraph xml-lang="en-US" id="par_id3163625" role="paragraph" l10n="U" oldref="429"><ahelp hid="HID_FUNC_SUMME">Adds all the numbers in a range of cells.</ahelp></paragraph> +<paragraph xml-lang="en-US" id="hd_id3163643" role="heading" level="3" l10n="U" +oldref="430">Syntax</paragraph> +<paragraph xml-lang="en-US" id="par_id3163656" role="code" l10n="U" oldref="431">SUM(Number1; Number2; ...; Number30)</paragraph> +<paragraph xml-lang="en-US" id="par_id3163671" role="paragraph" l10n="U" oldref="432"><emph>Number 1 to Number 30</emph> are up to 30 arguments whose sum is to be calculated.</paragraph> +<paragraph xml-lang="en-US" id="hd_id3163690" role="heading" level="3" l10n="U" +oldref="433">Example</paragraph> +<paragraph xml-lang="en-US" id="par_id3163704" role="paragraph" l10n="U" oldref="434">If you enter the numbers <item type="input">2</item>; <item type="input">3 </item>and <item type="input">4</item> in the Number 1; 2 and 3 text boxes, 9 will be returned as the result.</paragraph> +<paragraph xml-lang="en-US" id="par_id3151740" role="paragraph" l10n="U" oldref="556"> +<item type="input">=SUM(A1;A3;B5)</item> calculates the sum of the three cells. <item type="input">=SUM (A1:E10)</item> calculates the sum of all cells in the A1 to E10 cell range.</paragraph> +<paragraph xml-lang="en-US" id="par_id3151756" role="paragraph" l10n="U" oldref="619">Conditions linked by AND can be used with the function SUM() in the following manner:</paragraph> +<paragraph xml-lang="en-US" id="par_id3151774" role="paragraph" l10n="CHG" oldref="620">Example assumption: You have entered invoices into a table. Column A contains the date value of the invoice, column B the amounts. You want to find a formula that you can use to return the total of all amounts only for a specific month, e.g. only the amount for the period >=2008-01-01 to <2008-02-01. The range with the date values covers A1:A40, the range containing the amounts to be totaled is B1:B40. C1 contains the start date, 2008<item type="input">-01-01</item>, of the invoices to be included and C2 the date, 2008<item type="input">-02-01</item>, that is no longer included.</paragraph> +<paragraph xml-lang="en-US" id="par_id3151799" role="paragraph" l10n="U" oldref="621">Enter the following formula as an array formula:</paragraph> +<paragraph xml-lang="en-US" id="par_id3151813" role="paragraph" l10n="U" oldref="622"> +<item type="input">=SUM((A1:A40>=C1)*(A1:A40<C2)*B1:B40)</item> +</paragraph> +<paragraph xml-lang="en-US" id="par_id3151828" role="paragraph" l10n="U" oldref="623">In order to enter this as an array formula, you must press the Shift<switchinline select="sys"><caseinline select="MAC">+Command +</caseinline><defaultinline>+ Ctrl</defaultinline></switchinline>+ Enter keys instead of simply pressing the Enter key to close the formula. The formula will then be shown in the <emph>Formula</emph> bar enclosed in braces.</paragraph> +<paragraph xml-lang="en-US" id="par_id3151869" role="paragraph" l10n="U" oldref="624">{=SUM((A1:A40>=C1)*(A1:A40<C2)*B1:B40)}</paragraph> +<paragraph xml-lang="en-US" id="par_id3151884" role="paragraph" l10n="CHG" oldref="625">The formula is based on the fact that the result of a comparison is 1 if the criterion is met and 0 if it is not met. The individual comparison results will be treated as an array and used in matrix multiplication, and at the end the individual values will be totaled to give the result matrix.</paragraph> +</section> +<section id="Section15"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3151957"><bookmark_value>SUMIF function</bookmark_value> +<bookmark_value>adding;specified numbers</bookmark_value> +</bookmark><comment>mw added one entry</comment> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_SUMMEWENN" id="bm_id3151969" localize="false"/> +<paragraph xml-lang="en-US" id="hd_id3151957" role="heading" level="2" l10n="U" +oldref="436">SUMIF</paragraph> +<paragraph xml-lang="en-US" id="par_id3151986" role="paragraph" l10n="U" oldref="437"><ahelp hid="HID_FUNC_SUMMEWENN">Adds the cells specified by a given criteria.</ahelp> This function is used to browse a range when you search for a certain value.</paragraph> +<embed href="text/shared/00/00000001.xhp#regulaer"/> +<paragraph xml-lang="en-US" id="hd_id3152015" role="heading" level="3" l10n="U" +oldref="438">Syntax</paragraph> +<paragraph xml-lang="en-US" id="par_id3152028" role="code" l10n="U" oldref="439">SUMIF(Range; Criteria; SumRange)</paragraph> +<paragraph xml-lang="en-US" id="par_id3152043" role="paragraph" l10n="U" oldref="440"><emph>Range</emph> is the range to which the criteria are to be applied.</paragraph> +<paragraph xml-lang="en-US" id="par_id3152062" role="paragraph" l10n="CHG" oldref="441"><emph>Criteria</emph> is the cell in which the search criterion is shown, or the search criterion itself. If the criteria is written into the formula, it has to be surrounded by double quotes.</paragraph> +<paragraph xml-lang="en-US" id="par_id3152083" role="paragraph" l10n="U" oldref="442"><emph>SumRange</emph> is the range from which values are summed. If this parameter has not been indicated, the values found in the Range are summed.</paragraph> +<paragraph xml-lang="en-US" id="par_id8347422" role="note" l10n="NEW">SUMIF supports the reference concatenation operator (~) only in the Criteria parameter, and only if the optional SumRange parameter is not given.</paragraph> +<paragraph xml-lang="en-US" id="hd_id3152110" role="heading" level="3" l10n="U" +oldref="443">Example</paragraph> +<paragraph xml-lang="en-US" id="par_id3152148" role="paragraph" l10n="CHG" oldref="626">To sum up only negative numbers: <item type="input">=SUMIF(A1:A10;"<0")</item> +</paragraph> +<paragraph xml-lang="en-US" id="par_id6670125" role="paragraph" l10n="NEW"> +<item type="input">=SUMIF(A1:A10;">0";B1:10)</item> - sums values from the range B1:B10 only if the corresponding values in the range A1:A10 are >0.</paragraph> +<paragraph xml-lang="en-US" id="par_id6062196" role="paragraph" l10n="NEW">See COUNTIF() for some more syntax examples that can be used with SUMIF().</paragraph> +</section> +<section id="Section14"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3152195"><bookmark_value>TAN function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_TAN" id="bm_id3152207" localize="false"/> +<paragraph xml-lang="en-US" id="hd_id3152195" role="heading" level="2" l10n="U" +oldref="446">TAN</paragraph> +<paragraph xml-lang="en-US" id="par_id3152224" role="paragraph" l10n="CHG" oldref="447"><ahelp hid="HID_FUNC_TAN">Returns the tangent of the given angle (in radians).</ahelp></paragraph> +<paragraph xml-lang="en-US" id="hd_id3152242" role="heading" level="3" l10n="U" +oldref="448">Syntax</paragraph> +<paragraph xml-lang="en-US" id="par_id3152255" role="code" l10n="U" oldref="449">TAN(Number)</paragraph> +<paragraph xml-lang="en-US" id="par_id3152269" role="paragraph" l10n="CHG" oldref="450">Returns the (trigonometric) tangent of <emph>Number</emph>, the angle in radians.</paragraph> +<paragraph xml-lang="en-US" id="par_id5752128" role="paragraph" l10n="NEW">To return the tangent of an angle in degrees, use the RADIANS function.</paragraph> +<paragraph xml-lang="en-US" id="hd_id3152287" role="heading" level="3" l10n="U" +oldref="451">Example</paragraph> +<paragraph xml-lang="en-US" id="par_id3152301" role="paragraph" l10n="CHG" oldref="452"> +<item type="input">=TAN(PI()/4) </item>returns 1, the tangent of PI/4 radians.</paragraph> +<paragraph xml-lang="en-US" id="par_id1804864" role="paragraph" l10n="NEW"> +<item type="input">=TAN(RADIANS(45))</item> returns 1, the tangent of 45 degrees.</paragraph><comment>see also COS, SIN, COT, +ACOS, ASIN, ATAN, ATAN2, ACOT</comment> +</section> +<section id="Section13"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3165434"><bookmark_value>TANH function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_TANHYP" id="bm_id3165446" localize="false"/> +<paragraph xml-lang="en-US" id="hd_id3165434" role="heading" level="2" l10n="U" +oldref="456">TANH</paragraph> +<paragraph xml-lang="en-US" id="par_id3165462" role="paragraph" l10n="U" oldref="457"><ahelp hid="HID_FUNC_TANHYP">Returns the hyperbolic tangent of a number.</ahelp></paragraph> +<paragraph xml-lang="en-US" id="hd_id3165480" role="heading" level="3" l10n="U" +oldref="458">Syntax</paragraph> +<paragraph xml-lang="en-US" id="par_id3165494" role="code" l10n="U" oldref="459">TANH(Number)</paragraph> +<paragraph xml-lang="en-US" id="par_id3165508" role="paragraph" l10n="CHG" oldref="460">Returns the hyperbolic tangent of <emph>Number</emph>.</paragraph> +<paragraph xml-lang="en-US" id="hd_id3165527" role="heading" level="3" l10n="U" +oldref="461">Example</paragraph> +<paragraph xml-lang="en-US" id="par_id3165541" role="paragraph" l10n="CHG" oldref="462"> +<item type="input">=TANH(0)</item> returns 0, the hyperbolic tangent of 0.</paragraph><comment>see also COSH, SINH, COTH, +ACOSH, ASINH, ATANH, ACOTH</comment> +</section> +<section id="Section12"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3165633"><bookmark_value>AutoFilter function; subtotals</bookmark_value> +<bookmark_value>sums;of filtered data</bookmark_value> +<bookmark_value>filtered data; sums</bookmark_value> +<bookmark_value>SUBTOTAL function</bookmark_value> +</bookmark><comment>mw made "sums..." a two level entry</comment> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_TEILERGEBNIS" id="bm_id3165644" localize="false"/> +<paragraph xml-lang="en-US" id="hd_id3165633" role="heading" level="2" l10n="U" +oldref="466">SUBTOTAL</paragraph> +<paragraph xml-lang="en-US" id="par_id3165682" role="paragraph" l10n="U" oldref="467"><ahelp hid="HID_FUNC_TEILERGEBNIS">Calculates subtotals.</ahelp> If a range already contains subtotals, these are not used for further calculations. Use this function with the AutoFilters to take only the filtered records into account.</paragraph> +<paragraph xml-lang="en-US" id="hd_id3165704" role="heading" level="3" l10n="U" +oldref="495">Syntax</paragraph> +<paragraph xml-lang="en-US" id="par_id3165717" role="code" l10n="U" oldref="496">SUBTOTAL(Function; Range)</paragraph> +<paragraph xml-lang="en-US" id="par_id3165731" role="paragraph" l10n="U" oldref="497"><emph>Function</emph> is a number that stands for one of the following functions:</paragraph> +<table id="tbl_id3165752"> +<tablerow> +<tablecell> +<paragraph xml-lang="en-US" id="par_id3165782" role="paragraph" l10n="U" oldref="469">Function index</paragraph> +</tablecell> +<tablecell> +<paragraph xml-lang="en-US" id="par_id3165806" role="paragraph" l10n="U" oldref="470">Function</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph xml-lang="en-US" id="par_id3165833" role="paragraph" l10n="U" oldref="471">1</paragraph> +</tablecell> +<tablecell> +<paragraph xml-lang="en-US" id="par_id3165856" role="paragraph" l10n="U" oldref="472">AVERAGE</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph xml-lang="en-US" id="par_id3165883" role="paragraph" l10n="U" oldref="473">2</paragraph> +</tablecell> +<tablecell> +<paragraph xml-lang="en-US" id="par_id3165906" role="paragraph" l10n="U" oldref="474">COUNT</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph xml-lang="en-US" id="par_id3165933" role="paragraph" l10n="U" oldref="475">3</paragraph> +</tablecell> +<tablecell> +<paragraph xml-lang="en-US" id="par_id3165956" role="paragraph" l10n="U" oldref="476">COUNTA</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph xml-lang="en-US" id="par_id3165983" role="paragraph" l10n="U" oldref="477">4</paragraph> +</tablecell> +<tablecell> +<paragraph xml-lang="en-US" id="par_id3166006" role="paragraph" l10n="U" oldref="478">MAX</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph xml-lang="en-US" id="par_id3166033" role="paragraph" l10n="U" oldref="479">5</paragraph> +</tablecell> +<tablecell> +<paragraph xml-lang="en-US" id="par_id3166056" role="paragraph" l10n="U" oldref="480">MIN</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph xml-lang="en-US" id="par_id3143316" role="paragraph" l10n="U" oldref="481">6</paragraph> +</tablecell> +<tablecell> +<paragraph xml-lang="en-US" id="par_id3143339" role="paragraph" l10n="U" oldref="482">PRODUCT</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph xml-lang="en-US" id="par_id3143366" role="paragraph" l10n="U" oldref="483">7</paragraph> +</tablecell> +<tablecell> +<paragraph xml-lang="en-US" id="par_id3143389" role="paragraph" l10n="U" oldref="484">STDEV</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph xml-lang="en-US" id="par_id3143416" role="paragraph" l10n="U" oldref="485">8</paragraph> +</tablecell> +<tablecell> +<paragraph xml-lang="en-US" id="par_id3143439" role="paragraph" l10n="U" oldref="486">STDEVP</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph xml-lang="en-US" id="par_id3143466" role="paragraph" l10n="U" oldref="487">9</paragraph> +</tablecell> +<tablecell> +<paragraph xml-lang="en-US" id="par_id3143489" role="paragraph" l10n="U" oldref="488">SUM</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph xml-lang="en-US" id="par_id3143516" role="paragraph" l10n="U" oldref="489">10</paragraph> +</tablecell> +<tablecell> +<paragraph xml-lang="en-US" id="par_id3143539" role="paragraph" l10n="U" oldref="490">VAR</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph xml-lang="en-US" id="par_id3143566" role="paragraph" l10n="U" oldref="491">11</paragraph> +</tablecell> +<tablecell> +<paragraph xml-lang="en-US" id="par_id3143589" role="paragraph" l10n="U" oldref="492">VARP</paragraph> +</tablecell> +</tablerow> +</table> + +<paragraph xml-lang="en-US" id="par_id3143606" role="paragraph" l10n="U" oldref="498"><emph>Range</emph> is the range whose cells are included.</paragraph> +<paragraph xml-lang="en-US" id="hd_id3143625" role="heading" level="3" l10n="U" +oldref="499">Example</paragraph> +<paragraph xml-lang="en-US" id="par_id3143638" role="paragraph" l10n="U" oldref="562">You have a table in the cell range A1:B5 containing cities in column A and accompanying figures in column B. You have used an AutoFilter so that you only see rows containing the city Hamburg. You want to see the sum of the figures that are displayed; that is, just the subtotal for the filtered rows. In this case the correct formula would be:</paragraph> +<paragraph xml-lang="en-US" id="par_id3143658" role="paragraph" l10n="U" oldref="563"> +<item type="input">=SUBTOTAL(9;B2:B5)</item> +</paragraph> +</section> +<section id="Section11"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3143672"><bookmark_value>Euro; converting</bookmark_value> +<bookmark_value>EUROCONVERT function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_UMRECHNEN" id="bm_id3143684" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_EUROCONVERT" id="bm_id0119200904282677" localize="false"/> +<paragraph xml-lang="en-US" id="hd_id3143672" role="heading" level="2" l10n="CHG" +oldref="564">EUROCONVERT<comment>insert link in financial</comment></paragraph> +<paragraph xml-lang="en-US" id="par_id3143708" role="paragraph" l10n="CHG" oldref="565"><ahelp hid="HID_FUNC_UMRECHNEN">Converts between old European national currency and to and from Euros.</ahelp></paragraph> +<paragraph xml-lang="en-US" id="par_id3143731" role="heading" level="3" l10n="U" +oldref="566"><emph>Syntax</emph> +</paragraph> +<paragraph xml-lang="en-US" id="par_id3143748" role="code" l10n="CHG" oldref="567">EUROCONVERT(Value; "From_currency"; "To_currency", full_precision, triangulation_precision)</paragraph> +<paragraph xml-lang="en-US" id="par_id3143763" role="paragraph" l10n="U" oldref="568"><emph>Value</emph> is the amount of the currency to be converted.</paragraph> +<paragraph xml-lang="en-US" id="par_id3143782" role="paragraph" l10n="CHG" oldref="569"><emph>From_currency</emph> and <emph>To_currency</emph> are the currency units to convert from and to respectively. These must be text, the official abbreviation for the currency (for example, "EUR"). The rates (shown per Euro) were set by the European Commission.</paragraph> +<paragraph xml-lang="en-US" id="par_id0119200904301810" role="paragraph" l10n="NEW"><emph>Full_precision</emph> is optional. If omitted or False, the result is rounded according to the decimals of the To currency. If Full_precision is True, the result is not rounded.</paragraph> +<paragraph xml-lang="en-US" id="par_id0119200904301815" role="paragraph" l10n="NEW"><emph>Triangulation_precision</emph> is optional. If Triangulation_precision is given and >=3, the intermediate result of a triangular conversion (currency1,EUR,currency2) is rounded to that precision. If Triangulation_precision is omitted, the intermediate result is not rounded. Also if To currency is "EUR", Triangulation_precision is used as if triangulation was needed and conversion from EUR to EUR was applied.</paragraph> +<paragraph xml-lang="en-US" id="par_id3143819" role="heading" level="3" l10n="U" +oldref="570"><emph>Examples</emph> +</paragraph> +<paragraph xml-lang="en-US" id="par_id3143837" role="paragraph" l10n="U" oldref="571"> +<item type="input">=EUROCONVERT(100;"ATS";"EUR")</item> converts 100 Austrian Schillings into Euros.</paragraph> +<paragraph xml-lang="en-US" id="par_id3143853" role="paragraph" l10n="U" oldref="572"> +<item type="input">=EUROCONVERT(100;"EUR";"DEM")</item> converts 100 Euros into German Marks.</paragraph> +</section> +<section id="convert"> +<bookmark xml-lang="en-US" branch="index" id="bm_id0908200902090676"><bookmark_value>CONVERT function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_UMRECHNEN" id="bm_id0908200902093111" localize="false"/> +<paragraph xml-lang="en-US" id="hd_id0908200902074836" role="heading" level="2" l10n="NEW">CONVERT</paragraph> +<paragraph xml-lang="en-US" id="par_id0908200902131122" role="paragraph" l10n="NEW"><ahelp hid=".">Converts a value from one unit of measurement to another unit of measurement. The conversion factors are given in a list in the configuration.</ahelp></paragraph> +<paragraph xml-lang="en-US" id="par_id0908200902475420" role="paragraph" l10n="NEW">At one time the list of conversion factors included the legacy European currencies and the Euro (see examples below). We suggest using the new function EUROCONVERT for converting these currencies.</paragraph> +<paragraph xml-lang="en-US" id="hd_id0908200902131071" role="heading" level="3" l10n="NEW">Syntax</paragraph> +<paragraph xml-lang="en-US" id="par_id0908200902131191" role="code" l10n="NEW">CONVERT(value;"text";"text")</paragraph> +<paragraph xml-lang="en-US" id="hd_id0908200902131152" role="heading" level="3" l10n="NEW">Example</paragraph> +<paragraph xml-lang="en-US" id="par_id090820090213112" role="paragraph" l10n="NEW"> +<item type="input">=CONVERT(100;"ATS";"EUR")</item> returns the Euro value of 100 Austrian Schillings.</paragraph> +<paragraph xml-lang="en-US" id="par_id0908200902475431" role="paragraph" l10n="NEW">=CONVERT(100;"EUR";"DEM") converts 100 Euros into German Marks. </paragraph> +</section> +<section id="Section10"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3157177"><bookmark_value>ODD function</bookmark_value> +<bookmark_value>rounding;up/down to nearest odd integer</bookmark_value> +</bookmark><comment>mw added one entry</comment> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_UNGERADE" id="bm_id3157188" localize="false"/> +<paragraph xml-lang="en-US" id="hd_id3157177" role="heading" level="2" l10n="U" +oldref="502">ODD</paragraph> +<paragraph xml-lang="en-US" id="par_id3157205" role="paragraph" l10n="CHG" oldref="503"><ahelp hid="HID_FUNC_UNGERADE">Rounds a positive number up to the nearest odd integer and a negative number down to the nearest odd integer.</ahelp></paragraph> +<paragraph xml-lang="en-US" id="hd_id3157223" role="heading" level="3" l10n="U" +oldref="504">Syntax</paragraph> +<paragraph xml-lang="en-US" id="par_id3157237" role="code" l10n="U" oldref="505">ODD(Number)</paragraph> +<paragraph xml-lang="en-US" id="par_id3157250" role="paragraph" l10n="CHG" oldref="506"> Returns <emph>Number</emph> rounded to the next odd integer up, away from zero.</paragraph> +<paragraph xml-lang="en-US" id="hd_id3157270" role="heading" level="3" l10n="U" +oldref="507">Example</paragraph> +<paragraph xml-lang="en-US" id="par_id3157283" role="paragraph" l10n="CHG" oldref="508"> +<item type="input">=ODD(1.2)</item> returns 3.</paragraph> +<paragraph xml-lang="en-US" id="par_id8746910" role="paragraph" l10n="NEW"> +<item type="input">=ODD(1)</item> returns 1.</paragraph> +<paragraph xml-lang="en-US" id="par_id9636524" role="paragraph" l10n="NEW"> +<item type="input">=ODD(0)</item> returns 1.</paragraph> +<paragraph xml-lang="en-US" id="par_id5675527" role="paragraph" l10n="NEW"> +<item type="input">=ODD(-3.1)</item> returns -5.</paragraph><comment>see also CEILING, FLOOR, EVEN, MROUND, +INT, TRUNC, ROUND, ROUNDDOWN, ROUNDUP</comment> +</section> +<section id="Section9"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3157404"><bookmark_value>FLOOR function</bookmark_value> +<bookmark_value>rounding;down to nearest multiple of significance</bookmark_value> +</bookmark><comment>mw added one entry</comment> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_UNTERGRENZE" id="bm_id3157415" localize="false"/> +<paragraph xml-lang="en-US" id="hd_id3157404" role="heading" level="2" l10n="U" +oldref="512">FLOOR</paragraph> +<paragraph xml-lang="en-US" id="par_id3157432" role="paragraph" l10n="U" oldref="513"><ahelp hid="HID_FUNC_UNTERGRENZE">Rounds a number down to the nearest multiple of Significance.</ahelp></paragraph> +<paragraph xml-lang="en-US" id="hd_id3157451" role="heading" level="3" l10n="U" +oldref="514">Syntax</paragraph> +<paragraph xml-lang="en-US" id="par_id3157464" role="code" l10n="U" oldref="515">FLOOR(Number; Significance; Mode)</paragraph> +<paragraph xml-lang="en-US" id="par_id3157478" role="paragraph" l10n="U" oldref="516"><emph>Number</emph> is the number that is to be rounded down.</paragraph> +<paragraph xml-lang="en-US" id="par_id3157497" role="paragraph" l10n="U" oldref="517"><emph>Significance</emph> is the value to whose multiple the number is to be rounded down.</paragraph> +<paragraph xml-lang="en-US" id="par_id3157517" role="paragraph" l10n="CHG" oldref="561"><emph>Mode</emph> is an optional value. If the Mode value is given and not equal to zero, and if Number and Significance are negative, then rounding is done based on the absolute value of the number. This parameter is ignored when exporting to MS Excel as Excel does not know any third parameter.</paragraph> +<paragraph xml-lang="en-US" id="par_id3163894" role="warning" l10n="CHG" oldref="630">If both parameters Number and Significance are negative, and if the Mode value is equal to zero or is not specified, then the results in $[officename] Calc and Excel will differ after exporting. If you export the spreadsheet to Excel, use Mode=1 to see the same results in Excel as in Calc.</paragraph> +<paragraph xml-lang="en-US" id="hd_id3163932" role="heading" level="3" l10n="U" +oldref="518">Example</paragraph> +<paragraph xml-lang="en-US" id="par_id3163945" role="paragraph" l10n="CHG" oldref="519"> +<item type="input">=FLOOR( -11;-2)</item> returns -12</paragraph> +<paragraph xml-lang="en-US" id="par_id3163966" role="paragraph" l10n="CHG" oldref="520"> +<item type="input">=FLOOR( -11;-2;0)</item> returns -12</paragraph> +<paragraph xml-lang="en-US" id="par_id3163988" role="paragraph" l10n="CHG" oldref="521"> +<item type="input">=FLOOR( -11;-2;1)</item> returns -10</paragraph><comment>see also CEILING, EVEN, ODD, MROUND, +INT, TRUNC, ROUND, ROUNDDOWN, ROUNDUP, </comment> +</section> +<section id="Section8"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3164086"><bookmark_value>SIGN function</bookmark_value> +<bookmark_value>algebraic signs</bookmark_value> +</bookmark><comment>mw added one entry</comment> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_VORZEICHEN" id="bm_id3164098" localize="false"/> +<paragraph xml-lang="en-US" id="hd_id3164086" role="heading" level="2" l10n="U" +oldref="523">SIGN</paragraph> +<paragraph xml-lang="en-US" id="par_id3164115" role="paragraph" l10n="CHG" oldref="524"><ahelp hid="HID_FUNC_VORZEICHEN">Returns the sign of a number. Returns 1 if the number is positive, -1 if negative and 0 if zero.</ahelp></paragraph> +<paragraph xml-lang="en-US" id="hd_id3164136" role="heading" level="3" l10n="U" +oldref="525">Syntax</paragraph> +<paragraph xml-lang="en-US" id="par_id3164150" role="code" l10n="U" oldref="526">SIGN(Number)</paragraph> +<paragraph xml-lang="en-US" id="par_id3164164" role="paragraph" l10n="U" oldref="527"><emph>Number</emph> is the number whose sign is to be determined.</paragraph> +<paragraph xml-lang="en-US" id="hd_id3164183" role="heading" level="3" l10n="U" +oldref="528">Example</paragraph> +<paragraph xml-lang="en-US" id="par_id3164197" role="paragraph" l10n="CHG" oldref="529"> +<item type="input">=SIGN(3.4)</item> returns 1.</paragraph> +<paragraph xml-lang="en-US" id="par_id3164212" role="paragraph" l10n="CHG" oldref="530"> +<item type="input">=SIGN(-4.5)</item> returns -1.</paragraph><comment>see also ABS</comment> +</section> +<section id="Section7"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3164252"><bookmark_value>MROUND function</bookmark_value> +<bookmark_value>nearest multiple</bookmark_value> +</bookmark><comment>mw added one entry</comment> +<bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_MROUND" id="bm_id3164264" localize="false"/> +<paragraph xml-lang="en-US" id="hd_id3164252" role="heading" level="2" l10n="E" +oldref="658">MROUND</paragraph> +<paragraph xml-lang="en-US" id="par_id3164288" role="paragraph" l10n="CHG" oldref="659"><ahelp hid="HID_AAI_FUNC_MROUND">Returns a number rounded to the nearest multiple of another number.</ahelp></paragraph> +<paragraph xml-lang="en-US" id="hd_id3164306" role="heading" level="3" l10n="U" +oldref="660">Syntax</paragraph> +<paragraph xml-lang="en-US" id="par_id3164320" role="code" l10n="U" oldref="661">MROUND(Number; Multiple)</paragraph> +<paragraph xml-lang="en-US" id="par_id3486434" role="paragraph" l10n="NEW">Returns <emph>Number</emph> rounded to the nearest multiple of <emph>Multiple</emph>. </paragraph> +<paragraph xml-lang="en-US" id="par_id3068636" role="paragraph" l10n="NEW">An alternative implementation would be <item type="literal">Multiple * ROUND(Number/Multiple)</item>.</paragraph> +<paragraph xml-lang="en-US" id="hd_id3164333" role="heading" level="3" l10n="U" +oldref="662">Example</paragraph> +<paragraph xml-lang="en-US" id="par_id3164347" role="paragraph" l10n="CHG" oldref="663"> +<item type="input">=MROUND(15.5;3)</item> returns 15, as 15.5 is closer to 15 (= 3*5) than to 18 (= 3*6).</paragraph> +<paragraph xml-lang="en-US" id="par_idN14DD6" role="paragraph" l10n="CHG"> +<item type="input">=MROUND(1.4;0.5)</item> returns 1.5 (= 0.5*3).</paragraph><comment>see also CEILING, FLOOR, EVEN, ODD, +INT, TRUNC, ROUND, ROUNDDOWN, ROUNDUP</comment> +</section> +<section id="Section6"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3164375"><bookmark_value>SQRT function</bookmark_value> +<bookmark_value>square roots;positive numbers</bookmark_value> +</bookmark><comment>mw added one entry</comment> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_WURZEL" id="bm_id3164387" localize="false"/> +<paragraph xml-lang="en-US" id="hd_id3164375" role="heading" level="2" l10n="U" +oldref="532">SQRT</paragraph> +<paragraph xml-lang="en-US" id="par_id3164404" role="paragraph" l10n="CHG" oldref="533"><ahelp hid="HID_FUNC_WURZEL">Returns the positive square root of a number.</ahelp></paragraph> +<paragraph xml-lang="en-US" id="hd_id3164424" role="heading" level="3" l10n="U" +oldref="534">Syntax</paragraph> +<paragraph xml-lang="en-US" id="par_id3164437" role="code" l10n="U" oldref="535">SQRT(Number)</paragraph> +<paragraph xml-lang="en-US" id="par_id3164451" role="paragraph" l10n="CHG" oldref="536">Returns the positive square root of <emph>Number</emph>.</paragraph> +<paragraph xml-lang="en-US" id="par_id6870021" role="paragraph" l10n="NEW"> Number must be positive.</paragraph> +<paragraph xml-lang="en-US" id="hd_id3164471" role="heading" level="3" l10n="U" +oldref="537">Example</paragraph> +<paragraph xml-lang="en-US" id="par_id3164484" role="paragraph" l10n="CHG" oldref="538"> +<item type="input">=SQRT(16)</item> returns 4.</paragraph> +<paragraph xml-lang="en-US" id="par_id3591723" role="paragraph" l10n="NEW"> +<item type="input">=SQRT(-16)</item> returns an <item type="literal">invalid argument</item> error.</paragraph><comment>see also SQRTPI, POWER </comment> +</section> +<section id="Section5"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3164560"><bookmark_value>SQRTPI function</bookmark_value> +<bookmark_value>square roots;products of Pi</bookmark_value> +</bookmark><comment>mw added one entry</comment> +<bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_SQRTPI" id="bm_id3164572" localize="false"/> +<paragraph xml-lang="en-US" id="hd_id3164560" role="heading" level="2" l10n="E" +oldref="665">SQRTPI</paragraph> +<paragraph xml-lang="en-US" id="par_id3164596" role="paragraph" l10n="CHG" oldref="666"><ahelp hid="HID_AAI_FUNC_SQRTPI">Returns the square root of (PI times a number).</ahelp></paragraph> +<paragraph xml-lang="en-US" id="hd_id3164614" role="heading" level="3" l10n="U" +oldref="667">Syntax</paragraph> +<paragraph xml-lang="en-US" id="par_id3164627" role="code" l10n="U" oldref="668">SQRTPI(Number)</paragraph> +<paragraph xml-lang="en-US" id="par_id1501510" role="paragraph" l10n="NEW">Returns the positive square root of (PI multiplied by <emph>Number</emph>).</paragraph> +<paragraph xml-lang="en-US" id="par_id9929197" role="paragraph" l10n="NEW">This is equivalent to <item type="literal">SQRT(PI()*Number)</item>.</paragraph> +<paragraph xml-lang="en-US" id="hd_id3164641" role="heading" level="3" l10n="U" +oldref="669">Example</paragraph> +<paragraph xml-lang="en-US" id="par_id3164654" role="paragraph" l10n="CHG" oldref="670"> +<item type="input">=SQRTPI(2)</item> returns the squareroot of (2PI), approximately 2.506628.</paragraph><comment>see also SQRT</comment> +</section> +<section id="Section4"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3164669"><bookmark_value>random numbers; between limits</bookmark_value> +<bookmark_value>RANDBETWEEN function</bookmark_value> +</bookmark><comment>mw changed "random numbers;"</comment> +<bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_RANDBETWEEN" id="bm_id3164680" localize="false"/> +<paragraph xml-lang="en-US" id="hd_id3164669" role="heading" level="2" l10n="E" +oldref="671">RANDBETWEEN</paragraph> +<paragraph xml-lang="en-US" id="par_id3164711" role="paragraph" l10n="CHG" oldref="672"><ahelp hid="HID_AAI_FUNC_RANDBETWEEN">Returns an integer random number in a specified range.</ahelp></paragraph> +<paragraph xml-lang="en-US" id="hd_id3164745" role="heading" level="3" l10n="U" +oldref="673">Syntax</paragraph> +<paragraph xml-lang="en-US" id="par_id3164758" role="code" l10n="U" oldref="674">RANDBETWEEN(Bottom; Top)</paragraph> +<paragraph xml-lang="en-US" id="par_id7112338" role="paragraph" l10n="NEW">Returns an integer random number between integers <emph>Bottom</emph> and <emph>Top</emph> (both inclusive).</paragraph> +<paragraph xml-lang="en-US" id="par_id2855616" role="paragraph" l10n="NEW">This function produces a new random number each time Calc recalculates. To force Calc to recalculate manually press Shift+<switchinline select="sys"><caseinline select="MAC">Command +</caseinline><defaultinline>Ctrl</defaultinline></switchinline>+F9.</paragraph> +<paragraph xml-lang="en-US" id="par_id2091433" role="paragraph" l10n="NEW">To generate random numbers which never recalculate, copy cells containing this function, and use <item type="menuitem">Edit - Paste Special</item> (with <item type="menuitem">Paste All</item> and <item type="menuitem">Formulas</item> not marked and <item type="menuitem">Numbers</item> marked).</paragraph> +<paragraph xml-lang="en-US" id="hd_id3164772" role="heading" level="3" l10n="U" +oldref="675">Example</paragraph> +<paragraph xml-lang="en-US" id="par_id3164785" role="paragraph" l10n="U" oldref="676"> +<item type="input">=RANDBETWEEN(20;30)</item> returns an integer of between 20 and 30.</paragraph><comment>see also RAND</comment> +</section> +<section id="Section3"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3164800"><bookmark_value>RAND function</bookmark_value> +<bookmark_value>random numbers;between 0 and 1</bookmark_value> +</bookmark><comment>mw added one entry</comment> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_ZUFALLSZAHL" id="bm_id3164812" localize="false"/> +<paragraph xml-lang="en-US" id="hd_id3164800" role="heading" level="2" l10n="U" +oldref="542">RAND</paragraph> +<paragraph xml-lang="en-US" id="par_id3164829" role="paragraph" l10n="CHG" oldref="543"><ahelp hid="HID_FUNC_ZUFALLSZAHL">Returns a random number between 0 and 1.</ahelp><comment>The value of 0 can be returned, the value of 1 not.</comment><comment>this is really true after issue 53642 will be fixed</comment></paragraph> +<paragraph xml-lang="en-US" id="hd_id3164870" role="heading" level="3" l10n="U" +oldref="545">Syntax</paragraph> +<paragraph xml-lang="en-US" id="par_id3164884" role="code" l10n="U" oldref="546">RAND()</paragraph> +<paragraph xml-lang="en-US" id="par_id5092318" role="paragraph" l10n="NEW">This function produces a new random number each time Calc recalculates. To force Calc to recalculate manually press Shift+<switchinline select="sys"><caseinline select="MAC">Command +</caseinline><defaultinline>Ctrl</defaultinline></switchinline>+F9.</paragraph> +<paragraph xml-lang="en-US" id="par_id9312417" role="paragraph" l10n="NEW">To generate random numbers which never recalculate, copy cells each containing =RAND(), and use <item type="menuitem">Edit - Paste Special</item> (with <item type="menuitem">Paste All</item> and <item type="menuitem">Formulas</item> not marked and <item type="menuitem">Numbers</item> marked).</paragraph> +<paragraph xml-lang="en-US" id="hd_id9089022" role="heading" level="3" l10n="NEW">Example</paragraph> +<paragraph xml-lang="en-US" id="par_id9569078" role="paragraph" l10n="NEW"> +<item type="input">=RAND()</item> returns a random number between 0 and 1.</paragraph><comment>see also RANDBETWEEN +</comment> +</section> +<section id="Section2"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3164897"><bookmark_value>COUNTIF function</bookmark_value> +<bookmark_value>counting;specified cells</bookmark_value> +</bookmark><comment>mw added one entry</comment> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_ZAEHLENWENN" id="bm_id3164909" localize="false"/> +<paragraph xml-lang="en-US" id="hd_id3164897" role="heading" level="2" l10n="U" +oldref="547">COUNTIF</paragraph> +<paragraph xml-lang="en-US" id="par_id3164926" role="paragraph" l10n="CHG" oldref="548"><ahelp hid="HID_FUNC_ZAEHLENWENN">Returns the number of cells that meet with certain criteria within a cell range.</ahelp></paragraph> +<embed href="text/shared/00/00000001.xhp#regulaer"/> +<paragraph xml-lang="en-US" id="hd_id3164953" role="heading" level="3" l10n="U" +oldref="549">Syntax</paragraph> +<paragraph xml-lang="en-US" id="par_id3164967" role="code" l10n="U" oldref="550">COUNTIF(Range; Criteria)</paragraph> +<paragraph xml-lang="en-US" id="par_id3164980" role="paragraph" l10n="U" oldref="551"><emph>Range</emph> is the range to which the criteria are to be applied.</paragraph> +<paragraph xml-lang="en-US" id="par_id3165000" role="paragraph" l10n="CHG" oldref="552"><emph>Criteria</emph> indicates the criteria in the form of a number, an expression or a character string. These criteria determine which cells are counted. You may also enter a search text in the form of a regular expression, e.g. b.* for all words that begin with b. You may also indicate a cell range that contains the search criterion. If you search for literal text, enclose the text in double quotes.</paragraph> +<paragraph xml-lang="en-US" id="hd_id3165037" role="heading" level="3" l10n="U" +oldref="553">Example</paragraph> +<paragraph xml-lang="en-US" id="par_id3166505" role="paragraph" l10n="CHG" oldref="627">A1:A10 is a cell range containing the numbers <item type="input">2000</item> to <item type="input">2009</item>. Cell B1 contains the number <item type="input">2006</item>. In cell B2, you enter a formula:</paragraph> +<paragraph xml-lang="en-US" id="par_id3581652" role="paragraph" l10n="NEW"> +<item type="input">=COUNTIF(A1:A10;2006)</item> - this returns 1</paragraph> +<paragraph xml-lang="en-US" id="par_id708639" role="paragraph" l10n="NEW"> +<item type="input">=COUNTIF(A1:A10;B1)</item> - this returns 1</paragraph> +<paragraph xml-lang="en-US" id="par_id5169225" role="paragraph" l10n="NEW"> +<item type="input">=COUNTIF(A1:A10;">=2006") </item>- this returns 4</paragraph> +<paragraph xml-lang="en-US" id="par_id2118594" role="paragraph" l10n="NEW"> +<item type="input">=COUNTIF(A1:A10;"<"&B1)</item> - when B1 contains <item type="input">2006</item>, this returns 6</paragraph> +<paragraph xml-lang="en-US" id="par_id166020" role="paragraph" l10n="NEW"> +<item type="input">=COUNTIF(A1:A10;C2)</item> where cell C2 contains the text <item type="input">>2006</item> counts the number of cells in the range A1:A10 which are >2006 </paragraph> +<paragraph xml-lang="en-US" id="par_id6386913" role="paragraph" l10n="NEW">To count only negative numbers: <item type="input">=COUNTIF(A1:A10;"<0")</item> +</paragraph> +</section> +</sort> +<section id="relatedtopics"> +<embed href="text/scalc/01/04060100.xhp#drking"/> +</section> +</body> +</helpdocument>
\ No newline at end of file diff --git a/source/text/scalc/01/04060107.xhp b/source/text/scalc/01/04060107.xhp new file mode 100644 index 0000000000..ab6a0cb261 --- /dev/null +++ b/source/text/scalc/01/04060107.xhp @@ -0,0 +1,1280 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> + +<!-- +*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************ + --> + + +<meta> +<topic id="textscalc0104060107xml" indexer="include"> +<title id="tit" xml-lang="en-US">Array Functions</title> +<filename>/text/scalc/01/04060107.xhp</filename> +</topic> +</meta> +<body> +<bookmark xml-lang="en-US" branch="index" id="bm_id3147273"><bookmark_value>matrices; functions</bookmark_value> +<bookmark_value>Function Wizard; arrays</bookmark_value> +<bookmark_value>array formulas</bookmark_value> +<bookmark_value>inline array constants</bookmark_value> +<bookmark_value>formulas;arrays</bookmark_value> +<bookmark_value>functions;array functions</bookmark_value> +<bookmark_value>editing; array formulas</bookmark_value> +<bookmark_value>copying; array formulas</bookmark_value> +<bookmark_value>adjusting array ranges</bookmark_value> +<bookmark_value>calculating;conditional calculations</bookmark_value> +<bookmark_value>matrices; calculations</bookmark_value> +<bookmark_value>conditional calculations with arrays</bookmark_value> +<bookmark_value>implicit array handling</bookmark_value> +<bookmark_value>forced array handling</bookmark_value> +</bookmark><comment>mw deleted "creating;"</comment> +<paragraph role="heading" id="hd_id3147273" xml-lang="en-US" level="1" l10n="U" oldref="1">Array Functions</paragraph> +<paragraph role="paragraph" id="par_id3154744" xml-lang="en-US" l10n="U" oldref="2"><variable id="matrixtext">This category contains the array functions. +</variable></paragraph> +<paragraph role="heading" id="hd_id3146084" xml-lang="en-US" level="2" l10n="U" oldref="257">What is an Array?</paragraph> +<paragraph role="paragraph" id="par_id3154298" xml-lang="en-US" l10n="U" oldref="258"><variable id="wasmatrix">An array is a linked range of cells on a spreadsheet containing values. +</variable> A square range of 3 rows and 3 columns is a 3 x 3 array:</paragraph> +<table id="tbl_id3151168"> +<tablerow> +<tablecell> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3154692" xml-lang="en-US" l10n="U" oldref="260">A</paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3150117" xml-lang="en-US" l10n="U" oldref="261">B</paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3155325" xml-lang="en-US" l10n="U" oldref="262">C</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph role="paragraph" id="par_id3153104" xml-lang="en-US" l10n="U" oldref="263">1</paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3146996" xml-lang="en-US" l10n="U" oldref="264"> +<item type="input">7</item> +</paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3150529" xml-lang="en-US" l10n="U" oldref="265"> +<item type="input">31</item> +</paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3148831" xml-lang="en-US" l10n="U" oldref="266"> +<item type="input">33</item> +</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph role="paragraph" id="par_id3148943" xml-lang="en-US" l10n="U" oldref="267">2</paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3149771" xml-lang="en-US" l10n="U" oldref="268"> +<item type="input">95</item> +</paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3158407" xml-lang="en-US" l10n="U" oldref="269"> +<item type="input">17</item> +</paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3148806" xml-lang="en-US" l10n="U" oldref="270"> +<item type="input">2</item> +</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph role="paragraph" id="par_id3154904" xml-lang="en-US" l10n="U" oldref="271">3</paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3150779" xml-lang="en-US" l10n="U" oldref="272"> +<item type="input">5</item> +</paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3148449" xml-lang="en-US" l10n="U" oldref="273"> +<item type="input">10</item> +</paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3147238" xml-lang="en-US" l10n="U" oldref="274"> +<item type="input">50</item> +</paragraph> +</tablecell> +</tablerow> +</table> + +<paragraph role="paragraph" id="par_id3153583" xml-lang="en-US" l10n="U" oldref="277">The smallest possible array is a 1 x 2 or 2 x 1 array with two adjacent cells.</paragraph> +<paragraph role="heading" id="hd_id3148474" xml-lang="en-US" level="2" l10n="U" oldref="275">What is an array formula?</paragraph> +<paragraph role="paragraph" id="par_id3155355" xml-lang="en-US" l10n="U" oldref="276">A formula in which the individual values in a cell range are evaluated is referred to as an array formula. The difference between an array formula and other formulas is that the array formula deals with several values simultaneously instead of just one.</paragraph> +<paragraph role="paragraph" id="par_id3151052" xml-lang="en-US" l10n="U" oldref="278">Not only can an array formula process several values, but it can also return several values. The results of an array formula is also an array.</paragraph> +<paragraph role="paragraph" id="par_id3158432" xml-lang="en-US" l10n="U" oldref="279">To multiply the values in the individual cells by 10 in the above array, you do not need to apply a formula to each individual cell or value. Instead you just need to use a single array formula. Select a range of 3 x 3 cells on another part of the spreadsheet, enter the formula <item type="input">=10*A1:C3</item> and confirm this entry using the key combination <switchinline select="sys"><caseinline select="MAC">Command</caseinline><defaultinline>Ctrl</defaultinline></switchinline>+Shift+Enter. The result is a 3 x 3 array in which the individual values in the cell range (A1:C3) are multiplied by a factor of 10.</paragraph> +<paragraph role="paragraph" id="par_id3149156" xml-lang="en-US" l10n="U" oldref="280">In addition to multiplication, you can also use other operators on the reference range (an array). With $[officename] Calc, you can add (+), subtract (-), multiply (*), divide (/), use exponents (^), concatenation (&) and comparisons (=, <>, <, >, <=, >=). The operators can be used on each individual value in the cell range and return the result as an array if the array formula was entered.</paragraph> +<paragraph role="paragraph" id="par_id3166456" xml-lang="en-US" l10n="CHG" oldref="326">Comparison operators in an array formula treat empty cells in the same way as in a normal formula, that is, either as zero or as an empty string. For example, if cells A1 and A2 are empty the array formulas <item type="input">{=A1:A2=""}</item> and <item type="input">{=A1:A2=0}</item> will both return a 1 column 2 row array of cells containing TRUE.</paragraph> +<paragraph role="heading" id="hd_id3150713" xml-lang="en-US" level="3" l10n="U" oldref="281">When do you use array formulas?</paragraph> +<paragraph role="paragraph" id="par_id3149787" xml-lang="en-US" l10n="U" oldref="282">Use array formulas if you have to repeat calculations using different values. If you decide to change the calculation method later, you only have to update the array formula. To add an array formula, select the entire array range and then <link href="text/scalc/01/04060107.xhp" name="make the required change to the array formula">make the required change to the array formula</link>.</paragraph> +<paragraph role="paragraph" id="par_id3149798" xml-lang="en-US" l10n="U" oldref="283">Array formulas are also a space saving option when several values must be calculated, since they are not very memory-intensive. In addition, arrays are an essential tool for carrying out complex calculations, because you can have several cell ranges included in your calculations. $[officename] has different math functions for arrays, such as the MMULT function for multiplying two arrays or the SUMPRODUCT function for calculating the scalar products of two arrays.</paragraph> +<paragraph role="heading" id="hd_id3155588" xml-lang="en-US" level="2" l10n="U" oldref="284">Using Array Formulas in $[officename] Calc</paragraph> +<paragraph role="paragraph" id="par_id3152876" xml-lang="en-US" l10n="U" oldref="285">You can also create a "normal" formula in which the reference range, such as parameters, indicate an array formula. The result is obtained from the intersection of the reference range and the rows or columns in which the formula is found. If there is no intersection or if the range at the intersection covers several rows or columns, a #VALUE! error message appears. The following example illustrates this concept:</paragraph> +<paragraph role="heading" id="hd_id3151271" xml-lang="en-US" level="3" l10n="U" oldref="313">Creating Array Formulas</paragraph> +<section id="somatrixformel"> +<paragraph role="paragraph" id="par_id3149102" xml-lang="en-US" l10n="U" oldref="314">If you create an array formula using the <emph>Function Wizard</emph>, you must mark the <emph>Array</emph> check box each time so that the results are returned in an array. Otherwise, only the value in the upper-left cell of the array being calculated is returned.</paragraph> +<paragraph role="paragraph" id="par_id3153392" xml-lang="en-US" l10n="U" oldref="4">If you enter the array formula directly into the cell, you must use the key combination Shift+<switchinline select="sys"><caseinline select="MAC">Command</caseinline><defaultinline>Ctrl</defaultinline></switchinline>+Enter instead of the Enter key. Only then does the formula become an array formula.</paragraph> +<paragraph role="note" id="par_id3151120" xml-lang="en-US" l10n="U" oldref="315">Array formulas appear in braces in $[officename] Calc. You cannot create array formulas by manually entering the braces.</paragraph> +</section> +<paragraph role="paragraph" id="par_id3154342" xml-lang="en-US" l10n="U" oldref="5">The cells in a results array are automatically protected against changes. However, you can edit or copy the array formula by selecting the entire array cell range.</paragraph> +<paragraph role="heading" id="hd_id8834803" xml-lang="en-US" level="3" l10n="NEW">Using Inline Array Constants in Formulas</paragraph> +<paragraph role="paragraph" id="par_id985747" xml-lang="en-US" l10n="NEW">Calc supports inline matrix/array constants in formulas. An inline array is surrounded by curly braces '{' and '}'. Elements can be each a number (including negatives), a logical constant (TRUE, FALSE), or a literal string. Non-constant expressions are not allowed. Arrays can be entered with one or more rows, and one or more columns. All rows must consist of the same number of elements, all columns must consist of the same number of elements. </paragraph> +<paragraph role="paragraph" id="par_id936613" xml-lang="en-US" l10n="NEW">The column separator (separating elements in one row) and the row separator are language and locale dependent. But in this help content, the ';' semicolon and '|' pipe symbol are used to indicate the column and row separators, respectively. For example, in the English locale, the ',' comma is used as the column separator, while the ';' semicolon is used as the row separator.</paragraph> +<paragraph role="paragraph" id="par_id1877498" xml-lang="en-US" l10n="NEW">Arrays can not be nested.</paragraph> +<paragraph role="paragraph" id="par_id4262520" xml-lang="en-US" l10n="NEW"> +<emph>Examples:</emph> +</paragraph> +<paragraph role="code" id="par_id9387493" xml-lang="en-US" l10n="NEW">={1;2;3}</paragraph> +<paragraph role="paragraph" id="par_id8207037" xml-lang="en-US" l10n="NEW">An array with one row consisting of the three numbers 1, 2, and 3.</paragraph> +<paragraph role="paragraph" id="par_id6757103" xml-lang="en-US" l10n="NEW">To enter this array constant, you select three cells in a row, then you type the formula <item type="input">={1;2;3}</item> using the curly braces and the semicolons, then press <switchinline select="sys"><caseinline select="MAC">Command</caseinline><defaultinline>Ctrl</defaultinline></switchinline>+Shift+Enter.</paragraph> +<paragraph role="code" id="par_id8868068" xml-lang="en-US" l10n="NEW">={1;2;3|4;5;6}</paragraph> +<paragraph role="paragraph" id="par_id6626483" xml-lang="en-US" l10n="NEW">An array with two rows and three values in each row.</paragraph> +<paragraph role="code" id="par_id5262916" xml-lang="en-US" l10n="NEW">={0;1;2|FALSE;TRUE;"two"}</paragraph> +<paragraph role="paragraph" id="par_id1623889" xml-lang="en-US" l10n="NEW">A mixed data array.</paragraph> +<paragraph role="code" id="par_id7781914" xml-lang="en-US" l10n="NEW">=SIN({1;2;3})</paragraph> +<paragraph role="paragraph" id="par_id300912" xml-lang="en-US" l10n="NEW">Entered as a matrix formula, delivers the result of three SIN calculations with the arguments 1, 2, and 3.</paragraph> +<paragraph role="heading" id="hd_id3148660" xml-lang="en-US" level="3" l10n="U" oldref="316">Editing Array Formulas</paragraph> +<list type="ordered"> +<listitem> +<paragraph role="listitem" id="par_id3149241" xml-lang="en-US" l10n="U" oldref="317">Select the cell range or array containing the array formula. To select the whole array, position the cell cursor inside the array range, then press <switchinline select="sys"><caseinline select="MAC">Command</caseinline><defaultinline>Ctrl</defaultinline></switchinline>+/, where / is the Division key on the numeric keypad.</paragraph> +</listitem> +<listitem> +<paragraph role="listitem" id="par_id3143274" xml-lang="en-US" l10n="U" oldref="318">Either press F2 or position the cursor in the input line. Both of these actions let you edit the formula.</paragraph> +</listitem> +<listitem> +<paragraph role="listitem" id="par_id3154798" xml-lang="en-US" l10n="U" oldref="319">After you have made changes, press <switchinline select="sys"><caseinline select="MAC">Command</caseinline><defaultinline>Ctrl</defaultinline></switchinline>+Shift+Enter.</paragraph> +</listitem> +</list> +<paragraph role="tip" id="par_id3150628" xml-lang="en-US" l10n="U" oldref="334">You can format the separate parts of an array. For example, you can change the font color. Select a cell range and then change the attribute you want.</paragraph> +<paragraph role="heading" id="hd_id3145608" xml-lang="en-US" level="3" l10n="U" oldref="320">Copying Array Formulas</paragraph> +<list type="ordered"> +<listitem> +<paragraph role="listitem" id="par_id3149585" xml-lang="en-US" l10n="U" oldref="321">Select the cell range or array containing the array formula.</paragraph> +</listitem> +<listitem> +<paragraph role="listitem" id="par_id3154619" xml-lang="en-US" l10n="U" oldref="322">Either press F2 or position the cursor in the input line.</paragraph> +</listitem> +<listitem> +<paragraph role="listitem" id="par_id3150994" xml-lang="en-US" l10n="U" oldref="323">Copy the formula into the input line by pressing <switchinline select="sys"><caseinline select="MAC">Command</caseinline><defaultinline>Ctrl</defaultinline></switchinline>+C.</paragraph> +</listitem> +<listitem> +<paragraph role="listitem" id="par_id3146787" xml-lang="en-US" l10n="U" oldref="324">Select a range of cells where you want to insert the array formula and either press F2 or position the cursor in the input line.</paragraph> +</listitem> +<listitem> +<paragraph role="listitem" id="par_id3154419" xml-lang="en-US" l10n="U" oldref="325">Paste the formula by pressing <switchinline select="sys"><caseinline select="MAC">Command</caseinline><defaultinline>Ctrl</defaultinline></switchinline>+V in the selected space and confirm it by pressing <switchinline select="sys"><caseinline select="MAC">Command</caseinline><defaultinline>Ctrl</defaultinline></switchinline>+Shift+Enter. The selected range now contains the array formula.</paragraph> +</listitem> +</list> +<paragraph role="heading" id="hd_id3154834" xml-lang="en-US" level="3" l10n="U" oldref="328">Adjusting an Array Range</paragraph> +<paragraph role="paragraph" id="par_id3148679" xml-lang="en-US" l10n="U" oldref="329">If you want to edit the output array, do the following:</paragraph> +<list type="ordered"> +<listitem> +<paragraph role="listitem" id="par_id3151102" xml-lang="en-US" l10n="U" oldref="330">Select the cell range or array containing the array formula.</paragraph> +</listitem> +<listitem> +<paragraph role="listitem" id="par_id3147096" xml-lang="en-US" l10n="U" oldref="331">Below the selection, to the right, you will see a small icon with which you can zoom in or out on the range using your mouse.</paragraph> +</listitem> +</list> +<paragraph role="note" id="par_id3150974" xml-lang="en-US" l10n="U" oldref="332">When you adjust the array range, the array formula will not automatically be adjusted. You are only changing the range in which the result will appear.</paragraph> +<paragraph role="paragraph" id="par_id3146080" xml-lang="en-US" l10n="U" oldref="333">By holding down the <switchinline select="sys"><caseinline select="MAC">Command</caseinline><defaultinline>Ctrl</defaultinline></switchinline> key, you can create a copy of the array formula in the given range.</paragraph> +<paragraph role="heading" id="par_idN10D47" xml-lang="en-US" level="3" l10n="NEW">Conditional Array Calculations</paragraph> +<paragraph role="paragraph" id="par_idN10D4B" xml-lang="en-US" l10n="NEW">A conditional array calculation is an array or matrix formula that includes an IF() or CHOOSE() function. The condition argument in the formula is an area reference or a matrix result.</paragraph> +<paragraph role="paragraph" id="par_idN10D4E" xml-lang="en-US" l10n="NEW">In the following example, the >0 test of the {=IF(A1:A3>0;"yes";"no")} formula is applied to each cell in the range A1:A3 and the result is copied to the corresponding cell.</paragraph> +<table id="tbl_id2511673"> +<tablerow> +<tablecell> +</tablecell> +<tablecell> +<paragraph role="tablehead" id="par_idN10D65" xml-lang="en-US" l10n="NEW">A</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablehead" id="par_idN10D6B" xml-lang="en-US" l10n="NEW">B (formula)</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablehead" id="par_idN10B75" xml-lang="en-US" l10n="NEW">B (result)</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph role="tablehead" id="par_idN10D79" xml-lang="en-US" l10n="NEW">1</paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_idN10D80" xml-lang="en-US" l10n="NEW">1</paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_idN10D86" xml-lang="en-US" l10n="NEW">{=IF(A1:A3>0;"yes";"no")}</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablecontent" id="par_idN10D8C" xml-lang="en-US" l10n="NEW">yes</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph role="tablehead" id="par_idN10D94" xml-lang="en-US" l10n="NEW">2</paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_idN10D9B" xml-lang="en-US" l10n="NEW">0</paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_idN10DA1" xml-lang="en-US" l10n="NEW">{=IF(A1:A3>0;"yes";"no")}</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablecontent" id="par_idN10DA7" xml-lang="en-US" l10n="NEW">no</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph role="tablehead" id="par_idN10DAF" xml-lang="en-US" l10n="NEW">3</paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_idN10DB6" xml-lang="en-US" l10n="NEW">1</paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_idN10DBC" xml-lang="en-US" l10n="NEW">{=IF(A1:A3>0;"yes";"no")}</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablecontent" id="par_idN10DC2" xml-lang="en-US" l10n="NEW">yes</paragraph> +</tablecell> +</tablerow> +</table> + +<paragraph role="paragraph" id="par_idN10DD0" xml-lang="en-US" l10n="NEW">The following functions provide forced array handling: CORREL, COVAR, FORECAST, FTEST, INTERCEPT, MDETERM, MINVERSE, MMULT, MODE, PEARSON, PROB, RSQ, SLOPE, STEYX, SUMPRODUCT, SUMX2MY2, SUMX2PY2, SUMXMY2, TTEST. If you use area references as arguments when you call one of these functions, the functions behave as array functions. The following table provides an example of forced array handling:</paragraph> +<table id="tbl_id7380291"> +<tablerow> +<tablecell> +</tablecell> +<tablecell> +<paragraph role="tablehead" id="par_idN10DE2" xml-lang="en-US" l10n="NEW">A</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablehead" id="par_idN10DE8" xml-lang="en-US" l10n="NEW">B (formula)</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablehead" id="par_idN10DEE" xml-lang="en-US" l10n="NEW">B (result)</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablehead" id="par_idN10DF4" xml-lang="en-US" l10n="NEW">C (forced array formula)</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablehead" id="par_idN10DFA" xml-lang="en-US" l10n="NEW">C (result)</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph role="tablehead" id="par_idN10E02" xml-lang="en-US" l10n="NEW">1</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablecontent" id="par_idN10E09" xml-lang="en-US" l10n="NEW">1</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablecontent" id="par_idN10E0F" xml-lang="en-US" l10n="NEW">=A1:A2+1</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablecontent" id="par_idN10E17" xml-lang="en-US" l10n="NEW">2</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablecontent" id="par_idN10E1D" xml-lang="en-US" l10n="NEW">=SUMPRODUCT(A1:A2+1)</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablecontent" id="par_idN10E25" xml-lang="en-US" l10n="NEW">5</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph role="tablehead" id="par_idN10E2D" xml-lang="en-US" l10n="NEW">2</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablecontent" id="par_idN10E34" xml-lang="en-US" l10n="NEW">2</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablecontent" id="par_idN10E3A" xml-lang="en-US" l10n="NEW">=A1:A2+1</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablecontent" id="par_idN10E42" xml-lang="en-US" l10n="NEW">3</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablecontent" id="par_idN10E48" xml-lang="en-US" l10n="NEW">=SUMPRODUCT(A1:A2+1)</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablecontent" id="par_idN10E50" xml-lang="en-US" l10n="NEW">5</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph role="tablehead" id="par_idN10E58" xml-lang="en-US" l10n="NEW">3</paragraph> +</tablecell> +<tablecell> +</tablecell> +<tablecell> +<paragraph role="tablecontent" id="par_idN10E63" xml-lang="en-US" l10n="NEW">=A1:A2+1</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablecontent" id="par_idN10E6A" xml-lang="en-US" l10n="NEW">#VALUE!</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablecontent" id="par_idN10E70" xml-lang="en-US" l10n="NEW">=SUMPRODUCT(A1:A2+1)</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablecontent" id="par_idN10E78" xml-lang="en-US" l10n="NEW">5</paragraph> +</tablecell> +</tablerow> +</table> + +<sort> +<section id="Section14"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3158446"><bookmark_value>MUNIT function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_EINHEITSMATRIX" id="bm_id3151317" localize="false"/> +<paragraph role="heading" id="hd_id3158446" xml-lang="en-US" level="2" l10n="U" oldref="12">MUNIT</paragraph> +<paragraph role="paragraph" id="par_id3154121" xml-lang="en-US" l10n="U" oldref="13"><ahelp hid="HID_FUNC_EINHEITSMATRIX">Returns the unitary square array of a certain size.</ahelp> The unitary array is a square array where the main diagonal elements equal 1 and all other array elements are equal to 0.</paragraph> +<paragraph role="heading" id="hd_id3155123" xml-lang="en-US" level="3" l10n="U" oldref="14">Syntax</paragraph> +<paragraph role="code" id="par_id3156271" xml-lang="en-US" l10n="U" oldref="15">MUNIT(Dimensions)</paragraph> +<paragraph role="paragraph" id="par_id3159390" xml-lang="en-US" l10n="U" oldref="16"> +<emph>Dimensions</emph> refers to the size of the array unit.</paragraph> +<paragraph role="note" id="par_idN10C9B" xml-lang="en-US" l10n="NEW">You can find a general introduction to Array functions at the top of this page.</paragraph> +<paragraph role="heading" id="hd_id3156162" xml-lang="en-US" level="3" l10n="U" oldref="17">Example</paragraph> +<paragraph role="paragraph" id="par_id3150949" xml-lang="en-US" l10n="U" oldref="18">Select a square range within the spreadsheet, for example, from A1 to E5.</paragraph> +<paragraph role="paragraph" id="par_id3151260" xml-lang="en-US" l10n="U" oldref="19">Without deselecting the range, select the MUNIT function. Mark the <emph>Array</emph> check box. Enter the desired dimensions for the array unit, in this case <item type="input">5</item>, and click <emph>OK</emph>.</paragraph> +<paragraph role="paragraph" id="par_id3150403" xml-lang="en-US" l10n="U" oldref="20">You can also enter the <item type="input">=Munit(5)</item> formula in the last cell of the selected range (E5), and press <switchinline select="sys"><caseinline select="MAC">Shift+Command+Enter</caseinline><defaultinline>Shift+Ctrl+Enter</defaultinline></switchinline>.</paragraph> +<paragraph role="paragraph" id="par_id3156143" xml-lang="en-US" l10n="U" oldref="21">You now see a unit array with a range of A1:E5.</paragraph> +<paragraph role="paragraph" id="par_idN10FA7" xml-lang="en-US" l10n="NEW"> +<embedvar href="text/scalc/00/00000004.xhp#moreontop"/> +</paragraph> +</section> +<section id="Section13"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3159084"><bookmark_value>FREQUENCY function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_HAEUFIGKEIT" id="bm_id3153883" localize="false"/> +<paragraph role="heading" id="hd_id3159084" xml-lang="en-US" level="2" l10n="U" oldref="22">FREQUENCY</paragraph> +<paragraph role="paragraph" id="par_id3145777" xml-lang="en-US" l10n="CHG" oldref="23"><ahelp hid="HID_FUNC_HAEUFIGKEIT">Indicates the frequency distribution in a one-column-array.</ahelp> The function counts the number of values in the Data array that are within the values given by the Classes array.</paragraph> +<paragraph role="heading" id="hd_id3153347" xml-lang="en-US" level="3" l10n="U" oldref="24">Syntax</paragraph> +<paragraph role="code" id="par_id3155498" xml-lang="en-US" l10n="U" oldref="25">FREQUENCY(Data; Classes)</paragraph> +<paragraph role="paragraph" id="par_id3154352" xml-lang="en-US" l10n="CHG" oldref="26"> +<emph>Data</emph> represents the reference to the values to be counted.</paragraph> +<paragraph role="paragraph" id="par_id3148402" xml-lang="en-US" l10n="CHG" oldref="27"> +<emph>Classes</emph> represents the array of the limit values.</paragraph> +<paragraph role="note" id="par_idN10D71" xml-lang="en-US" l10n="NEW">You can find a general introduction to Array functions at the top of this page.</paragraph> +<paragraph role="heading" id="hd_id3148981" xml-lang="en-US" level="3" l10n="U" oldref="28">Example</paragraph> +<paragraph role="paragraph" id="par_id3155904" xml-lang="en-US" l10n="CHG" oldref="219">In the following table, column A lists unsorted measurement values. Column B contains the upper limit you entered for the classes into which you want to divide the data in column A. According to the limit entered in B1, the FREQUENCY function returns the number of measured values less than or equal to 5. As the limit in B2 is 10, the FREQUENCY function returns the second result as the number of measured values that are greater than 5 and less than or equal to 10. The text you entered in B6, ">25", is only for reference purposes.<comment>i77461: replace old text: As the limit in B2 is 10, the FREQUENCY function returns the second result as the number of measured values that are greater than 5 or greater than or equal to 10.</comment></paragraph><comment>UFI: replace table by picture</comment> +<table id="tbl_id3150680"> +<tablerow> +<tablecell> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3155869" xml-lang="en-US" l10n="U" oldref="220"> +<emph>A</emph> +</paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3149328" xml-lang="en-US" l10n="U" oldref="221"> +<emph>B</emph> +</paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3152467" xml-lang="en-US" l10n="U" oldref="222"> +<emph>C</emph> +</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph role="paragraph" id="par_id3154528" xml-lang="en-US" l10n="U" oldref="223"> +<emph>1</emph> +</paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3149744" xml-lang="en-US" l10n="U" oldref="224">12</paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3147309" xml-lang="en-US" l10n="U" oldref="225">5</paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3154199" xml-lang="en-US" l10n="U" oldref="226">1</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph role="paragraph" id="par_id3159218" xml-lang="en-US" l10n="U" oldref="227"> +<emph>2</emph> +</paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3153263" xml-lang="en-US" l10n="U" oldref="228">8</paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3156201" xml-lang="en-US" l10n="U" oldref="229">10</paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3147552" xml-lang="en-US" l10n="U" oldref="230">3</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph role="paragraph" id="par_id3149174" xml-lang="en-US" l10n="U" oldref="231"> +<emph>3</emph> +</paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3151201" xml-lang="en-US" l10n="U" oldref="232">24</paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3150245" xml-lang="en-US" l10n="U" oldref="233">15</paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3159194" xml-lang="en-US" l10n="U" oldref="234">2</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph role="paragraph" id="par_id3146925" xml-lang="en-US" l10n="U" oldref="235"> +<emph>4</emph> +</paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3154128" xml-lang="en-US" l10n="U" oldref="236">11</paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3151067" xml-lang="en-US" l10n="U" oldref="237">20</paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3156033" xml-lang="en-US" l10n="U" oldref="238">3</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph role="paragraph" id="par_id3149298" xml-lang="en-US" l10n="U" oldref="239"> +<emph>5</emph> +</paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3151382" xml-lang="en-US" l10n="U" oldref="240">5</paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3155141" xml-lang="en-US" l10n="U" oldref="241">25</paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3145213" xml-lang="en-US" l10n="U" oldref="242">1</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph role="paragraph" id="par_id3145268" xml-lang="en-US" l10n="U" oldref="243"> +<emph>6</emph> +</paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3163724" xml-lang="en-US" l10n="U" oldref="244">20</paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3147132" xml-lang="en-US" l10n="U" oldref="245">>25</paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3148903" xml-lang="en-US" l10n="U" oldref="246">1</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph role="paragraph" id="par_id3151007" xml-lang="en-US" l10n="U" oldref="247"> +<emph>7</emph> +</paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3153294" xml-lang="en-US" l10n="U" oldref="248">16</paragraph> +</tablecell> +<tablecell> +</tablecell> +<tablecell> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph role="paragraph" id="par_id3147284" xml-lang="en-US" l10n="U" oldref="249"> +<emph>8</emph> +</paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3154914" xml-lang="en-US" l10n="U" oldref="250">9</paragraph> +</tablecell> +<tablecell> +</tablecell> +<tablecell> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph role="paragraph" id="par_id3154218" xml-lang="en-US" l10n="U" oldref="251"> +<emph>9</emph> +</paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3147226" xml-lang="en-US" l10n="U" oldref="252">7</paragraph> +</tablecell> +<tablecell> +</tablecell> +<tablecell> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph role="paragraph" id="par_id3149045" xml-lang="en-US" l10n="U" oldref="253"> +<emph>10</emph> +</paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3155799" xml-lang="en-US" l10n="U" oldref="254">16</paragraph> +</tablecell> +<tablecell> +</tablecell> +<tablecell> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph role="paragraph" id="par_id3155076" xml-lang="en-US" l10n="U" oldref="255"> +<emph>11</emph> +</paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3150217" xml-lang="en-US" l10n="U" oldref="256">33</paragraph> +</tablecell> +<tablecell> +</tablecell> +<tablecell> +</tablecell> +</tablerow> +</table> + +<paragraph role="paragraph" id="par_id3150312" xml-lang="en-US" l10n="CHG" oldref="29">Select a single column range in which to enter the frequency according to the class limits. You must select one field more than the class ceiling. In this example, select the range C1:C6. Call up the FREQUENCY function in the <emph>Function Wizard</emph>. Select the <emph>Data</emph> range in (A1:A11), and then the <emph>Classes</emph> range in which you entered the class limits (B1:B6). Select the <emph>Array</emph> check box and click <emph>OK</emph>. You will see the frequency count in the range C1:C6.</paragraph> +<paragraph role="paragraph" id="par_idN11269" xml-lang="en-US" l10n="NEW"> +<embedvar href="text/scalc/00/00000004.xhp#moreontop"/> +</paragraph> +</section> +<section id="Section12"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3151030"><bookmark_value>MDETERM function</bookmark_value> +<bookmark_value>determinants</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_MDET" id="bm_id3154057" localize="false"/> +<paragraph role="heading" id="hd_id3151030" xml-lang="en-US" level="2" l10n="U" oldref="31">MDETERM</paragraph> +<paragraph role="paragraph" id="par_id3154073" xml-lang="en-US" l10n="U" oldref="32"><ahelp hid="HID_FUNC_MDET">Returns the array determinant of an array.</ahelp> This function returns a value in the current cell; it is not necessary to define a range for the results.</paragraph> +<paragraph role="heading" id="hd_id3156366" xml-lang="en-US" level="3" l10n="U" oldref="33">Syntax</paragraph> +<paragraph role="code" id="par_id3156380" xml-lang="en-US" l10n="U" oldref="34">MDETERM(Array)</paragraph> +<paragraph role="paragraph" id="par_id3150290" xml-lang="en-US" l10n="U" oldref="35"> +<emph>Array</emph> represents a square array in which the determinants are defined.</paragraph> +<paragraph role="note" id="par_idN11035" xml-lang="en-US" l10n="NEW">You can find a general introduction to using Array functions on top of this page.</paragraph> +<paragraph role="paragraph" id="par_idN11333" xml-lang="en-US" l10n="NEW"> +<embedvar href="text/scalc/00/00000004.xhp#moreontop"/> +</paragraph> +</section> +<section id="Section11"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3151348"><bookmark_value>MINVERSE function</bookmark_value> +<bookmark_value>inverse arrays</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_MINV" id="bm_id3151360" localize="false"/> +<paragraph role="heading" id="hd_id3151348" xml-lang="en-US" level="2" l10n="U" oldref="39">MINVERSE</paragraph> +<paragraph role="paragraph" id="par_id3145569" xml-lang="en-US" l10n="U" oldref="40"><ahelp hid="HID_FUNC_MINV">Returns the inverse array.</ahelp></paragraph> +<paragraph role="heading" id="hd_id3156072" xml-lang="en-US" level="3" l10n="U" oldref="41">Syntax</paragraph> +<paragraph role="code" id="par_id3156085" xml-lang="en-US" l10n="U" oldref="42">MINVERSE(Array)</paragraph> +<paragraph role="paragraph" id="par_id3157849" xml-lang="en-US" l10n="U" oldref="43"> +<emph>Array</emph> represents a square array that is to be inverted.</paragraph> +<paragraph role="paragraph" id="par_idN113EE" xml-lang="en-US" l10n="NEW"> +<embedvar href="text/scalc/00/00000004.xhp#moreontop"/> +</paragraph> +<paragraph role="heading" id="hd_id3157868" xml-lang="en-US" level="3" l10n="U" oldref="44">Example</paragraph> +<paragraph role="paragraph" id="par_id3149638" xml-lang="en-US" l10n="U" oldref="45">Select a square range and select MINVERSE. Select the output array, select the <emph>Array</emph> field and click <emph>OK</emph>.</paragraph> +</section> +<section id="Section10"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3148546"><bookmark_value>MMULT function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_MMULT" id="bm_id3148501" localize="false"/> +<paragraph role="heading" id="hd_id3148546" xml-lang="en-US" level="2" l10n="U" oldref="47">MMULT</paragraph> +<paragraph role="paragraph" id="par_id3148518" xml-lang="en-US" l10n="U" oldref="48"><ahelp hid="HID_FUNC_MMULT">Calculates the array product of two arrays.</ahelp> The number of columns for array 1 must match the number of rows for array 2. The square array has an equal number of rows and columns.</paragraph> +<paragraph role="heading" id="hd_id3146767" xml-lang="en-US" level="3" l10n="U" oldref="49">Syntax</paragraph> +<paragraph role="code" id="par_id3150798" xml-lang="en-US" l10n="U" oldref="50">MMULT(Array; Array)</paragraph> +<paragraph role="paragraph" id="par_id3150812" xml-lang="en-US" l10n="U" oldref="51"> +<emph>Array</emph> at first place represents the first array used in the array product.</paragraph> +<paragraph role="paragraph" id="par_id3152553" xml-lang="en-US" l10n="U" oldref="52"> +<emph>Array</emph> at second place represents the second array with the same number of rows.</paragraph> +<paragraph role="note" id="par_idN114C3" xml-lang="en-US" l10n="NEW"> +<embedvar href="text/scalc/00/00000004.xhp#moreontop"/> +</paragraph> +<paragraph role="heading" id="hd_id3152574" xml-lang="en-US" level="3" l10n="U" oldref="53">Example</paragraph> +<paragraph role="paragraph" id="par_id3146826" xml-lang="en-US" l10n="U" oldref="54">Select a square range. Choose the MMULT function. Select the first <emph>Array</emph>, then select the second <emph>Array</emph>. Using <emph>Function Wizard</emph>, mark the <emph>Array</emph> check box. Click <emph>OK</emph>. The output array will appear in the first selected range.</paragraph> +</section> +<section id="Section9"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3154970"><bookmark_value>TRANSPOSE function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_MTRANS" id="bm_id3154982" localize="false"/> +<paragraph role="heading" id="hd_id3154970" xml-lang="en-US" level="2" l10n="U" oldref="56">TRANSPOSE</paragraph> +<paragraph role="paragraph" id="par_id3155276" xml-lang="en-US" l10n="U" oldref="57"><ahelp hid="HID_FUNC_MTRANS">Transposes the rows and columns of an array.</ahelp></paragraph> +<paragraph role="heading" id="hd_id3155294" xml-lang="en-US" level="3" l10n="U" oldref="58">Syntax</paragraph> +<paragraph role="code" id="par_id3153843" xml-lang="en-US" l10n="U" oldref="59">TRANSPOSE(Array)</paragraph> +<paragraph role="paragraph" id="par_id3153857" xml-lang="en-US" l10n="U" oldref="60"> +<emph>Array</emph> represents the array in the spreadsheet that is to be transposed.</paragraph> +<paragraph role="paragraph" id="par_idN115A5" xml-lang="en-US" l10n="NEW"> +<embedvar href="text/scalc/00/00000004.xhp#moreontop"/> +</paragraph> +<paragraph role="heading" id="hd_id3159352" xml-lang="en-US" level="3" l10n="U" oldref="61">Example</paragraph> +<paragraph role="paragraph" id="par_id3159366" xml-lang="en-US" l10n="U" oldref="62">In the spreadsheet, select the range in which the transposed array can appear. If the original array has n rows and m columns, your selected range must have at least m rows and n columns. Then enter the formula directly, select the original array and press <switchinline select="sys"><caseinline select="MAC">Shift+Command+Enter</caseinline><defaultinline>Shift+Ctrl+Enter</defaultinline></switchinline>. Or, if you are using the <emph>Function Wizard</emph>, mark the <emph>Array</emph> check box. The transposed array appears in the selected target range and is protected automatically against changes.</paragraph> +</section> +<section id="Section8"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3109846"><bookmark_value>LINEST function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_RGP" id="bm_id3144716" localize="false"/> +<paragraph role="heading" id="hd_id3109846" xml-lang="en-US" level="2" l10n="U" oldref="64">LINEST</paragraph> +<paragraph role="paragraph" id="par_id3144733" xml-lang="en-US" l10n="CHG" oldref="65"><ahelp hid="HID_FUNC_RGP">Returns a table of statistics for a straight line that best fits a data set.</ahelp><comment>changed based on http://wiki.documentfoundation.org/Documentation/How_Tos/Calc:_LINEST_function (issue 76142)</comment></paragraph> +<paragraph role="heading" id="hd_id3152825" xml-lang="en-US" level="3" l10n="U" oldref="66">Syntax</paragraph> +<paragraph role="code" id="par_id3152839" xml-lang="en-US" l10n="U" oldref="67">LINEST(data_Y; data_X; linearType; stats)</paragraph> +<paragraph role="paragraph" id="par_id3152853" xml-lang="en-US" l10n="U" oldref="68"> +<emph>data_Y</emph> is a single row or column range specifying the y coordinates in a set of data points.</paragraph> +<paragraph role="paragraph" id="par_id3154428" xml-lang="en-US" l10n="U" oldref="69"> +<emph>data_X</emph> is a corresponding single row or column range specifying the x coordinates. If <emph>data_X</emph> is omitted it defaults to <item type="literal">1, 2, 3, ..., n</item>. If there is more than one set of variables <emph>data_X</emph> may be a range with corresponding multiple rows or columns.</paragraph> +<paragraph role="paragraph" id="par_id0811200804502119" xml-lang="en-US" l10n="NEW">LINEST finds a straight line <item type="literal">y = a + bx</item> that best fits the data, using linear regression (the "least squares" method). With more than one set of variables the straight line is of the form <item type="literal">y = a + b1x1 + b2x2 ... + bnxn</item>.</paragraph> +<paragraph role="paragraph" id="par_id3154448" xml-lang="en-US" l10n="U" oldref="70"> if<emph>linearType</emph> is FALSE the straight line found is forced to pass through the origin (the constant a is zero; y = bx). If omitted, <emph>linearType</emph> defaults to TRUE (the line is not forced through the origin).</paragraph> +<paragraph role="paragraph" id="par_id3154142" xml-lang="en-US" l10n="U" oldref="71">if<emph>stats</emph> is omitted or FALSE only the top line of the statistics table is returned. If TRUE the entire table is returned.</paragraph> +<paragraph role="paragraph" id="par_id0811200804502261" xml-lang="en-US" l10n="NEW">LINEST returns a table (array) of statistics as below and must be entered as an array formula (for example by using <switchinline select="sys"><caseinline select="MAC">Command</caseinline><defaultinline>Ctrl</defaultinline></switchinline>+Shift+Return rather than just Return).</paragraph> +<paragraph role="paragraph" id="par_idN11416" xml-lang="en-US" l10n="NEW"> +<embedvar href="text/scalc/00/00000004.xhp#optional"/> +</paragraph> +<paragraph role="paragraph" id="par_idN116C6" xml-lang="en-US" l10n="NEW"> +<embedvar href="text/scalc/00/00000004.xhp#moreontop"/> +</paragraph> +<paragraph role="heading" id="hd_id3154162" xml-lang="en-US" level="3" l10n="U" oldref="72">Example</paragraph> +<paragraph role="paragraph" id="par_id3154176" xml-lang="en-US" l10n="U" oldref="73">This function returns an array and is handled in the same way as the other array functions. Select a range for the answers and then the function. Select <emph>data_Y</emph>. If you want, you can enter other parameters. Select <emph>Array</emph> and click <emph>OK</emph>.</paragraph> +<paragraph role="paragraph" id="par_id3155468" xml-lang="en-US" l10n="U" oldref="74">The results returned by the system (if <emph>stats</emph> = 0), will at least show the slope of the regression line and its intersection with the Y axis. If <emph>stats</emph> does not equal 0, other results are to be displayed.</paragraph> +<paragraph role="heading" id="hd_id3155491" xml-lang="en-US" level="3" l10n="U" oldref="75">Other LINEST Results:</paragraph> +<paragraph role="paragraph" id="par_id3159291" xml-lang="en-US" l10n="U" oldref="76">Examine the following examples:</paragraph> +<table id="tbl_id3159305"> +<tablerow> +<tablecell> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3157922" xml-lang="en-US" l10n="U" oldref="77">A</paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3157945" xml-lang="en-US" l10n="U" oldref="78">B</paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3152486" xml-lang="en-US" l10n="U" oldref="79">C</paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3152509" xml-lang="en-US" l10n="U" oldref="80">D</paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3152532" xml-lang="en-US" l10n="U" oldref="81">E</paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3153431" xml-lang="en-US" l10n="U" oldref="82">F</paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3153454" xml-lang="en-US" l10n="U" oldref="83">G</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph role="paragraph" id="par_id3154995" xml-lang="en-US" l10n="U" oldref="84"> +<emph>1</emph> +</paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3155021" xml-lang="en-US" l10n="U" oldref="85"> +<item type="input">x1</item> +</paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3155044" xml-lang="en-US" l10n="U" oldref="86"> +<item type="input">x2</item> +</paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3163734" xml-lang="en-US" l10n="U" oldref="87"> +<item type="input">y</item> +</paragraph> +</tablecell> +<tablecell> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3163766" xml-lang="en-US" l10n="U" oldref="88"> +<item type="input">LIN</item> +<item type="input">EST value</item> +</paragraph> +</tablecell> +<tablecell> +</tablecell> +<tablecell> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph role="paragraph" id="par_id3145686" xml-lang="en-US" l10n="U" oldref="89"> +<emph>2</emph> +</paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3145713" xml-lang="en-US" l10n="U" oldref="90"> +<item type="input">4</item> +</paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3145736" xml-lang="en-US" l10n="U" oldref="91"> +<item type="input">7</item> +</paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3159427" xml-lang="en-US" l10n="U" oldref="92"> +<item type="input">100</item> +</paragraph> +</tablecell> +<tablecell> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3159460" xml-lang="en-US" l10n="U" oldref="93"> +<item type="input">4,17</item> +</paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3159483" xml-lang="en-US" l10n="U" oldref="94">-<item type="input">3,48</item> +</paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3152381" xml-lang="en-US" l10n="U" oldref="95"> +<item type="input">82,33</item> +</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph role="paragraph" id="par_id3152408" xml-lang="en-US" l10n="U" oldref="96"> +<emph>3</emph> +</paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3152435" xml-lang="en-US" l10n="U" oldref="97"> +<item type="input">5</item> +</paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3152458" xml-lang="en-US" l10n="U" oldref="98"> +<item type="input">9</item> +</paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3155652" xml-lang="en-US" l10n="U" oldref="99"> +<item type="input">105</item> +</paragraph> +</tablecell> +<tablecell> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3155684" xml-lang="en-US" l10n="U" oldref="100"> +<item type="input">5,46</item> +</paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3155707" xml-lang="en-US" l10n="U" oldref="101"> +<item type="input">10,96</item> +</paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3155730" xml-lang="en-US" l10n="U" oldref="102"> +<item type="input">9,35</item> +</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph role="paragraph" id="par_id3159506" xml-lang="en-US" l10n="U" oldref="103"> +<emph>4</emph> +</paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3159533" xml-lang="en-US" l10n="U" oldref="104"> +<item type="input">6</item> +</paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3159556" xml-lang="en-US" l10n="U" oldref="105"> +<item type="input">11</item> +</paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3159579" xml-lang="en-US" l10n="U" oldref="106"> +<item type="input">104</item> +</paragraph> +</tablecell> +<tablecell> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3159611" xml-lang="en-US" l10n="U" oldref="107"> +<item type="input">0,87</item> +</paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3152606" xml-lang="en-US" l10n="U" oldref="108"> +<item type="input">5,06</item> +</paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3152629" xml-lang="en-US" l10n="U" oldref="109"> +<item type="input">#NA</item> +</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph role="paragraph" id="par_id3152655" xml-lang="en-US" l10n="U" oldref="110"> +<emph>5</emph> +</paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3152682" xml-lang="en-US" l10n="U" oldref="111"> +<item type="input">7</item> +</paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3152705" xml-lang="en-US" l10n="U" oldref="112"> +<item type="input">12</item> +</paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3152728" xml-lang="en-US" l10n="U" oldref="113"> +<item type="input">108</item> +</paragraph> +</tablecell> +<tablecell> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3144352" xml-lang="en-US" l10n="U" oldref="114"> +<item type="input">13,21</item> +</paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3144375" xml-lang="en-US" l10n="U" oldref="115"> +<item type="input">4</item> +</paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3144398" xml-lang="en-US" l10n="U" oldref="116"> +<item type="input">#NA</item> +</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph role="paragraph" id="par_id3144425" xml-lang="en-US" l10n="U" oldref="117"> +<emph>6</emph> +</paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3144452" xml-lang="en-US" l10n="U" oldref="118"> +<item type="input">8</item> +</paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3144475" xml-lang="en-US" l10n="U" oldref="119"> +<item type="input">15</item> +</paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3144498" xml-lang="en-US" l10n="U" oldref="120"> +<item type="input">111</item> +</paragraph> +</tablecell> +<tablecell> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3158233" xml-lang="en-US" l10n="U" oldref="121"> +<item type="input">675,45</item> +</paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3158256" xml-lang="en-US" l10n="U" oldref="122"> +<item type="input">102,26</item> +</paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3158279" xml-lang="en-US" l10n="U" oldref="123"> +<item type="input">#NA</item> +</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph role="paragraph" id="par_id3158306" xml-lang="en-US" l10n="U" oldref="124"> +<emph>7</emph> +</paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3158333" xml-lang="en-US" l10n="U" oldref="125"> +<item type="input">9</item> +</paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3158356" xml-lang="en-US" l10n="U" oldref="126"> +<item type="input">17</item> +</paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3158379" xml-lang="en-US" l10n="U" oldref="127"> +<item type="input">120</item> +</paragraph> +</tablecell> +<tablecell> +</tablecell> +<tablecell> +</tablecell> +<tablecell> +</tablecell> +<tablecell> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph role="paragraph" id="par_id3144560" xml-lang="en-US" l10n="U" oldref="128"> +<emph>8</emph> +</paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3144586" xml-lang="en-US" l10n="U" oldref="129"> +<item type="input">10</item> +</paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3144609" xml-lang="en-US" l10n="U" oldref="130"> +<item type="input">19</item> +</paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3144632" xml-lang="en-US" l10n="U" oldref="131"> +<item type="input">133</item> +</paragraph> +</tablecell> +<tablecell> +</tablecell> +<tablecell> +</tablecell> +<tablecell> +</tablecell> +<tablecell> +</tablecell> +</tablerow> +</table> + +<paragraph role="paragraph" id="par_id3144687" xml-lang="en-US" l10n="U" oldref="132">Column A contains several X1 values, column B several X2 values and column C the Y values. You have already entered these values in your spreadsheet. You have now set up E2:G6 in the spreadsheet and activated the <emph>Function Wizard</emph>. For the LINEST function to work, you must have marked the <emph>Array</emph> check box in the <emph>Function Wizard</emph>. Next, select the following values in the spreadsheet (or enter them using the keyboard):</paragraph> +<paragraph role="paragraph" id="par_id3158020" xml-lang="en-US" l10n="U" oldref="133"> +<emph>data_Y</emph> is C2:C8</paragraph> +<paragraph role="paragraph" id="par_id3158039" xml-lang="en-US" l10n="U" oldref="134"> +<emph>data_X</emph> is A2:B8</paragraph> +<paragraph role="paragraph" id="par_id3158058" xml-lang="en-US" l10n="U" oldref="135"> +<emph>linearType</emph> and <emph>stats</emph> are both set to 1.</paragraph> +<paragraph role="paragraph" id="par_id3158084" xml-lang="en-US" l10n="U" oldref="136">As soon as you click <emph>OK</emph>, $[officename] Calc will fill the above example with the LINEST values as shown in the example.</paragraph> +<paragraph role="paragraph" id="par_id3158106" xml-lang="en-US" l10n="U" oldref="137">The formula in the <emph>Formula</emph> Bar corresponds to each cell of the LINEST array <item type="input">{=LINEST(C2:C8;A2:B8;1;1)}</item> +</paragraph> +<paragraph role="paragraph" id="par_id3158128" xml-lang="en-US" l10n="U" oldref="138"> +<emph>This represents the calculated LINEST values:</emph> +</paragraph> +<bookmark xml-lang="en-US" branch="index" id="bm_id3158146"><bookmark_value>slopes, see also regression lines</bookmark_value> +<bookmark_value>regression lines;LINEST function</bookmark_value> +</bookmark><comment>mw made "regression lines" a two level entry</comment> +<paragraph role="paragraph" id="par_id3158146" xml-lang="en-US" l10n="U" oldref="139">E2 and F2: Slope m of the regression line y=b+m*x for the x1 and x2 values. The values are given in reverse order; that is, the slope for x2 in E2 and the slope for x1 in F2.</paragraph> +<paragraph role="paragraph" id="par_id3158184" xml-lang="en-US" l10n="U" oldref="140">G2: Intersection b with the y axis.</paragraph> +<bookmark xml-lang="en-US" branch="index" id="bm_id3158204"><bookmark_value>standard errors;array functions</bookmark_value> +</bookmark><comment>MW changed "standard errors"</comment> +<paragraph role="paragraph" id="par_id3158204" xml-lang="en-US" l10n="U" oldref="141">E3 and F3: The standard error of the slope value.</paragraph> +<paragraph role="paragraph" id="par_id3145845" xml-lang="en-US" l10n="U" oldref="142">G3: The standard error of the intercept</paragraph> +<bookmark xml-lang="en-US" branch="index" id="bm_id3145859"><bookmark_value>RSQ calculations</bookmark_value> +</bookmark> +<paragraph role="paragraph" id="par_id3145859" xml-lang="en-US" l10n="U" oldref="143">E4: RSQ</paragraph> +<paragraph role="paragraph" id="par_id3145880" xml-lang="en-US" l10n="U" oldref="144">F4: The standard error of the regression calculated for the Y value.</paragraph> +<paragraph role="paragraph" id="par_id3145894" xml-lang="en-US" l10n="U" oldref="145">E5: The F value from the variance analysis.</paragraph> +<paragraph role="paragraph" id="par_id3145915" xml-lang="en-US" l10n="U" oldref="146">F5: The degrees of freedom from the variance analysis.</paragraph> +<paragraph role="paragraph" id="par_id3145937" xml-lang="en-US" l10n="U" oldref="147">E6: The sum of the squared deviation of the estimated Y values from their linear mean.</paragraph> +<paragraph role="paragraph" id="par_id3145952" xml-lang="en-US" l10n="U" oldref="148">F6: The sum of the squared deviation of the estimated Y value from the given Y values.</paragraph> +<paragraph role="paragraph" id="par_idN11B04" xml-lang="en-US" l10n="NEW"> +<embedvar href="text/scalc/00/00000004.xhp#moreontop"/> +</paragraph> +</section> +<section id="Section7"> +<bookmark xml-lang="en-US" branch="index" id="bm_id1596728"><bookmark_value>LOGEST function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_RKP" id="bm_id3146020" localize="false"/> +<paragraph role="heading" id="hd_id3146009" xml-lang="en-US" level="2" l10n="U" oldref="150">LOGEST</paragraph> +<paragraph role="paragraph" id="par_id3146037" xml-lang="en-US" l10n="U" oldref="151"><ahelp hid="HID_FUNC_RKP">This function calculates the adjustment of the entered data as an exponential regression curve (y=b*m^x).</ahelp><comment>UFI: see http://support.microsoft.com/default.aspx?kbid=828528&product=xl2003 +for bug #i31051#</comment></paragraph> +<paragraph role="heading" id="hd_id3146056" xml-lang="en-US" level="3" l10n="U" oldref="152">Syntax</paragraph> +<paragraph role="code" id="par_id3163123" xml-lang="en-US" l10n="U" oldref="153">LOGEST(DataY; DataX; FunctionType; Stats)</paragraph> +<paragraph role="paragraph" id="par_id3163137" xml-lang="en-US" l10n="U" oldref="154"> +<emph>DataY</emph> represents the Y Data array.</paragraph> +<paragraph role="paragraph" id="par_id3163155" xml-lang="en-US" l10n="U" oldref="155"> +<emph>DataX</emph> (optional) represents the X Data array.</paragraph> +<paragraph role="paragraph" id="par_id3163174" xml-lang="en-US" l10n="U" oldref="156"> +<emph>FunctionType</emph> (optional). If Function_Type = 0, functions in the form y = m^x will be calculated. Otherwise, y = b*m^x functions will be calculated.</paragraph> +<paragraph role="paragraph" id="par_id3163196" xml-lang="en-US" l10n="U" oldref="157"> +<emph>Stats</emph> (optional). If Stats=0, only the regression coefficient is calculated.</paragraph> +<paragraph role="paragraph" id="par_idN118F7" xml-lang="en-US" l10n="NEW"> +<embedvar href="text/scalc/00/00000004.xhp#optional"/> +</paragraph> +<paragraph role="paragraph" id="par_idN11BC3" xml-lang="en-US" l10n="NEW"> +<embedvar href="text/scalc/00/00000004.xhp#moreontop"/> +</paragraph> +<paragraph role="heading" id="hd_id3163216" xml-lang="en-US" level="3" l10n="U" oldref="158">Example</paragraph> +<paragraph role="paragraph" id="par_id3163230" xml-lang="en-US" l10n="CHG" oldref="159">See LINEST. However, no square sum will be returned.</paragraph> +</section> +<section id="Section6"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3163286"><bookmark_value>SUMPRODUCT function</bookmark_value> +<bookmark_value>scalar products</bookmark_value> +<bookmark_value>dot products</bookmark_value> +<bookmark_value>inner products</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_SUMMENPRODUKT" id="bm_id3163297" localize="false"/> +<paragraph role="heading" id="hd_id3163286" xml-lang="en-US" level="2" l10n="U" oldref="161">SUMPRODUCT</paragraph> +<paragraph role="paragraph" id="par_id3163314" xml-lang="en-US" l10n="U" oldref="162"><ahelp hid="HID_FUNC_SUMMENPRODUKT">Multiplies corresponding elements in the given arrays, and returns the sum of those products.</ahelp></paragraph> +<paragraph role="heading" id="hd_id3163334" xml-lang="en-US" level="3" l10n="U" oldref="163">Syntax</paragraph> +<paragraph role="code" id="par_id3163347" xml-lang="en-US" l10n="U" oldref="164">SUMPRODUCT(Array1; Array2...Array30)</paragraph> +<paragraph role="paragraph" id="par_id3163362" xml-lang="en-US" l10n="CHG" oldref="165"> +<emph>Array1, Array2...Array30</emph> represent arrays whose corresponding elements are to be multiplied.</paragraph> +<paragraph role="paragraph" id="par_idN11B19" xml-lang="en-US" l10n="NEW">At least one array must be part of the argument list. If only one array is given, all array elements are summed.</paragraph> +<paragraph role="heading" id="par_idN11B1C" xml-lang="en-US" level="3" l10n="NEW">Example</paragraph> +<table id="tbl_id6215704"> +<tablerow> +<tablecell> +</tablecell> +<tablecell> +<paragraph role="tablehead" id="par_idN11B2F" xml-lang="en-US" l10n="NEW">A</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablehead" id="par_idN11B35" xml-lang="en-US" l10n="NEW">B</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablehead" id="par_idN11B3B" xml-lang="en-US" l10n="NEW">C</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablehead" id="par_idN11B41" xml-lang="en-US" l10n="NEW">D</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph role="tablecontent" id="par_idN11B48" xml-lang="en-US" l10n="NEW">1</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablecontent" id="par_idN11B4E" xml-lang="en-US" l10n="NEW"> +<item type="input">2</item> +</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablecontent" id="par_idN11B54" xml-lang="en-US" l10n="NEW"> +<item type="input">3</item> +</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablecontent" id="par_idN11B5A" xml-lang="en-US" l10n="NEW"> +<item type="input">4</item> +</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablecontent" id="par_idN11B60" xml-lang="en-US" l10n="NEW"> +<item type="input">5</item> +</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph role="tablecontent" id="par_idN11B67" xml-lang="en-US" l10n="NEW">2</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablecontent" id="par_idN11B6D" xml-lang="en-US" l10n="NEW"> +<item type="input">6</item> +</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablecontent" id="par_idN11B73" xml-lang="en-US" l10n="NEW"> +<item type="input">7</item> +</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablecontent" id="par_idN11B79" xml-lang="en-US" l10n="NEW"> +<item type="input">8</item> +</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablecontent" id="par_idN11B7F" xml-lang="en-US" l10n="NEW"> +<item type="input">9</item> +</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph role="tablecontent" id="par_idN11B86" xml-lang="en-US" l10n="NEW">3</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablecontent" id="par_idN11B8C" xml-lang="en-US" l10n="NEW"> +<item type="input">10</item> +</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablecontent" id="par_idN11B92" xml-lang="en-US" l10n="NEW"> +<item type="input">11</item> +</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablecontent" id="par_idN11B98" xml-lang="en-US" l10n="NEW"> +<item type="input">12</item> +</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablecontent" id="par_idN11B9E" xml-lang="en-US" l10n="NEW"> +<item type="input">13</item> +</paragraph> +</tablecell> +</tablerow> +</table> + +<paragraph role="paragraph" id="par_idN11BA1" xml-lang="en-US" l10n="NEW"> +<item type="input">=SUMPRODUCT(A1:B3;C1:D3)</item> returns 397.</paragraph> +<paragraph role="paragraph" id="par_idN11BA4" xml-lang="en-US" l10n="NEW">Calculation: A1*C1 + B1*D1 + A2*C2 + B2*D2 + A3*C3 + B3*D3</paragraph> +<paragraph role="paragraph" id="par_idN11BA7" xml-lang="en-US" l10n="NEW">You can use SUMPRODUCT to calculate the scalar product of two vectors.</paragraph> +<paragraph role="note" id="par_idN11BBC" xml-lang="en-US" l10n="NEW">SUMPRODUCT returns a single number, it is not necessary to enter the function as an array function.</paragraph> +<paragraph role="paragraph" id="par_idN11C91" xml-lang="en-US" l10n="NEW"> +<embedvar href="text/scalc/00/00000004.xhp#moreontop"/> +</paragraph> +</section> +<section id="Section5"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3144842"><bookmark_value>SUMX2MY2 function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_SUMMEX2MY2" id="bm_id3144854" localize="false"/> +<paragraph role="heading" id="hd_id3144842" xml-lang="en-US" level="2" l10n="U" oldref="169">SUMX2MY2</paragraph> +<paragraph role="paragraph" id="par_id3144871" xml-lang="en-US" l10n="U" oldref="170"><ahelp hid="HID_FUNC_SUMMEX2MY2">Returns the sum of the difference of squares of corresponding values in two arrays.</ahelp></paragraph> +<paragraph role="heading" id="hd_id3144889" xml-lang="en-US" level="3" l10n="U" oldref="171">Syntax</paragraph> +<paragraph role="code" id="par_id3144903" xml-lang="en-US" l10n="U" oldref="172">SUMX2MY2(ArrayX; ArrayY)</paragraph> +<paragraph role="paragraph" id="par_id3144916" xml-lang="en-US" l10n="U" oldref="173"> +<emph>ArrayX</emph> represents the first array whose elements are to be squared and added.</paragraph> +<paragraph role="paragraph" id="par_id3144936" xml-lang="en-US" l10n="U" oldref="174"> +<emph>ArrayY</emph> represents the second array whose elements are to be squared and subtracted.</paragraph> +<paragraph role="paragraph" id="par_idN11D6B" xml-lang="en-US" l10n="NEW"> +<embedvar href="text/scalc/00/00000004.xhp#moreontop"/> +</paragraph> +</section> +<section id="Section4"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3145026"><bookmark_value>SUMX2PY2 function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_SUMMEX2PY2" id="bm_id3145038" localize="false"/> +<paragraph role="heading" id="hd_id3145026" xml-lang="en-US" level="2" l10n="U" oldref="178">SUMX2PY2</paragraph> +<paragraph role="paragraph" id="par_id3145055" xml-lang="en-US" l10n="U" oldref="179"><ahelp hid="HID_FUNC_SUMMEX2PY2">Returns the sum of the sum of squares of corresponding values in two arrays.</ahelp></paragraph> +<paragraph role="heading" id="hd_id3163390" xml-lang="en-US" level="3" l10n="U" oldref="180">Syntax</paragraph> +<paragraph role="code" id="par_id3163404" xml-lang="en-US" l10n="U" oldref="181">SUMX2PY2(ArrayX; ArrayY)</paragraph> +<paragraph role="paragraph" id="par_id3163417" xml-lang="en-US" l10n="U" oldref="182"> +<emph>ArrayX</emph> represents the first array whose elements are to be squared and added.</paragraph> +<paragraph role="paragraph" id="par_id3163437" xml-lang="en-US" l10n="U" oldref="183"> +<emph>ArrayY</emph> represents the second array, whose elements are to be squared and added.</paragraph> +<paragraph role="paragraph" id="par_idN11E45" xml-lang="en-US" l10n="NEW"> +<embedvar href="text/scalc/00/00000004.xhp#moreontop"/> +</paragraph> +</section> +<section id="Section3"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3163527"><bookmark_value>SUMXMY2 function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_SUMMEXMY2" id="bm_id3163539" localize="false"/> +<paragraph role="heading" id="hd_id3163527" xml-lang="en-US" level="2" l10n="U" oldref="187">SUMXMY2</paragraph> +<paragraph role="paragraph" id="par_id3163556" xml-lang="en-US" l10n="U" oldref="188"><ahelp hid="HID_FUNC_SUMMEXMY2">Adds the squares of the variance between corresponding values in two arrays.</ahelp></paragraph> +<paragraph role="heading" id="hd_id3163574" xml-lang="en-US" level="3" l10n="U" oldref="189">Syntax</paragraph> +<paragraph role="code" id="par_id3163588" xml-lang="en-US" l10n="U" oldref="190">SUMXMY2(ArrayX; ArrayY)</paragraph> +<paragraph role="paragraph" id="par_id3163601" xml-lang="en-US" l10n="U" oldref="191"> +<emph>ArrayX</emph> represents the first array whose elements are to be subtracted and squared.</paragraph> +<paragraph role="paragraph" id="par_id3163621" xml-lang="en-US" l10n="U" oldref="192"> +<emph>ArrayY</emph> represents the second array, whose elements are to be subtracted and squared.</paragraph> +<paragraph role="paragraph" id="par_idN11F1F" xml-lang="en-US" l10n="NEW"> +<embedvar href="text/scalc/00/00000004.xhp#moreontop"/> +</paragraph> +</section> +<section id="Section2"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3166062"><bookmark_value>TREND function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_TREND" id="bm_id3166074" localize="false"/> +<paragraph role="heading" id="hd_id3166062" xml-lang="en-US" level="2" l10n="U" oldref="196">TREND</paragraph> +<paragraph role="paragraph" id="par_id3166091" xml-lang="en-US" l10n="U" oldref="197"><ahelp hid="HID_FUNC_TREND">Returns values along a linear trend.</ahelp></paragraph> +<paragraph role="heading" id="hd_id3166109" xml-lang="en-US" level="3" l10n="U" oldref="198">Syntax</paragraph> +<paragraph role="code" id="par_id3166122" xml-lang="en-US" l10n="U" oldref="199">TREND(DataY; DataX; NewDataX; LinearType)</paragraph> +<paragraph role="paragraph" id="par_id3166137" xml-lang="en-US" l10n="U" oldref="200"> +<emph>DataY</emph> represents the Y Data array.</paragraph> +<paragraph role="paragraph" id="par_id3166156" xml-lang="en-US" l10n="U" oldref="201"> +<emph>DataX</emph> (optional) represents the X Data array.</paragraph> +<paragraph role="paragraph" id="par_id3166176" xml-lang="en-US" l10n="U" oldref="202"> +<emph>NewDataX</emph> (optional) represents the array of the X data, which are used for recalculating values.</paragraph> +<paragraph role="paragraph" id="par_id3166196" xml-lang="en-US" l10n="U" oldref="203"> +<emph>LinearType</emph>(Optional). If LinearType = 0, then lines will be calculated through the zero point. Otherwise, offset lines will also be calculated. The default is LinearType <> 0.</paragraph> +<paragraph role="paragraph" id="par_idN11D2F" xml-lang="en-US" l10n="NEW"> +<embedvar href="text/scalc/00/00000004.xhp#optional"/> +</paragraph> +<paragraph role="paragraph" id="par_idN12019" xml-lang="en-US" l10n="NEW"> +<embedvar href="text/scalc/00/00000004.xhp#moreontop"/> +</paragraph> +<paragraph role="heading" id="hd_id3166231" xml-lang="en-US" level="3" l10n="U" oldref="204">Example</paragraph> +<paragraph role="paragraph" id="par_id3166245" xml-lang="en-US" l10n="U" oldref="205">Select a spreadsheet range in which the trend data will appear. Select the function. Enter the output data or select it with the mouse. Mark the <emph>Array</emph> field. click <emph>OK</emph>. The trend data calculated from the output data is displayed.</paragraph> +</section> +<section id="Section1"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3166317"><bookmark_value>GROWTH function</bookmark_value> +<bookmark_value>exponential trends in arrays</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_VARIATION" id="bm_id3166329" localize="false"/> +<paragraph role="heading" id="hd_id3166317" xml-lang="en-US" level="2" l10n="U" oldref="207">GROWTH</paragraph> +<paragraph role="paragraph" id="par_id3166346" xml-lang="en-US" l10n="U" oldref="208"><ahelp hid="HID_FUNC_VARIATION">Calculates the points of an exponential trend in an array.</ahelp></paragraph> +<paragraph role="heading" id="hd_id3166364" xml-lang="en-US" level="3" l10n="U" oldref="209">Syntax</paragraph> +<paragraph role="code" id="par_id3166377" xml-lang="en-US" l10n="CHG" oldref="210">GROWTH(DataY; DataX; NewDataX; FunctionType)</paragraph> +<paragraph role="paragraph" id="par_id3166392" xml-lang="en-US" l10n="U" oldref="211"> +<emph>DataY</emph> represents the Y Data array.</paragraph> +<paragraph role="paragraph" id="par_id3166411" xml-lang="en-US" l10n="U" oldref="212"> +<emph>DataX</emph> (optional) represents the X Data array.</paragraph> +<paragraph role="paragraph" id="par_id3173797" xml-lang="en-US" l10n="U" oldref="213"> +<emph>NewDataX</emph> (optional) represents the X data array, in which the values are recalculated.</paragraph> +<paragraph role="paragraph" id="par_id3173817" xml-lang="en-US" l10n="U" oldref="214"> +<emph>FunctionType</emph>(optional). If FunctionType = 0, functions in the form y = m^x will be calculated. Otherwise, y = b*m^x functions will be calculated.</paragraph> +<paragraph role="paragraph" id="par_idN11DFD" xml-lang="en-US" l10n="NEW"> +<embedvar href="text/scalc/00/00000004.xhp#optional"/> +</paragraph> +<paragraph role="paragraph" id="par_idN12113" xml-lang="en-US" l10n="NEW"> +<embedvar href="text/scalc/00/00000004.xhp#moreontop"/> +</paragraph> +<paragraph role="heading" id="hd_id3173839" xml-lang="en-US" level="3" l10n="U" oldref="215">Example</paragraph> +<paragraph role="paragraph" id="par_id3173852" xml-lang="en-US" l10n="U" oldref="216">This function returns an array and is handled in the same way as the other array functions. Select a range where you want the answers to appear and select the function. Select DataY. Enter any other parameters, mark <emph>Array</emph> and click <emph>OK</emph>.</paragraph> +</section> +</sort> +<section id="relatedtopics"> +<embed href="text/scalc/01/04060100.xhp#drking"/> +</section> +</body> +</helpdocument> diff --git a/source/text/scalc/01/04060108.xhp b/source/text/scalc/01/04060108.xhp new file mode 100644 index 0000000000..b7fe1f036e --- /dev/null +++ b/source/text/scalc/01/04060108.xhp @@ -0,0 +1,162 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> + +<!-- +*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************ + --> + + +<meta> +<topic id="textscalc0104060108xml" indexer="include"> +<title id="tit" xml-lang="en-US">Statistics Functions</title> +<filename>/text/scalc/01/04060108.xhp</filename> +</topic> +</meta> +<body> +<bookmark xml-lang="en-US" branch="index" id="bm_id3153018"><bookmark_value>statistics functions</bookmark_value> +<bookmark_value>Function Wizard; statistics</bookmark_value> +<bookmark_value>functions; statistics functions</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3153018" xml-lang="en-US" level="1" l10n="U" oldref="1">Statistics Functions</paragraph> +<paragraph role="paragraph" id="par_id3157874" xml-lang="en-US" l10n="CHG" oldref="2"><variable id="statistiktext">This category contains the <emph>Statistics</emph> functions. +</variable></paragraph> +<section id="howtoget"> +<embed href="text/scalc/00/00000404.xhp#eikasta"/> +</section> +<paragraph role="paragraph" id="par_id3149001" xml-lang="en-US" l10n="U" oldref="9">Some of the examples use the following data table:</paragraph> +<table id="tbl_id3156066"> +<tablerow> +<tablecell> +</tablecell> +<tablecell> +<paragraph role="tablehead" id="par_id3148775" xml-lang="en-US" l10n="U" oldref="10">C</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablehead" id="par_id3145297" xml-lang="en-US" l10n="U" oldref="11">D</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph role="tablecontent" id="par_id3150661" xml-lang="en-US" l10n="U" oldref="12">2</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablecontent" id="par_id3153551" xml-lang="en-US" l10n="U" oldref="13">x value</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablecontent" id="par_id3147536" xml-lang="en-US" l10n="U" oldref="14">y value</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph role="tablecontent" id="par_id3153224" xml-lang="en-US" l10n="U" oldref="15">3</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablecontent" id="par_id3150475" xml-lang="en-US" l10n="U" oldref="16">-5</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablecontent" id="par_id3155367" xml-lang="en-US" l10n="U" oldref="17">-3</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph role="tablecontent" id="par_id3149783" xml-lang="en-US" l10n="U" oldref="18">4</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablecontent" id="par_id3153181" xml-lang="en-US" l10n="U" oldref="19">-2</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablecontent" id="par_id3148429" xml-lang="en-US" l10n="U" oldref="20">0</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph role="tablecontent" id="par_id3152588" xml-lang="en-US" l10n="U" oldref="21">5</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablecontent" id="par_id3147483" xml-lang="en-US" l10n="U" oldref="22">-1</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablecontent" id="par_id3083443" xml-lang="en-US" l10n="U" oldref="23">1</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph role="tablecontent" id="par_id3149826" xml-lang="en-US" l10n="U" oldref="24">6</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablecontent" id="par_id3163820" xml-lang="en-US" l10n="U" oldref="25">0</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablecontent" id="par_id3154816" xml-lang="en-US" l10n="U" oldref="26">3</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph role="tablecontent" id="par_id3149276" xml-lang="en-US" l10n="U" oldref="27">7</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablecontent" id="par_id3149267" xml-lang="en-US" l10n="U" oldref="28">2</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablecontent" id="par_id3156310" xml-lang="en-US" l10n="U" oldref="29">4</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph role="tablecontent" id="par_id3154639" xml-lang="en-US" l10n="U" oldref="30">8</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablecontent" id="par_id3145205" xml-lang="en-US" l10n="U" oldref="31">4</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablecontent" id="par_id3153276" xml-lang="en-US" l10n="U" oldref="32">6</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph role="tablecontent" id="par_id3150756" xml-lang="en-US" l10n="U" oldref="33">9</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablecontent" id="par_id3156095" xml-lang="en-US" l10n="U" oldref="34">6</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablecontent" id="par_id3152929" xml-lang="en-US" l10n="U" oldref="35">8</paragraph> +</tablecell> +</tablerow> +</table> + +<paragraph role="paragraph" id="par_id3156324" xml-lang="en-US" l10n="U" oldref="36">The statistical functions are described in the following subsections.</paragraph> +<embed href="text/scalc/01/04060181.xhp#ae"/> +<embed href="text/scalc/01/04060182.xhp#fh"/> +<embed href="text/scalc/01/04060183.xhp#kl"/> +<embed href="text/scalc/01/04060184.xhp#mq"/> +<embed href="text/scalc/01/04060185.xhp#rz"/> +<paragraph role="paragraph" id="par_id3150271" xml-lang="en-US" l10n="U" oldref="37"><link href="text/scalc/01/04060116.xhp" name="Statistical Functions in the Analysis-AddIn.">Statistical Functions in the Analysis-AddIn</link></paragraph> +<embed href="text/scalc/01/04060100.xhp#drking"/> +</body> +</helpdocument> diff --git a/source/text/scalc/01/04060109.xhp b/source/text/scalc/01/04060109.xhp new file mode 100644 index 0000000000..853033cfde --- /dev/null +++ b/source/text/scalc/01/04060109.xhp @@ -0,0 +1,627 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> + +<!-- +*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2011 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************ + --> + + +<meta> + <topic id="textscalc0104060109xml" indexer="include"> + <title xml-lang="en-US" id="tit">Spreadsheet Functions</title> + <filename>/text/scalc/01/04060109.xhp</filename> + </topic> + </meta> + <body> +<bookmark xml-lang="en-US" branch="index" id="bm_id3148522"><bookmark_value>spreadsheets; functions</bookmark_value> + <bookmark_value>Function Wizard; spreadsheets</bookmark_value> + <bookmark_value>functions; spreadsheets</bookmark_value> +</bookmark> +<paragraph xml-lang="en-US" id="hd_id3148522" role="heading" level="1" l10n="U" oldref="1">Spreadsheet Functions</paragraph> + <paragraph xml-lang="en-US" id="par_id3144508" role="paragraph" l10n="U" oldref="2"><variable id="tabelletext">This section contains descriptions of the <emph>Spreadsheet</emph> functions together with an example. +</variable></paragraph> + <section id="howtoget"> + <embed href="text/scalc/00/00000404.xhp#efefft"/> + </section> +<sort order="asc"> +<section id="Section1"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3146968"><bookmark_value>ADDRESS function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_ADRESSE" id="bm_id3147546" localize="false"/> +<paragraph xml-lang="en-US" id="hd_id3146968" role="heading" level="2" l10n="U" oldref="3">ADDRESS</paragraph> + <paragraph xml-lang="en-US" id="par_id3155762" role="paragraph" l10n="CHG" oldref="4"><ahelp hid="HID_FUNC_ADRESSE">Returns a cell address (reference) as text, according to the specified row and column numbers.</ahelp> You can determine whether the address is interpreted as an absolute address (for example, $A$1) or as a relative address (as A1) or in a mixed form (A$1 or $A1). You can also specify the name of the sheet.</paragraph> + <section id="r1c1"> + <paragraph xml-lang="en-US" id="par_id1027200802301348" role="paragraph" l10n="NEW">For interoperability the ADDRESS and INDIRECT functions support an optional parameter to specify whether the R1C1 address notation instead of the usual A1 notation should be used.</paragraph> + <paragraph xml-lang="en-US" id="par_id1027200802301445" role="paragraph" l10n="NEW">In ADDRESS, the parameter is inserted as the fourth parameter, shifting the optional sheet name parameter to the fifth position.</paragraph> + <paragraph xml-lang="en-US" id="par_id102720080230153" role="paragraph" l10n="NEW">In INDIRECT, the parameter is appended as the second parameter.</paragraph> + <paragraph xml-lang="en-US" id="par_id102720080230151" role="paragraph" l10n="NEW">In both functions, if the argument is inserted with the value 0, then the R1C1 notation is used. If the argument is not given or has a value other than 0, then the A1 notation is used. </paragraph> + <paragraph xml-lang="en-US" id="par_id1027200802301556" role="paragraph" l10n="NEW">In case of R1C1 notation, ADDRESS returns address strings using the exclamation mark '!' as the sheet name separator, and INDIRECT expects the exclamation mark as sheet name separator. Both functions still use the dot '.' sheet name separator with A1 notation.</paragraph> + <paragraph xml-lang="en-US" id="par_id1027200802301521" role="paragraph" l10n="NEW">When opening documents from ODF 1.0/1.1 format, the ADDRESS functions that show a sheet name as the fourth paramater will shift that sheet name to become the fifth parameter. A new fourth parameter with the value 1 will be inserted.</paragraph> + <paragraph xml-lang="en-US" id="par_id1027200802301650" role="paragraph" l10n="NEW">When storing a document in ODF 1.0/1.1 format, if ADDRESS functions have a fourth parameter, that parameter will be removed.</paragraph> + <paragraph xml-lang="en-US" id="par_id102720080230162" role="note" l10n="NEW">Do not save a spreadsheet in the old ODF 1.0/1.1 format if the ADDRESS function's new fourth parameter was used with a value of 0.</paragraph> + <paragraph xml-lang="en-US" id="par_id1027200802301756" role="note" l10n="NEW">The INDIRECT function is saved without conversion to ODF 1.0/1.1 format. If the second parameter was present, an older version of Calc will return an error for that function.</paragraph> + </section> + <paragraph xml-lang="en-US" id="hd_id3151196" role="heading" level="3" l10n="U" oldref="5">Syntax</paragraph> + <paragraph xml-lang="en-US" id="par_id3154707" role="code" l10n="U" oldref="6">ADDRESS(Row; Column; Abs; A1; "Sheet")</paragraph> + <paragraph xml-lang="en-US" id="par_id3147505" role="paragraph" l10n="U" oldref="7"> + <emph>Row</emph> represents the row number for the cell reference</paragraph> + <paragraph xml-lang="en-US" id="par_id3145323" role="paragraph" l10n="U" oldref="8"> + <emph>Column</emph> represents the column number for the cell reference (the number, not the letter)</paragraph> + <paragraph xml-lang="en-US" id="par_id3153074" role="paragraph" l10n="U" oldref="9"> + <emph>Abs</emph> determines the type of reference:</paragraph> + <paragraph xml-lang="en-US" id="par_id3153298" role="paragraph" l10n="CHG" oldref="10">1: absolute ($A$1)</paragraph> + <paragraph xml-lang="en-US" id="par_id3150431" role="paragraph" l10n="U" oldref="11">2: row reference type is absolute; column reference is relative (A$1)</paragraph> + <paragraph xml-lang="en-US" id="par_id3146096" role="paragraph" l10n="U" oldref="12">3: row (relative); column (absolute) ($A1)</paragraph> + <paragraph xml-lang="en-US" id="par_id3153334" role="paragraph" l10n="U" oldref="13">4: relative (A1)</paragraph> + <paragraph xml-lang="en-US" id="par_id1027200802465915" role="paragraph" l10n="NEW"> + <emph>A1</emph> (optional) - if set to 0, the R1C1 notation is used. If this parameter is absent or set to another value than 0, the A1 notation is used.</paragraph> + <paragraph xml-lang="en-US" id="par_id3153962" role="paragraph" l10n="U" oldref="14"> + <emph>Sheet</emph> represents the name of the sheet. It must be placed in double quotes.</paragraph> + <paragraph xml-lang="en-US" id="hd_id3147299" role="heading" level="3" l10n="U" + oldref="15">Example:</paragraph> + <paragraph xml-lang="en-US" id="par_id3148744" role="paragraph" l10n="CHG" oldref="16"> + <item type="input">=ADDRESS(1;1;2;;"Sheet2")</item> returns the following: Sheet2.A$1<comment>i 101187</comment></paragraph> + <paragraph xml-lang="en-US" id="par_id3159260" role="paragraph" l10n="U" oldref="17">If the cell A1 in sheet 2 contains the value <item type="input">-6</item>, you can refer indirectly to the referenced cell using a function in B2 by entering <item type="input">=ABS(INDIRECT(B2))</item>. The result is the absolute value of the cell reference specified in B2, which in this case is 6.</paragraph> + </section> + <section id="Section2"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3150372"><bookmark_value>AREAS function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_BEREICHE" id="bm_id3149721" localize="false"/> +<paragraph xml-lang="en-US" id="hd_id3150372" role="heading" level="2" l10n="U" + oldref="19">AREAS</paragraph> + <paragraph xml-lang="en-US" id="par_id3150036" role="paragraph" l10n="U" oldref="20"><ahelp hid="HID_FUNC_BEREICHE">Returns the number of individual ranges that belong to a multiple range.</ahelp> A range can consist of contiguous cells or a single cell.</paragraph> + <paragraph xml-lang="en-US" id="par_id061020090307073" role="paragraph" l10n="NEW">The function expects a single argument. If you state multiple ranges, you must enclose them into additional parentheses. Multiple ranges can be entered using the semicolon (;) as divider, but this gets automatically converted to the tilde (~) operator. The tilde is used to join ranges.</paragraph> + <paragraph xml-lang="en-US" id="hd_id3145222" role="heading" level="3" l10n="U" + oldref="21">Syntax</paragraph> + <paragraph xml-lang="en-US" id="par_id3155907" role="code" l10n="U" oldref="22">AREAS(Reference)</paragraph> + <paragraph xml-lang="en-US" id="par_id3153118" role="paragraph" l10n="U" oldref="23">Reference represents the reference to a cell or cell range.</paragraph> + <paragraph xml-lang="en-US" id="hd_id3148891" role="heading" level="3" l10n="U" + oldref="24">Example</paragraph> + <paragraph xml-lang="en-US" id="par_id3149946" role="paragraph" l10n="U" oldref="25"> + <item type="input">=AREAS((A1:B3;F2;G1))</item> returns 3, as it is a reference to three cells and/or areas. After entry this gets converted to =AREAS((A1:B3~F2~G1)).</paragraph> + <paragraph xml-lang="en-US" id="par_id3146820" role="paragraph" l10n="U" oldref="26"> + <item type="input">=AREAS(All)</item> returns 1 if you have defined an area named All under <emph>Data - Define Range</emph>.</paragraph> + </section> + <section id="Section3"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3148727"><bookmark_value>DDE function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_DDE" id="bm_id3154680" localize="false"/> +<paragraph xml-lang="en-US" id="hd_id3148727" role="heading" level="2" l10n="U" + oldref="28">DDE</paragraph> + <paragraph xml-lang="en-US" id="par_id3149434" role="paragraph" l10n="U" oldref="29"><ahelp hid="HID_FUNC_DDE">Returns the result of a DDE-based link.</ahelp> If the contents of the linked range or section changes, the returned value will also change. You must reload the spreadsheet or choose <emph>Edit - Links</emph> to see the updated links. Cross-platform links, for example from a <item type="productname">%PRODUCTNAME</item> installation running on a Windows machine to a document created on a Linux machine, are not allowed.</paragraph> + <paragraph xml-lang="en-US" id="hd_id3150700" role="heading" level="3" l10n="U" + oldref="30">Syntax</paragraph> + <paragraph xml-lang="en-US" id="par_id3148886" role="code" l10n="U" oldref="31">DDE("Server"; "File"; "Range"; Mode)</paragraph> + <paragraph xml-lang="en-US" id="par_id3154842" role="paragraph" l10n="U" oldref="32"> + <emph>Server</emph> is the name of a server application. <item type="productname">%PRODUCTNAME</item>applications have the server name "Soffice".</paragraph> + <paragraph xml-lang="en-US" id="par_id3153034" role="paragraph" l10n="U" oldref="33"> + <emph>File</emph> is the complete file name, including path specification.</paragraph> + <paragraph xml-lang="en-US" id="par_id3147472" role="paragraph" l10n="U" oldref="34"> + <emph>Range</emph> is the area containing the data to be evaluated.</paragraph> + <paragraph xml-lang="en-US" id="par_id3152773" role="paragraph" l10n="U" oldref="184"> + <emph>Mode</emph> is an optional parameter that controls the method by which the DDE server converts its data into numbers.</paragraph> + <table id="tbl_id3155828"> + <tablerow> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3154383" role="paragraph" l10n="U" oldref="185"> + <emph>Mode</emph> + </paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3145146" role="paragraph" l10n="U" oldref="186"> + <emph>Effect</emph> + </paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3154558" role="paragraph" l10n="U" oldref="187">0 or missing</paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3145596" role="paragraph" l10n="U" oldref="188">Number format from the "Default" cell style</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3152785" role="paragraph" l10n="U" oldref="189">1</paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3154380" role="paragraph" l10n="U" oldref="190">Data are always interpreted in the standard format for US English</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3150279" role="paragraph" l10n="U" oldref="191">2</paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3153775" role="paragraph" l10n="U" oldref="192">Data are retrieved as text; no conversion to numbers</paragraph> + </tablecell> + </tablerow> + </table> + + <paragraph xml-lang="en-US" id="hd_id3149546" role="heading" level="3" l10n="U" + oldref="35">Example</paragraph> + <paragraph xml-lang="en-US" id="par_id3148734" role="paragraph" l10n="U" oldref="36"> + <item type="input">=DDE("soffice";"c:\office\document\data1.sxc";"sheet1.A1")</item> reads the contents of cell A1 in sheet1 of the <item type="productname">%PRODUCTNAME</item> Calc spreadsheet data1.sxc.</paragraph> + <paragraph xml-lang="en-US" id="par_id3153081" role="paragraph" l10n="U" oldref="37"> + <item type="input">=DDE("soffice";"c:\office\document\motto.sxw";"Today's motto")</item> returns a motto in the cell containing this formula. First, you must enter a line in the motto.sxw document containing the motto text and define it as the first line of a section named <item type="literal">Today's Motto</item> (in <item type="productname">%PRODUCTNAME</item> Writer under <emph>Insert - Section</emph>). If the motto is modified (and saved) in the <item type="productname">%PRODUCTNAME</item> Writer document, the motto is updated in all <item type="productname">%PRODUCTNAME</item> Calc cells in which this DDE link is defined.</paragraph> + </section> + <section id="Section4"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3153114"><bookmark_value>ERRORTYPE function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_FEHLERTYP" id="bm_id3153000" localize="false"/> +<paragraph xml-lang="en-US" id="hd_id3153114" role="heading" level="2" l10n="U" + oldref="38">ERRORTYPE</paragraph> + <paragraph xml-lang="en-US" id="par_id3148568" role="paragraph" l10n="U" oldref="39"><ahelp hid="HID_FUNC_FEHLERTYP">Returns the number corresponding to an <link href="text/scalc/05/02140000.xhp" name="error value">error value</link> occurring in a different cell.</ahelp> With the aid of this number, you can generate an error message text.</paragraph> + <embed href="text/shared/00/00000001.xhp#wahr"/> + <paragraph xml-lang="en-US" id="par_id3149877" role="note" l10n="U" oldref="40">The Status Bar displays the predefined error code from <item type="productname">%PRODUCTNAME</item> if you click the cell containing the error.</paragraph> + <paragraph xml-lang="en-US" id="hd_id3154327" role="heading" level="3" l10n="U" + oldref="41">Syntax</paragraph> + <paragraph xml-lang="en-US" id="par_id3151322" role="code" l10n="U" oldref="42">ERRORTYPE(Reference)</paragraph> + <paragraph xml-lang="en-US" id="par_id3150132" role="paragraph" l10n="U" oldref="43"> + <emph>Reference</emph> contains the address of the cell in which the error occurs.</paragraph> + <paragraph xml-lang="en-US" id="hd_id3145248" role="heading" level="3" l10n="U" + oldref="44">Example</paragraph> + <paragraph xml-lang="en-US" id="par_id3146904" role="paragraph" l10n="U" oldref="45">If cell A1 displays Err:518, the function <item type="input">=ERRORTYPE(A1)</item> returns the number 518.</paragraph> + </section> + <section id="Section5"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3151221"><bookmark_value>INDEX function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_INDEX" id="bm_id3157989" localize="false"/> +<paragraph xml-lang="en-US" id="hd_id3151221" role="heading" level="2" l10n="U" + oldref="47">INDEX</paragraph> + <paragraph xml-lang="en-US" id="par_id3150268" role="paragraph" l10n="CHG" oldref="48"><ahelp hid="HID_FUNC_INDEX">INDEX returns a sub range, specified by row and column number, or an optional range index. Depending on context, INDEX returns a reference or content.</ahelp><comment>UFI: will change with i4904; see http://so-web.germany.sun.com/iBIS/servlet/edit.ControlPanel?tid=i57108</comment><comment>changed by i83070</comment></paragraph> + <paragraph xml-lang="en-US" id="hd_id3156063" role="heading" level="3" l10n="U" + oldref="49">Syntax</paragraph> + <paragraph xml-lang="en-US" id="par_id3149007" role="code" l10n="U" oldref="50">INDEX(Reference; Row; Column; Range)</paragraph> + <paragraph xml-lang="en-US" id="par_id3153260" role="paragraph" l10n="CHG" oldref="51"> + <emph>Reference</emph> is a reference, entered either directly or by specifying a range name. If the reference consists of multiple ranges, you must enclose the reference or range name in parentheses.</paragraph> + <paragraph xml-lang="en-US" id="par_id3145302" role="paragraph" l10n="CHG" oldref="52"> + <emph>Row</emph> (optional) represents the row index of the reference range, for which to return a value. In case of zero (no specific row) all referenced rows are returned.</paragraph> + <paragraph xml-lang="en-US" id="par_id3154628" role="paragraph" l10n="CHG" oldref="53"> + <emph>Column</emph> (optional) represents the column index of the reference range, for which to return a value. In case of zero (no specific column) all referenced columns are returned.</paragraph> + <paragraph xml-lang="en-US" id="par_id3155514" role="paragraph" l10n="U" oldref="54"> + <emph>Range</emph> (optional) represents the index of the subrange if referring to a multiple range.</paragraph> + <paragraph xml-lang="en-US" id="hd_id3145264" role="heading" level="3" l10n="U" + oldref="55">Example</paragraph> + <paragraph xml-lang="en-US" id="par_id3159112" role="paragraph" l10n="U" oldref="56"> + <item type="input">=INDEX(Prices;4;1)</item> returns the value from row 4 and column 1 of the database range defined in <emph>Data - Define</emph> as <emph>Prices</emph>.</paragraph> + <paragraph xml-lang="en-US" id="par_id3150691" role="paragraph" l10n="U" oldref="57"> + <item type="input">=INDEX(SumX;4;1)</item> returns the value from the range <emph>SumX</emph> in row 4 and column 1 as defined in <emph>Insert - Names - Define</emph>.</paragraph> + <paragraph xml-lang="en-US" id="par_id4109012" role="paragraph" l10n="NEW"> + <item type="input">=INDEX(A1:B6;1)</item> returns a reference to the first row of A1:B6.</paragraph> + <paragraph xml-lang="en-US" id="par_id9272133" role="paragraph" l10n="NEW"> + <item type="input">=INDEX(A1:B6;0;1)</item> returns a reference to the first column of A1:B6.</paragraph> + <paragraph xml-lang="en-US" id="par_id3158419" role="paragraph" l10n="U" oldref="58"> + <item type="input">=INDEX((multi);4;1)</item> indicates the value contained in row 4 and column 1 of the (multiple) range, which you named under <emph>Insert - Names - Define</emph> as <emph>multi</emph>. The multiple range may consist of several rectangular ranges, each with a row 4 and column 1. If you now want to call the second block of this multiple range enter the number <item type="input">2</item> as the <emph>range</emph> parameter.</paragraph> + <paragraph xml-lang="en-US" id="par_id3148595" role="paragraph" l10n="U" oldref="59"> + <item type="input">=INDEX(A1:B6;1;1)</item> indicates the value in the upper-left of the A1:B6 range.</paragraph> + <paragraph xml-lang="en-US" id="par_id9960020" role="paragraph" l10n="NEW"> + <item type="input">=INDEX((multi);0;0;2)</item> returns a reference to the second range of the multiple range.</paragraph> + </section> + <section id="Section6"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3153181"><bookmark_value>INDIRECT function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_INDIREKT" id="bm_id3153922" localize="false"/> +<paragraph xml-lang="en-US" id="hd_id3153181" role="heading" level="2" l10n="U" + oldref="62">INDIRECT</paragraph> + <paragraph xml-lang="en-US" id="par_id3147169" role="paragraph" l10n="U" oldref="63"><ahelp hid="HID_FUNC_INDIREKT">Returns the <emph>reference</emph> specified by a text string.</ahelp> This function can also be used to return the area of a corresponding string.</paragraph> + <embed href="text/scalc/01/04060109.xhp#r1c1"/> + <paragraph xml-lang="en-US" id="hd_id3153717" role="heading" level="3" l10n="U" + oldref="64">Syntax</paragraph> + <paragraph xml-lang="en-US" id="par_id3149824" role="code" l10n="U" oldref="65">INDIRECT(Ref; A1)</paragraph> + <paragraph xml-lang="en-US" id="par_id3154317" role="paragraph" l10n="U" oldref="66"> + <emph>Ref</emph> represents a reference to a cell or an area (in text form) for which to return the contents.</paragraph> + <paragraph xml-lang="en-US" id="par_id1027200802470312" role="paragraph" l10n="NEW"> + <emph>A1</emph> (optional) - if set to 0, the R1C1 notation is used. If this parameter is absent or set to another value than 0, the A1 notation is used.</paragraph> + <paragraph xml-lang="en-US" id="par_idN10CAE" role="note" l10n="NEW">If you open an Excel spreadsheet that uses indirect addresses calculated from string functions, the sheet addresses will not be translated automatically. For example, the Excel address in INDIRECT("filename!sheetname"&B1) is not converted into the Calc address in INDIRECT("filename.sheetname"&B1).<comment>UFI: for #i34465#</comment></paragraph> + <paragraph xml-lang="en-US" id="hd_id3150389" role="heading" level="3" l10n="U" + oldref="67">Example</paragraph> + <paragraph xml-lang="en-US" id="par_id3150608" role="paragraph" l10n="U" oldref="68"> + <item type="input">=INDIRECT(A1)</item> equals 100 if A1 contains C108 as a reference and cell C108 contains a value of <item type="input">100</item>.</paragraph> + <paragraph xml-lang="en-US" id="par_id3083286" role="paragraph" l10n="CHG" oldref="181"> + <item type="input">=SUM(INDIRECT("a1:" & ADDRESS(1;3)))</item> totals the cells in the area of A1 up to the cell with the address defined by row 1 and column 3. This means that area A1:C1 is totaled.</paragraph> + </section> + <section id="Section7"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3154818"><bookmark_value>COLUMN function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_SPALTE" id="bm_id3156378" localize="false"/> +<paragraph xml-lang="en-US" id="hd_id3154818" role="heading" level="2" l10n="U" + oldref="70">COLUMN</paragraph> + <paragraph xml-lang="en-US" id="par_id3149711" role="paragraph" l10n="U" oldref="193"><ahelp hid="HID_FUNC_SPALTE">Returns the column number of a cell reference.</ahelp> If the reference is a cell the column number of the cell is returned; if the parameter is a cell area, the corresponding column numbers are returned in a single-row <link href="text/scalc/01/04060107.xhp#wasmatrix" name="array">array</link> if the formula is entered <link href="text/scalc/01/04060107.xhp#somatrixformel" name="as an array formula">as an array formula</link>. If the COLUMN function with an area reference parameter is not used for an array formula, only the column number of the first cell within the area is determined.</paragraph> + <paragraph xml-lang="en-US" id="hd_id3149283" role="heading" level="3" l10n="U" + oldref="72">Syntax</paragraph> + <paragraph xml-lang="en-US" id="par_id3149447" role="code" l10n="U" oldref="73">COLUMN(Reference)</paragraph> + <paragraph xml-lang="en-US" id="par_id3156310" role="paragraph" l10n="U" oldref="74"> + <emph>Reference</emph> is the reference to a cell or cell area whose first column number is to be found.</paragraph> + <paragraph xml-lang="en-US" id="par_id3155837" role="paragraph" l10n="U" oldref="194">If no reference is entered, the column number of the cell in which the formula is entered is found. <item type="productname">%PRODUCTNAME</item> Calc automatically sets the reference to the current cell.</paragraph> + <paragraph xml-lang="en-US" id="hd_id3152932" role="heading" level="3" l10n="U" + oldref="75">Example</paragraph> + <paragraph xml-lang="en-US" id="par_id3147571" role="paragraph" l10n="U" oldref="76"> + <item type="input">=COLUMN(A1)</item> equals 1. Column A is the first column in the table.</paragraph> + <paragraph xml-lang="en-US" id="par_id3147079" role="paragraph" l10n="U" oldref="77"> + <item type="input">=COLUMN(C3:E3)</item> equals 3. Column C is the third column in the table.</paragraph> + <paragraph xml-lang="en-US" id="par_id3146861" role="paragraph" l10n="U" oldref="195"> + <item type="input">=COLUMN(D3:G10)</item> returns 4 because column D is the fourth column in the table and the COLUMN function is not used as an array formula. (In this case, the first value of the array is always used as the result.)</paragraph> + <paragraph xml-lang="en-US" id="par_id3156320" role="paragraph" l10n="U" oldref="196"> + <item type="input">{=COLUMN(B2:B7)}</item> and <item type="input">=COLUMN(B2:B7)</item> both return 2 because the reference only contains column B as the second column in the table. Because single-column areas have only one column number, it does not make a difference whether or not the formula is used as an array formula.</paragraph> + <paragraph xml-lang="en-US" id="par_id3150872" role="paragraph" l10n="U" oldref="197"> + <item type="input">=COLUMN()</item> returns 3 if the formula was entered in column C.</paragraph> + <paragraph xml-lang="en-US" id="par_id3153277" role="paragraph" l10n="U" oldref="198"> + <item type="input">{=COLUMN(Rabbit)}</item> returns the single-row array (3, 4) if "Rabbit" is the named area (C1:D3).</paragraph> + </section> + <section id="Section8"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3154643"><bookmark_value>COLUMNS function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_SPALTEN" id="bm_id3156134" localize="false"/> +<paragraph xml-lang="en-US" id="hd_id3154643" role="heading" level="2" l10n="U" + oldref="79">COLUMNS</paragraph> + <paragraph xml-lang="en-US" id="par_id3151182" role="paragraph" l10n="U" oldref="80"><ahelp hid="HID_FUNC_SPALTEN">Returns the number of columns in the given reference.</ahelp></paragraph> + <paragraph xml-lang="en-US" id="hd_id3149141" role="heading" level="3" l10n="U" + oldref="81">Syntax</paragraph> + <paragraph xml-lang="en-US" id="par_id3154047" role="code" l10n="U" oldref="82">COLUMNS(Array)</paragraph> + <paragraph xml-lang="en-US" id="par_id3154745" role="paragraph" l10n="U" oldref="83"> + <emph>Array</emph> is the reference to a cell range whose total number of columns is to be found. The argument can also be a single cell.</paragraph> + <paragraph xml-lang="en-US" id="hd_id3153622" role="heading" level="3" l10n="U" + oldref="84">Example</paragraph> + <paragraph xml-lang="en-US" id="par_id3149577" role="paragraph" l10n="U" oldref="200"> + <item type="input">=COLUMNS(B5)</item> returns 1 because a cell only contains one column.</paragraph> + <paragraph xml-lang="en-US" id="par_id3145649" role="paragraph" l10n="U" oldref="85"> + <item type="input">=COLUMNS(A1:C5)</item> equals 3. The reference comprises three columns.</paragraph> + <paragraph xml-lang="en-US" id="par_id3155846" role="paragraph" l10n="U" oldref="201"> + <item type="input">=COLUMNS(Rabbit)</item> returns 2 if <item type="literal">Rabbit</item> is the named range (C1:D3).</paragraph> + </section> + <section id="Section9"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3153152"><bookmark_value>vertical search function</bookmark_value> + <bookmark_value>VLOOKUP function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_SVERWEIS" id="bm_id3152809" localize="false"/> +<paragraph xml-lang="en-US" id="hd_id3153152" role="heading" level="2" l10n="U" + oldref="87">VLOOKUP</paragraph> + <paragraph xml-lang="en-US" id="par_id3149984" role="paragraph" l10n="CHG" oldref="88"><ahelp hid="HID_FUNC_SVERWEIS">Vertical search with reference to adjacent cells to the right.</ahelp> This function checks if a specific value is contained in the first column of an array. The function then returns the value in the same row of the column named by <item type="literal">Index</item>. If the <item type="literal">SortOrder</item> parameter is omitted or set to TRUE or one, it is assumed that the data is sorted in ascending order. In this case, if the exact <item type="literal">SearchCriterion</item> is not found, the last value that is smaller than the criterion will be returned. If <item type="literal">SortOrder</item> is set to FALSE or zero, an exact match must be found, otherwise the error <emph>Error: Value Not Available</emph> will be the result. Thus with a value of zero the data does not need to be sorted in ascending order.</paragraph> + <embed href="text/shared/00/00000001.xhp#regulaer"/> + <paragraph xml-lang="en-US" id="hd_id3146898" role="heading" level="3" l10n="U" + oldref="89">Syntax</paragraph> + <paragraph xml-lang="en-US" id="par_id3150156" role="code" l10n="U" oldref="90">=VLOOKUP(SearchCriterion; Array; Index; SortOrder)</paragraph> + <paragraph xml-lang="en-US" id="par_id3149289" role="paragraph" l10n="U" oldref="91"> + <emph>SearchCriterion</emph> is the value searched for in the first column of the array.</paragraph> + <paragraph xml-lang="en-US" id="par_id3153884" role="paragraph" l10n="U" oldref="92"> + <emph>Array</emph> is the reference, which is to comprise at least two columns.</paragraph> + <paragraph xml-lang="en-US" id="par_id3156005" role="paragraph" l10n="U" oldref="93"> + <emph>Index</emph> is the number of the column in the array that contains the value to be returned. The first column has the number 1.</paragraph> + <paragraph xml-lang="en-US" id="par_id3151208" role="paragraph" l10n="U" oldref="94"> + <emph>SortOrder</emph> is an optional parameter that indicates whether the first column in the array is sorted in ascending order. Enter the Boolean value FALSE or zero if the first column is not sorted in ascending order. Sorted columns can be searched much faster and the function always returns a value, even if the search value was not matched exactly, if it is between the lowest and highest value of the sorted list. In unsorted lists, the search value must be matched exactly. Otherwise the function will return this message: <emph>Error: Value Not Available</emph>.</paragraph> + <embed href="text/scalc/05/empty_cells.xhp#empty_cells"/> + <paragraph xml-lang="en-US" id="hd_id3147487" role="heading" level="3" l10n="U" + oldref="95">Example</paragraph> + <paragraph xml-lang="en-US" id="par_id3154129" role="paragraph" l10n="U" oldref="96">You want to enter the number of a dish on the menu in cell A1, and the name of the dish is to appear as text in the neighboring cell (B1) immediately. The Number to Name assignment is contained in the D1:E100 array. D1 contains <item type="input">100</item>, E1 contains the name <item type="input">Vegetable Soup</item>, and so forth, for 100 menu items. The numbers in column D are sorted in ascending order; thus, the optional <item type="literal">SortOrder</item> parameter is not necessary.</paragraph> + <paragraph xml-lang="en-US" id="par_id3145663" role="paragraph" l10n="U" oldref="97">Enter the following formula in B1:</paragraph> + <paragraph xml-lang="en-US" id="par_id3151172" role="paragraph" l10n="U" oldref="98"> + <item type="input">=VLOOKUP(A1;D1:E100;2)</item> + </paragraph> + <paragraph xml-lang="en-US" id="par_id3149200" role="paragraph" l10n="U" oldref="99">As soon as you enter a number in A1 B1 will show the corresponding text contained in the second column of reference D1:E100. Entering a nonexistent number displays the text with the next number down. To prevent this, enter FALSE as the last parameter in the formula so that an error message is generated when a nonexistent number is entered.</paragraph> + </section> + <section id="Section10"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3153905"><bookmark_value>sheet numbers; looking up</bookmark_value> + <bookmark_value>SHEET function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_TABELLE" id="bm_id3154693" localize="false"/> +<paragraph xml-lang="en-US" id="hd_id3153905" role="heading" level="2" l10n="U" + oldref="215">SHEET</paragraph> + <paragraph xml-lang="en-US" id="par_id3150309" role="paragraph" l10n="U" oldref="216"><ahelp hid="HID_FUNC_TABELLE">Returns the sheet number of a reference or a string representing a sheet name.</ahelp> If you do not enter any parameters, the result is the sheet number of the spreadsheet containing the formula.</paragraph> + <paragraph xml-lang="en-US" id="hd_id3148564" role="heading" level="3" l10n="U" + oldref="217">Syntax</paragraph> + <paragraph xml-lang="en-US" id="par_id3153095" role="code" l10n="U" oldref="218">SHEET(Reference)</paragraph> + <paragraph xml-lang="en-US" id="par_id3154588" role="paragraph" l10n="U" oldref="219"> + <emph>Reference</emph> is optional and is the reference to a cell, an area, or a sheet name string.</paragraph> + <paragraph xml-lang="en-US" id="hd_id3155399" role="heading" level="3" l10n="U" + oldref="220">Example</paragraph> + <paragraph xml-lang="en-US" id="par_id3146988" role="paragraph" l10n="U" oldref="221"> + <item type="input">=SHEET(Sheet2.A1)</item> returns 2 if Sheet2 is the second sheet in the spreadsheet document.</paragraph> + </section> + <section id="Section11"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3148829"><bookmark_value>number of sheets; function</bookmark_value> + <bookmark_value>SHEETS function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_TABELLEN" id="bm_id3150524" localize="false"/> +<paragraph xml-lang="en-US" id="hd_id3148829" role="heading" level="2" l10n="U" + oldref="222">SHEETS</paragraph> + <paragraph xml-lang="en-US" id="par_id3148820" role="paragraph" l10n="U" oldref="223"><ahelp hid="HID_FUNC_TABELLEN">Determines the number of sheets in a reference.</ahelp> If you do not enter any parameters, it returns the number of sheets in the current document.</paragraph> + <paragraph xml-lang="en-US" id="hd_id3154220" role="heading" level="3" l10n="U" + oldref="224">Syntax</paragraph> + <paragraph xml-lang="en-US" id="par_id3150777" role="code" l10n="U" oldref="225">SHEETS(Reference)</paragraph> + <paragraph xml-lang="en-US" id="par_id3153060" role="paragraph" l10n="U" oldref="226"> + <emph>Reference</emph> is the reference to a sheet or an area. This parameter is optional.</paragraph> + <paragraph xml-lang="en-US" id="hd_id3149766" role="heading" level="3" l10n="U" + oldref="227">Example</paragraph> + <paragraph xml-lang="en-US" id="par_id3150507" role="paragraph" l10n="U" oldref="228"> + <item type="input">=SHEETS(Sheet1.A1:Sheet3.G12)</item> returns 3 if Sheet1, Sheet2, and Sheet3 exist in the sequence indicated.</paragraph> + </section> + <section id="Section12"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3158407"><bookmark_value>MATCH function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_VERGLEICH" id="bm_id3154210" localize="false"/> +<paragraph xml-lang="en-US" id="hd_id3158407" role="heading" level="2" l10n="U" + oldref="101">MATCH</paragraph> + <paragraph xml-lang="en-US" id="par_id3154896" role="paragraph" l10n="U" oldref="102"><ahelp hid="HID_FUNC_VERGLEICH">Returns the relative position of an item in an array that matches a specified value.</ahelp> The function returns the position of the value found in the lookup_array as a number.</paragraph> + <paragraph xml-lang="en-US" id="hd_id3153834" role="heading" level="3" l10n="U" + oldref="103">Syntax</paragraph> + <paragraph xml-lang="en-US" id="par_id3159152" role="code" l10n="U" oldref="104">MATCH(SearchCriterion; LookupArray; Type)</paragraph> + <paragraph xml-lang="en-US" id="par_id3149336" role="paragraph" l10n="U" oldref="105"> + <emph>SearchCriterion</emph> is the value which is to be searched for in the single-row or single-column array.</paragraph> + <paragraph xml-lang="en-US" id="par_id3159167" role="paragraph" l10n="U" oldref="106"> + <emph>LookupArray</emph> is the reference searched. A lookup array can be a single row or column, or part of a single row or column.</paragraph> + <paragraph xml-lang="en-US" id="par_id3147239" role="paragraph" l10n="U" oldref="107"> + <emph>Type</emph> may take the values 1, 0, or -1. If Type = 1 or if this optional parameter is missing, it is assumed that the first column of the search array is sorted in ascending order. If Type = -1 it is assumed that the column in sorted in descending order. This corresponds to the same function in Microsoft Excel.</paragraph> + <paragraph xml-lang="en-US" id="par_id3154265" role="paragraph" l10n="CHG" oldref="231">If Type = 0, only exact matches are found. If the search criterion is found more than once, the function returns the index of the first matching value. Only if Type = 0 can you search for regular expressions.</paragraph> + <paragraph xml-lang="en-US" id="par_id3147528" role="paragraph" l10n="CHG" oldref="232">If Type = 1 or the third parameter is missing, the index of the last value that is smaller or equal to the search criterion is returned. This applies even when the search array is not sorted. For Type = -1, the first value that is larger or equal is returned.</paragraph> + <embed href="text/shared/00/00000001.xhp#regulaer"/> + <paragraph xml-lang="en-US" id="hd_id3155119" role="heading" level="3" l10n="U" + oldref="108">Example</paragraph> + <paragraph xml-lang="en-US" id="par_id3155343" role="paragraph" l10n="U" oldref="109"> + <item type="input">=MATCH(200;D1:D100)</item> searches the area D1:D100, which is sorted by column D, for the value 200. As soon as this value is reached, the number of the row in which it was found is returned. If a higher value is found during the search in the column, the number of the previous row is returned.</paragraph> + </section> + <section id="Section13"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3158430"><bookmark_value>OFFSET function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_VERSCHIEBUNG" id="bm_id3148926" localize="false"/> +<paragraph xml-lang="en-US" id="hd_id3158430" role="heading" level="2" l10n="U" + oldref="111">OFFSET</paragraph> + <paragraph xml-lang="en-US" id="par_id3149167" role="paragraph" l10n="U" oldref="112"><ahelp hid="HID_FUNC_VERSCHIEBUNG">Returns the value of a cell offset by a certain number of rows and columns from a given reference point.</ahelp></paragraph> + <paragraph xml-lang="en-US" id="hd_id3146952" role="heading" level="3" l10n="U" + oldref="113">Syntax</paragraph> + <paragraph xml-lang="en-US" id="par_id3159194" role="code" l10n="U" oldref="114">OFFSET(Reference; Rows; Columns; Height; Width)</paragraph> + <paragraph xml-lang="en-US" id="par_id3152360" role="paragraph" l10n="CHG" oldref="115"> + <emph>Reference</emph> is the reference from which the function searches for the new reference.</paragraph> + <paragraph xml-lang="en-US" id="par_id3156032" role="paragraph" l10n="CHG" oldref="116"> + <emph>Rows</emph> is the number of rows by which the reference was corrected up (negative value) or down.</paragraph> + <paragraph xml-lang="en-US" id="par_id3166458" role="paragraph" l10n="CHG" oldref="117"> + <emph>Columns</emph> (optional) is the number of columns by which the reference was corrected to the left (negative value) or to the right.</paragraph> + <paragraph xml-lang="en-US" id="par_id3150708" role="paragraph" l10n="CHG" oldref="118"> + <emph>Height</emph> (optional) is the vertical height for an area that starts at the new reference position.</paragraph> + <paragraph xml-lang="en-US" id="par_id3147278" role="paragraph" l10n="CHG" oldref="119"> + <emph>Width</emph> (optional) is the horizontal width for an area that starts at the new reference position.</paragraph> + <paragraph xml-lang="en-US" id="par_id8662373" role="paragraph" l10n="CHG">Arguments <emph>Rows</emph> and <emph>Columns</emph> must not lead to zero or negative start row or column.</paragraph> + <paragraph xml-lang="en-US" id="par_id9051484" role="paragraph" l10n="NEW">Arguments <emph>Height</emph> and <emph>Width</emph> must not lead to zero or negative count of rows or columns.</paragraph> + <paragraph xml-lang="en-US" id="par_idN1104B" role="paragraph" l10n="NEW"> + <embedvar href="text/scalc/00/00000004.xhp#optional"/> + </paragraph> + <paragraph xml-lang="en-US" id="hd_id3155586" role="heading" level="3" l10n="U" + oldref="120">Example</paragraph> + <paragraph xml-lang="en-US" id="par_id3149744" role="paragraph" l10n="CHG" oldref="121"> + <item type="input">=OFFSET(A1;2;2)</item> returns the value in cell C3 (A1 moved by two rows and two columns down). If C3 contains the value <item type="input">100</item> this function returns the value 100.</paragraph> + <paragraph xml-lang="en-US" id="par_id7439802" role="paragraph" l10n="NEW"> + <item type="input">=OFFSET(B2:C3;1;1)</item> returns a reference to B2:C3 moved down by 1 row and one column to the right (C3:D4).</paragraph> + <paragraph xml-lang="en-US" id="par_id3009430" role="paragraph" l10n="NEW"> + <item type="input">=OFFSET(B2:C3;-1;-1)</item> returns a reference to B2:C3 moved up by 1 row and one column to the left (A1:B2).</paragraph> + <paragraph xml-lang="en-US" id="par_id2629169" role="paragraph" l10n="NEW"> + <item type="input">=OFFSET(B2:C3;0;0;3;4)</item> returns a reference to B2:C3 resized to 3 rows and 4 columns (B2:E4).</paragraph> + <paragraph xml-lang="en-US" id="par_id6668599" role="paragraph" l10n="NEW"> + <item type="input">=OFFSET(B2:C3;1;0;3;4)</item> returns a reference to B2:C3 moved down by one row resized to 3 rows and 4 columns (B2:E4).</paragraph> + <paragraph xml-lang="en-US" id="par_id3153739" role="paragraph" l10n="U" oldref="122"> + <item type="input">=SUM(OFFSET(A1;2;2;5;6))</item> determines the total of the area that starts in cell C3 and has a height of 5 rows and a width of 6 columns (area=C3:H7).</paragraph> + </section> + <section id="Section14"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3159273"><bookmark_value>LOOKUP function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_VERWEIS" id="bm_id3152877" localize="false"/> +<paragraph xml-lang="en-US" id="hd_id3159273" role="heading" level="2" l10n="U" + oldref="123">LOOKUP</paragraph> + <paragraph xml-lang="en-US" id="par_id3153389" role="paragraph" l10n="CHG" oldref="124"><ahelp hid="HID_FUNC_VERWEIS">Returns the contents of a cell either from a one-row or one-column range.</ahelp> Optionally, the assigned value (of the same index) is returned in a different column and row. As opposed to <link href="text/scalc/01/04060109.xhp" name="VLOOKUP">VLOOKUP</link> and <link href="text/scalc/01/04060109.xhp" name="HLOOKUP">HLOOKUP</link>, search and result vector may be at different positions; they do not have to be adjacent. Additionally, the search vector for the LOOKUP must be sorted ascending, otherwise the search will not return any usable results.</paragraph> + <paragraph xml-lang="en-US" id="par_id4484084" role="note" l10n="NEW">If LOOKUP cannot find the search criterion, it matches the largest value in the search vector that is less than or equal to the search criterion.</paragraph> + <embed href="text/shared/00/00000001.xhp#regulaer"/> + <paragraph xml-lang="en-US" id="hd_id3152947" role="heading" level="3" l10n="U" + oldref="125">Syntax</paragraph> + <paragraph xml-lang="en-US" id="par_id3154104" role="code" l10n="U" oldref="126">LOOKUP(SearchCriterion; SearchVector; ResultVector)</paragraph> + <paragraph xml-lang="en-US" id="par_id3150646" role="paragraph" l10n="U" oldref="127"> + <emph>SearchCriterion</emph> is the value to be searched for; entered either directly or as a reference.</paragraph> + <paragraph xml-lang="en-US" id="par_id3154854" role="paragraph" l10n="U" oldref="128"> + <emph>SearchVector</emph> is the single-row or single-column area to be searched.</paragraph> + <paragraph xml-lang="en-US" id="par_id3149925" role="paragraph" l10n="U" oldref="129"> + <emph>ResultVector</emph> is another single-row or single-column range from which the result of the function is taken. The result is the cell of the result vector with the same index as the instance found in the search vector.</paragraph> + <embed href="text/scalc/05/empty_cells.xhp#empty_cells"/> + <paragraph xml-lang="en-US" id="hd_id3148624" role="heading" level="3" l10n="U" + oldref="130">Example</paragraph> + <paragraph xml-lang="en-US" id="par_id3149809" role="paragraph" l10n="U" oldref="131"> + <item type="input">=LOOKUP(A1;D1:D100;F1:F100)</item> searches the corresponding cell in range D1:D100 for the number you entered in A1. For the instance found, the index is determined, for example, the 12th cell in this range. Then, the contents of the 12th cell are returned as the value of the function (in the result vector).</paragraph> + </section> + <section id="Section15"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3149425"><bookmark_value>STYLE function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_VORLAGE" id="bm_id3154342" localize="false"/> +<paragraph xml-lang="en-US" id="hd_id3149425" role="heading" level="2" l10n="U" + oldref="133">STYLE</paragraph> + <paragraph xml-lang="en-US" id="par_id3150826" role="paragraph" l10n="U" oldref="134"><ahelp hid="HID_FUNC_VORLAGE">Applies a style to the cell containing the formula.</ahelp> After a set amount of time, another style can be applied. This function always returns the value 0, allowing you to add it to another function without changing the value. Together with the CURRENT function you can apply a color to a cell regardless of the value. For example: =...+STYLE(IF(CURRENT()>3;"red";"green")) applies the style "red" to the cell if the value is greater than 3, otherwise the style "green" is applied. Both cell formats have to be defined beforehand.</paragraph> + <paragraph xml-lang="en-US" id="hd_id3145373" role="heading" level="3" l10n="U" + oldref="135">Syntax</paragraph> + <paragraph xml-lang="en-US" id="par_id3149302" role="code" l10n="U" oldref="136">STYLE("Style"; Time; "Style2")</paragraph> + <paragraph xml-lang="en-US" id="par_id3150596" role="paragraph" l10n="U" oldref="137"> + <emph>Style</emph> is the name of a cell style assigned to the cell. Style names must be entered in quotation marks.</paragraph> + <paragraph xml-lang="en-US" id="par_id3156149" role="paragraph" l10n="U" oldref="138"> + <emph>Time</emph> is an optional time range in seconds. If this parameter is missing the style will not be changed after a certain amount of time has passed.</paragraph> + <paragraph xml-lang="en-US" id="par_id3149520" role="paragraph" l10n="U" oldref="139"> + <emph>Style2</emph> is the optional name of a cell style assigned to the cell after a certain amount of time has passed. If this parameter is missing "Default" is assumed.</paragraph> + <paragraph xml-lang="en-US" id="par_idN111CA" role="paragraph" l10n="NEW"> + <embedvar href="text/scalc/00/00000004.xhp#optional"/> + </paragraph> + <paragraph xml-lang="en-US" id="hd_id3159254" role="heading" level="3" l10n="U" + oldref="140">Example</paragraph> + <paragraph xml-lang="en-US" id="par_id3151374" role="paragraph" l10n="U" oldref="141"> + <item type="input">=STYLE("Invisible";60;"Default")</item> formats the cell in transparent format for 60 seconds after the document was recalculated or loaded, then the Default format is assigned. Both cell formats have to be defined beforehand.</paragraph> + <paragraph xml-lang="en-US" id="par_id8056886" role="paragraph" l10n="NEW">Since STYLE() has a numeric return value of zero, this return value gets appended to a string. This can be avoided using T() as in the following example </paragraph> + <paragraph xml-lang="en-US" id="par_id3668935" role="paragraph" l10n="NEW"> + <item type="input">="Text"&T(STYLE("myStyle"))</item> + </paragraph> + <paragraph xml-lang="en-US" id="par_id3042085" role="paragraph" l10n="NEW">See also CURRENT() for another example.</paragraph> + </section> + <section id="Section16"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3150430"><bookmark_value>CHOOSE function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_WAHL" id="bm_id3153947" localize="false"/> +<paragraph xml-lang="en-US" id="hd_id3150430" role="heading" level="2" l10n="U" + oldref="142">CHOOSE</paragraph> + <paragraph xml-lang="en-US" id="par_id3143270" role="paragraph" l10n="U" oldref="143"><ahelp hid="HID_FUNC_WAHL">Uses an index to return a value from a list of up to 30 values.</ahelp></paragraph> + <paragraph xml-lang="en-US" id="hd_id3153533" role="heading" level="3" l10n="U" + oldref="144">Syntax</paragraph> + <paragraph xml-lang="en-US" id="par_id3155425" role="code" l10n="U" oldref="145">CHOOSE(Index; Value1; ...; Value30)</paragraph> + <paragraph xml-lang="en-US" id="par_id3144755" role="paragraph" l10n="U" oldref="146"> + <emph>Index</emph> is a reference or number between 1 and 30 indicating which value is to be taken from the list.</paragraph> + <paragraph xml-lang="en-US" id="par_id3149939" role="paragraph" l10n="U" oldref="147"> + <emph>Value1...Value30</emph> is the list of values entered as a reference to a cell or as individual values.</paragraph> + <paragraph xml-lang="en-US" id="hd_id3151253" role="heading" level="3" l10n="U" + oldref="148">Example</paragraph> + <paragraph xml-lang="en-US" id="par_id3150625" role="paragraph" l10n="U" oldref="149"> + <item type="input">=CHOOSE(A1;B1;B2;B3;"Today";"Yesterday";"Tomorrow")</item>, for example, returns the contents of cell B2 for A1 = 2; for A1 = 4, the function returns the text "Today".</paragraph> + </section> + <section id="Section17"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3151001"><bookmark_value>HLOOKUP function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_WVERWEIS" id="bm_id3149481" localize="false"/> +<paragraph xml-lang="en-US" id="hd_id3151001" role="heading" level="2" l10n="U" + oldref="151">HLOOKUP</paragraph> + <paragraph xml-lang="en-US" id="par_id3148688" role="paragraph" l10n="U" oldref="152"><ahelp hid="HID_FUNC_WVERWEIS">Searches for a value and reference to the cells below the selected area.</ahelp> This function verifies if the first row of an array contains a certain value. The function returns then the value in a row of the array, named in the <emph>Index</emph>, in the same column.</paragraph> + <embed href="text/shared/00/00000001.xhp#regulaer"/> + <paragraph xml-lang="en-US" id="hd_id3154661" role="heading" level="3" l10n="U" + oldref="153">Syntax</paragraph> + <paragraph xml-lang="en-US" id="par_id3146070" role="code" l10n="U" oldref="154">HLOOKUP(SearchCriteria; Array; Index; Sorted)</paragraph> + <paragraph xml-lang="en-US" id="par_id3148672" role="paragraph" l10n="U" oldref="155">See also:<link href="text/scalc/01/04060109.xhp" name="VLOOKUP">VLOOKUP</link> (columns and rows are exchanged)</paragraph> + <embed href="text/scalc/05/empty_cells.xhp#empty_cells"/> + </section> + <section id="Section18"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3147321"><bookmark_value>ROW function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_ZEILE" id="bm_id3147333" localize="false"/> +<paragraph xml-lang="en-US" id="hd_id3147321" role="heading" level="2" l10n="U" + oldref="157">ROW</paragraph> + <paragraph xml-lang="en-US" id="par_id3154564" role="paragraph" l10n="U" oldref="203"><ahelp hid="HID_FUNC_ZEILE">Returns the row number of a cell reference.</ahelp> If the reference is a cell, it returns the row number of the cell. If the reference is a cell range, it returns the corresponding row numbers in a one-column <link href="text/scalc/01/04060107.xhp#wasmatrix" name="Array">Array</link> if the formula is entered <link href="text/scalc/01/04060107.xhp#somatrixformel" name="as an array formula">as an array formula</link>. If the ROW function with a range reference is not used in an array formula, only the row number of the first range cell will be returned.</paragraph> + <paragraph xml-lang="en-US" id="hd_id3158439" role="heading" level="3" l10n="U" + oldref="159">Syntax</paragraph> + <paragraph xml-lang="en-US" id="par_id3154916" role="code" l10n="U" oldref="160">ROW(Reference)</paragraph> + <paragraph xml-lang="en-US" id="par_id3156336" role="paragraph" l10n="U" oldref="161"> + <emph>Reference</emph> is a cell, an area, or the name of an area.</paragraph> + <paragraph xml-lang="en-US" id="par_id3151109" role="paragraph" l10n="U" oldref="204">If you do not indicate a reference, the row number of the cell in which the formula is entered will be found. <item type="productname">%PRODUCTNAME</item> Calc automatically sets the reference to the current cell.</paragraph> + <paragraph xml-lang="en-US" id="hd_id3155609" role="heading" level="3" l10n="U" + oldref="162">Example</paragraph> + <paragraph xml-lang="en-US" id="par_id3154830" role="paragraph" l10n="U" oldref="205"> + <item type="input">=ROW(B3)</item> returns 3 because the reference refers to the third row in the table.</paragraph> + <paragraph xml-lang="en-US" id="par_id3147094" role="paragraph" l10n="U" oldref="206"> + <item type="input">{=ROW(D5:D8)}</item> returns the single-column array (5, 6, 7, 8) because the reference specified contains rows 5 through 8.</paragraph> + <paragraph xml-lang="en-US" id="par_id3153701" role="paragraph" l10n="U" oldref="207"> + <item type="input">=ROW(D5:D8)</item> returns 5 because the ROW function is not used as array formula and only the number of the first row of the reference is returned.</paragraph> + <paragraph xml-lang="en-US" id="par_id3150996" role="paragraph" l10n="U" oldref="208"> + <item type="input">{=ROW(A1:E1)}</item> and <item type="input">=ROW(A1:E1)</item> both return 1 because the reference only contains row 1 as the first row in the table. (Because single-row areas only have one row number it does not make any difference whether or not the formula is used as an array formula.)</paragraph> + <paragraph xml-lang="en-US" id="par_id3153671" role="paragraph" l10n="U" oldref="209"> + <item type="input">=ROW()</item> returns 3 if the formula was entered in row 3.</paragraph> + <paragraph xml-lang="en-US" id="par_id3153790" role="paragraph" l10n="U" oldref="210"> + <item type="input">{=ROW(Rabbit)}</item> returns the single-column array (1, 2, 3) if "Rabbit" is the named area (C1:D3).</paragraph> + </section> + <section id="Section19"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3145772"><bookmark_value>ROWS function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_ZEILEN" id="bm_id3150667" localize="false"/> +<paragraph xml-lang="en-US" id="hd_id3145772" role="heading" level="2" l10n="U" + oldref="166">ROWS</paragraph> + <paragraph xml-lang="en-US" id="par_id3148971" role="paragraph" l10n="U" oldref="167"><ahelp hid="HID_FUNC_ZEILEN">Returns the number of rows in a reference or array.</ahelp></paragraph> + <paragraph xml-lang="en-US" id="hd_id3156051" role="heading" level="3" l10n="U" + oldref="168">Syntax</paragraph> + <paragraph xml-lang="en-US" id="par_id3154357" role="code" l10n="U" oldref="169">ROWS(Array)</paragraph> + <paragraph xml-lang="en-US" id="par_id3155942" role="paragraph" l10n="U" oldref="170"> + <emph>Array</emph> is the reference or named area whose total number of rows is to be determined.</paragraph> + <paragraph xml-lang="en-US" id="hd_id3155869" role="heading" level="3" l10n="U" + oldref="171">Example</paragraph> + <paragraph xml-lang="en-US" id="par_id3154725" role="paragraph" l10n="U" oldref="212"> + <item type="input">=Rows(B5)</item> returns 1 because a cell only contains one row.</paragraph> + <paragraph xml-lang="en-US" id="par_id3150102" role="paragraph" l10n="U" oldref="172"> + <item type="input">=ROWS(A10:B12)</item> returns 3.</paragraph> + <paragraph xml-lang="en-US" id="par_id3155143" role="paragraph" l10n="U" oldref="213"> + <item type="input">=ROWS(Rabbit)</item> returns 3 if "Rabbit" is the named area (C1:D3).</paragraph> + </section> + <section id="Section20"> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_HYPERLINK" id="bm_id8036439" localize="false"/> +<bookmark xml-lang="en-US" branch="index" id="bm_id9959410"><bookmark_value>HYPERLINK function</bookmark_value> +</bookmark> +<paragraph xml-lang="en-US" id="par_idN11798" role="heading" level="2" l10n="NEW">HYPERLINK</paragraph> + <paragraph xml-lang="en-US" id="par_idN117F1" role="paragraph" l10n="NEW"><ahelp hid="HID_FUNC_HYPERLINK">When you click a cell that contains the HYPERLINK function, the hyperlink opens.</ahelp></paragraph> + <paragraph xml-lang="en-US" id="par_idN11800" role="paragraph" l10n="NEW">If you use the optional <emph>CellText</emph> parameter, the formula locates the URL, and then displays the text or number.</paragraph> + <paragraph xml-lang="en-US" id="par_idN11803" role="tip" l10n="NEW">To open a hyperlinked cell with the keyboard, select the cell, press F2 to enter the Edit mode, move the cursor in front of the hyperlink, press Shift+F10, and then choose <emph>Open Hyperlink</emph>.</paragraph> + <paragraph xml-lang="en-US" id="par_idN1180A" role="heading" level="3" l10n="NEW">Syntax</paragraph> + <paragraph xml-lang="en-US" id="par_idN1180E" role="code" l10n="NEW">HYPERLINK("URL") or HYPERLINK("URL"; "CellText")</paragraph> + <paragraph xml-lang="en-US" id="par_idN11811" role="paragraph" l10n="CHG"> + <emph>URL</emph> specifies the link target. The optional <emph>CellText</emph> parameter is the text or a number that is displayed in the cell and will be returned as the result. If the <emph>CellText</emph> parameter is not specified, the <emph>URL</emph> is displayed in the cell text and will be returned as the result.</paragraph> + <paragraph xml-lang="en-US" id="par_id0907200912224576" role="paragraph" l10n="NEW">The number 0 is returned for empty cells and matrix elements.</paragraph> + <paragraph xml-lang="en-US" id="par_idN11823" role="heading" level="3" l10n="NEW">Example</paragraph> + <paragraph xml-lang="en-US" id="par_idN11827" role="paragraph" l10n="NEW"> + <item type="input">=HYPERLINK("http://www.example.org")</item> displays the text "http://www.example.org" in the cell and executes the hyperlink http://www.example.org when clicked.</paragraph> + <paragraph xml-lang="en-US" id="par_idN1182A" role="paragraph" l10n="NEW"> + <item type="input">=HYPERLINK("http://www.example.org";"Click here")</item> displays the text "Click here" in the cell and executes the hyperlink http://www.example.org when clicked.</paragraph> + <paragraph xml-lang="en-US" id="par_id0907200912224534" role="paragraph" l10n="NEW">=HYPERLINK("http://www.example.org";12345) displays the number 12345 and executes the hyperlink http://www.example.org when clicked.</paragraph> + <paragraph xml-lang="en-US" id="par_idN1182D" role="paragraph" l10n="NEW"> + <item type="input">=HYPERLINK($B4)</item> where cell B4 contains <item type="input">http://www.example.org</item>. The function adds http://www.example.org to the URL of the hyperlink cell and returns the same text which is used as formula result.</paragraph> + <paragraph xml-lang="en-US" id="par_idN11830" role="paragraph" l10n="NEW"> + <item type="input">=HYPERLINK("http://www.";"Click ") & "example.org"</item> displays the text Click example.org in the cell and executes the hyperlink http://www.example.org when clicked.</paragraph> + <paragraph xml-lang="en-US" id="par_id8859523" role="paragraph" l10n="NEW"> + <item type="input">=HYPERLINK("#Sheet1.A1";"Go to top")</item> displays the text Go to top and jumps to cell Sheet1.A1 in this document.</paragraph> + <paragraph xml-lang="en-US" id="par_id2958769" role="paragraph" l10n="NEW"> + <item type="input">=HYPERLINK("file:///C:/writer.odt#Specification";"Go to Writer bookmark")</item>displays the text Go to Writer bookmark, loads the specified text document and jumps to bookmark "Specification".</paragraph> + </section> + <section id="getpivotdata"> +<bookmark xml-lang="en-US" branch="index" id="bm_id7682424"><bookmark_value>GETPIVOTDATA function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_GETPIVOTDATA" id="bm_id897854" localize="false"/> +<paragraph xml-lang="en-US" id="hd_id3747062" role="heading" level="2" l10n="NEW">GETPIVOTDATA</paragraph> + <paragraph xml-lang="en-US" id="par_id3593859" role="paragraph" l10n="CHG"><ahelp hid=".">The GETPIVOTDATA function returns a result value from a pivot table. The value is addressed using field and item names, so it remains valid if the layout of the pivot table changes.</ahelp></paragraph> + <paragraph xml-lang="en-US" id="hd_id9741508" role="heading" level="3" l10n="NEW">Syntax</paragraph> + <paragraph xml-lang="en-US" id="par_id909451" role="paragraph" l10n="NEW">Two different syntax definitions can be used:</paragraph> + <paragraph xml-lang="en-US" id="par_id1665089" role="code" l10n="CHG">GETPIVOTDATA(TargetField; pivot table; [ Field 1; Item 1; ... ])</paragraph> + <paragraph xml-lang="en-US" id="par_id4997100" role="code" l10n="CHG">GETPIVOTDATA(pivot table; Constraints)</paragraph> + <paragraph xml-lang="en-US" id="par_id1672109" role="paragraph" l10n="NEW">The second syntax is assumed if exactly two parameters are given, of which the first parameter is a cell or cell range reference. The first syntax is assumed in all other cases. The Function Wizard shows the first syntax.</paragraph> + <paragraph xml-lang="en-US" id="hd_id9464094" role="heading" level="3" l10n="NEW">First Syntax</paragraph> + <paragraph xml-lang="en-US" id="par_id9302346" role="paragraph" l10n="NEW"> + <emph>TargetField</emph> is a string that selects one of the pivot table's data fields. The string can be the name of the source column, or the data field name as shown in the table (like "Sum - Sales").</paragraph> + <paragraph xml-lang="en-US" id="par_id8296151" role="paragraph" l10n="NEW"> + <emph>pivot table</emph> is a reference to a cell or cell range that is positioned within a pivot table or contains a pivot table. If the cell range contains several pivot tables, the table that was created last is used.</paragraph> + <paragraph xml-lang="en-US" id="par_id4809411" role="paragraph" l10n="NEW">If no <emph>Field n / Item n</emph> pairs are given, the grand total is returned. Otherwise, each pair adds a constraint that the result must satisfy. <emph>Field n</emph> is the name of a field from the pivot table. <emph>Item n</emph> is the name of an item from that field.</paragraph> + <paragraph xml-lang="en-US" id="par_id6454969" role="paragraph" l10n="NEW">If the pivot table contains only a single result value that fulfills all of the constraints, or a subtotal result that summarizes all matching values, that result is returned. If there is no matching result, or several ones without a subtotal for them, an error is returned. These conditions apply to results that are included in the pivot table.</paragraph> + <paragraph xml-lang="en-US" id="par_id79042" role="paragraph" l10n="NEW">If the source data contains entries that are hidden by settings of the pivot table, they are ignored. The order of the Field/Item pairs is not significant. Field and item names are not case-sensitive.</paragraph> + <paragraph xml-lang="en-US" id="par_id7928708" role="paragraph" l10n="CHG">If no constraint for a page field is given, the field's selected value is implicitly used. If a constraint for a page field is given, it must match the field's selected value, or an error is returned. Page fields are the fields at the top left of a pivot table, populated using the "Page Fields" area of the pivot table layout dialog. From each page field, an item (value) can be selected, which means only that item is included in the calculation.</paragraph> + <paragraph xml-lang="en-US" id="par_id3864253" role="paragraph" l10n="NEW">Subtotal values from the pivot table are only used if they use the function "auto" (except when specified in the constraint, see <item type="literal">Second Syntax</item> below).</paragraph> + <paragraph xml-lang="en-US" id="hd_id3144016" role="heading" level="3" l10n="NEW">Second Syntax</paragraph> + <paragraph xml-lang="en-US" id="par_id9937131" role="paragraph" l10n="NEW"> + <emph>pivot table</emph> has the same meaning as in the first syntax.</paragraph> + <paragraph xml-lang="en-US" id="par_id5616626" role="paragraph" l10n="CHG"> + <emph>Constraints</emph> is a space-separated list. Entries can be quoted (single quotes). The whole string must be enclosed in quotes (double quotes), unless you reference the string from another cell.</paragraph> + <paragraph xml-lang="en-US" id="par_id4076357" role="paragraph" l10n="NEW">One of the entries can be the data field name. The data field name can be left out if the pivot table contains only one data field, otherwise it must be present.</paragraph> + <paragraph xml-lang="en-US" id="par_id8231757" role="paragraph" l10n="CHG">Each of the other entries specifies a constraint in the form <item type="literal">Field[Item]</item> (with literal characters [ and ]), or only <item type="literal">Item</item> if the item name is unique within all fields that are used in the pivot table.<comment>i82342</comment></paragraph> + <paragraph xml-lang="en-US" id="par_id3168736" role="paragraph" l10n="CHG">A function name can be added in the form <emph>Field[Item;Function]</emph>, which will cause the constraint to match only subtotal values which use that function. The possible function names are Sum, Count, Average, Max, Min, Product, Count (Numbers only), StDev (Sample), StDevP (Population), Var (Sample), and VarP (Population), case-insensitive.</paragraph><comment>UFI: Example from spec doc is quite difficult to localize. Try to find other one</comment> +</section> +</sort> +<section id="relatedtopics"> + <embed href="text/scalc/01/04060100.xhp#drking"/> + </section> + </body> +</helpdocument> diff --git a/source/text/scalc/01/04060110.xhp b/source/text/scalc/01/04060110.xhp new file mode 100644 index 0000000000..b3ce97ceb8 --- /dev/null +++ b/source/text/scalc/01/04060110.xhp @@ -0,0 +1,664 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> + +<!-- +*********************************************************************** + * + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * Copyright 2000, 2010 Oracle and/or its affiliates. + * + * OpenOffice.org - a multi-platform office productivity suite + * + * This file is part of OpenOffice.org. + * + * OpenOffice.org is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License version 3 + * only, as published by the Free Software Foundation. + * + * OpenOffice.org is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License version 3 for more details + * (a copy is included in the LICENSE file that accompanied this code). + * + * You should have received a copy of the GNU Lesser General Public License + * version 3 along with OpenOffice.org. If not, see + * <http://www.openoffice.org/license.html> + * for a copy of the LGPLv3 License. + * + ************************************************************************ + --> + + +<meta> + <topic id="textscalc0104060110xml" indexer="include"> + <title xml-lang="en-US" id="tit">Text Functions</title> + <filename>/text/scalc/01/04060110.xhp</filename> + </topic> + </meta> + <body> +<bookmark xml-lang="en-US" branch="index" id="bm_id3145389"><bookmark_value>text in cells; functions</bookmark_value> + <bookmark_value>functions; text functions</bookmark_value> + <bookmark_value>Function Wizard;text</bookmark_value> +</bookmark> +<paragraph xml-lang="en-US" id="hd_id3145389" role="heading" level="1" l10n="U" oldref="1">Text Functions</paragraph> + <paragraph xml-lang="en-US" id="par_id3152986" role="paragraph" l10n="CHG" oldref="2"><variable id="texttext">This section contains descriptions of the <emph>Text</emph> functions. +</variable></paragraph> + <section id="howtoget"> + <embed href="text/scalc/00/00000404.xhp#eikatext"/> + </section> +<sort order="asc"> +<section id="arabic"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3149384"><bookmark_value>ARABIC function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_ARABISCH" id="bm_id3145359" localize="false"/> +<paragraph xml-lang="en-US" id="hd_id3149384" role="heading" level="2" l10n="U" + oldref="239">ARABIC</paragraph> + <paragraph xml-lang="en-US" id="par_id3153558" role="paragraph" l10n="U" oldref="240"><ahelp hid="HID_FUNC_ARABISCH">Calculates the value of a Roman number. The value range must be between 0 and 3999.</ahelp></paragraph> + <paragraph xml-lang="en-US" id="hd_id3153011" role="heading" level="3" l10n="U" + oldref="241">Syntax</paragraph> + <paragraph xml-lang="en-US" id="par_id3155523" role="code" l10n="U" oldref="242">ARABIC("Text")</paragraph> + <paragraph xml-lang="en-US" id="par_id3151193" role="paragraph" l10n="U" oldref="243"> + <emph>Text</emph> is the text that represents a Roman number.</paragraph> + <paragraph xml-lang="en-US" id="hd_id3155758" role="heading" level="3" l10n="U" + oldref="244">Example</paragraph> + <paragraph xml-lang="en-US" id="par_id3154621" role="paragraph" l10n="U" oldref="245"> + <item type="input">=ARABIC("MXIV")</item> returns 1014</paragraph> + <paragraph xml-lang="en-US" id="par_id3147553" role="paragraph" l10n="U" oldref="246"> + <item type="input">=ARABIC("MMII")</item> returns 2002</paragraph> + </section> + <section id="asc"> +<bookmark xml-lang="en-US" branch="index" id="bm_id8796349"><bookmark_value>ASC function</bookmark_value> +</bookmark><comment>i79585</comment> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_ASC" id="bm_id3187353" localize="false"/> +<paragraph xml-lang="en-US" id="hd_id7723929" role="heading" level="2" l10n="NEW">ASC</paragraph> + <paragraph xml-lang="en-US" id="par_id8455153" role="paragraph" l10n="NEW"><ahelp hid=".">The ASC function converts full-width to half-width ASCII and katakana characters. Returns a text string.</ahelp></paragraph> + <paragraph xml-lang="en-US" id="par_id9912411" role="paragraph" l10n="NEW">See <link href="http://wiki.documentfoundation.org/Calc/Features/JIS_and_ASC_functions">http://wiki.documentfoundation.org/Calc/Features/JIS_and_ASC_functions</link> for a conversion table.</paragraph> + <paragraph xml-lang="en-US" id="hd_id9204992" role="heading" level="3" l10n="NEW">Syntax</paragraph> + <paragraph xml-lang="en-US" id="par_id1993774" role="code" l10n="NEW">ASC("Text")</paragraph> + <paragraph xml-lang="en-US" id="par_id2949919" role="paragraph" l10n="NEW"> + <emph>Text</emph> is the text that contains characters to be converted.</paragraph> + <paragraph xml-lang="en-US" id="par_id2355113" role="paragraph" l10n="NEW">See also JIS function.</paragraph> + </section> + <section id="bahttext"> +<bookmark xml-lang="en-US" branch="index" id="bm_id9323709"><bookmark_value>BAHTTEXT function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_BAHTTEXT" id="bm_id744346" localize="false"/><comment>i66350</comment> +<paragraph xml-lang="en-US" id="hd_id6695455" role="heading" level="2" l10n="NEW">BAHTTEXT</paragraph> + <paragraph xml-lang="en-US" id="par_id354014" role="paragraph" l10n="NEW">Converts a number to Thai text, including the Thai currency names.</paragraph> + <paragraph xml-lang="en-US" id="hd_id9942014" role="heading" level="3" l10n="NEW">Syntax</paragraph> + <paragraph xml-lang="en-US" id="par_id8780785" role="code" l10n="NEW">BAHTTEXT(Number)</paragraph> + <paragraph xml-lang="en-US" id="par_id1539353" role="paragraph" l10n="NEW"> + <emph>Number</emph> is any number. "Baht" is appended to the integral part of the number, and "Satang" is appended to the decimal part of the number.</paragraph> + <paragraph xml-lang="en-US" id="hd_id9694814" role="heading" level="3" l10n="NEW">Example</paragraph> + <paragraph xml-lang="en-US" id="par_id3289284" role="paragraph" l10n="NEW"> + <item type="input">=BAHTTEXT(12.65)</item> returns a string in Thai characters with the meaning of "Twelve Baht and sixty five Satang".</paragraph> + </section> + <section id="base"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3153072"><bookmark_value>BASE function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_BASIS" id="bm_id3150957" localize="false"/> +<paragraph xml-lang="en-US" id="hd_id3153072" role="heading" level="2" l10n="U" + oldref="213">BASE</paragraph> + <paragraph xml-lang="en-US" id="par_id3153289" role="paragraph" l10n="U" oldref="214"><ahelp hid="HID_FUNC_BASIS">Converts a positive integer to a specified base into a text from the <link href="text/shared/00/00000005.xhp#zahlensystem" name="numbering system">numbering system</link>.</ahelp> The digits 0-9 and the letters A-Z are used.</paragraph> + <paragraph xml-lang="en-US" id="hd_id3146097" role="heading" level="3" l10n="U" + oldref="215">Syntax</paragraph> + <paragraph xml-lang="en-US" id="par_id3155743" role="code" l10n="U" oldref="216">BASE(Number; Radix; [MinimumLength])</paragraph> + <paragraph xml-lang="en-US" id="par_id3151339" role="paragraph" l10n="U" oldref="217"> + <emph>Number</emph> is the positive integer to be converted.</paragraph> + <paragraph xml-lang="en-US" id="par_id3159262" role="paragraph" l10n="U" oldref="218"> + <emph>Radix</emph> indicates the base of the number system. It may be any positive integer between 2 and 36.</paragraph> + <paragraph xml-lang="en-US" id="par_id3148746" role="paragraph" l10n="U" oldref="219"> + <emph>MinimumLength</emph> (optional) determines the minimum length of the character sequence that has been created. If the text is shorter than the indicated minimum length, zeros are added to the left of the string.</paragraph> + <paragraph xml-lang="en-US" id="hd_id3146323" role="heading" level="3" l10n="U" + oldref="220">Example</paragraph> +<bookmark xml-lang="en-US" branch="index" id="bm_id3156399"><bookmark_value>decimal system; converting to</bookmark_value> +</bookmark> +<paragraph xml-lang="en-US" id="par_id3156399" role="paragraph" l10n="U" oldref="221"> + <item type="input">=BASE(17;10;4)</item> returns 0017 in the decimal system.</paragraph> +<bookmark xml-lang="en-US" branch="index" id="bm_id3157871"><bookmark_value>binary system; converting to</bookmark_value> +</bookmark> +<paragraph xml-lang="en-US" id="par_id3157871" role="paragraph" l10n="U" oldref="222"> + <item type="input">=BASE(17;2)</item> returns 10001 in the binary system.</paragraph> +<bookmark xml-lang="en-US" branch="index" id="bm_id3145226"><bookmark_value>hexadecimal system; converting to</bookmark_value> +</bookmark> +<paragraph xml-lang="en-US" id="par_id3145226" role="paragraph" l10n="U" oldref="223"> + <item type="input">=BASE(255;16;4)</item> returns 00FF in the hexadecimal system.</paragraph> + </section> + <section id="char"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3149321"><bookmark_value>CHAR function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_ZEICHEN" id="bm_id3159128" localize="false"/> +<paragraph xml-lang="en-US" id="hd_id3149321" role="heading" level="2" l10n="U" + oldref="201">CHAR</paragraph> + <paragraph xml-lang="en-US" id="par_id3149150" role="paragraph" l10n="U" oldref="202"><ahelp hid="HID_FUNC_ZEICHEN">Converts a number into a character according to the current code table.</ahelp> The number can be a two-digit or three-digit integer number.</paragraph> + <embed href="text/scalc/00/00000004.xhp#codes"/> + <paragraph xml-lang="en-US" id="hd_id3149945" role="heading" level="3" l10n="U" + oldref="203">Syntax</paragraph> + <paragraph xml-lang="en-US" id="par_id3145634" role="code" l10n="U" oldref="204">CHAR(Number)</paragraph> + <paragraph xml-lang="en-US" id="par_id3155906" role="paragraph" l10n="U" oldref="205"> + <emph>Number</emph> is a number between 1 and 255 representing the code value for the character.</paragraph> + <paragraph xml-lang="en-US" id="hd_id3152982" role="heading" level="3" l10n="U" + oldref="207">Example</paragraph> + <paragraph xml-lang="en-US" id="par_id3149890" role="paragraph" l10n="CHG" oldref="208"> + <item type="input">=CHAR(100)</item> returns the character d.</paragraph> + <paragraph xml-lang="en-US" id="par_id0907200910283297" role="paragraph" l10n="NEW">="abc" & CHAR(10) & "def" inserts a newline character into the string.</paragraph> + </section> + <section id="clean"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3149009"><bookmark_value>CLEAN function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_SAEUBERN" id="bm_id3148729" localize="false"/> +<paragraph xml-lang="en-US" id="hd_id3149009" role="heading" level="2" l10n="U" + oldref="132">CLEAN</paragraph> + <paragraph xml-lang="en-US" id="par_id3150482" role="paragraph" l10n="U" oldref="133"><ahelp hid="HID_FUNC_SAEUBERN">All non-printing characters are removed from the string.</ahelp></paragraph> + <paragraph xml-lang="en-US" id="hd_id3146880" role="heading" level="3" l10n="U" + oldref="134">Syntax</paragraph> + <paragraph xml-lang="en-US" id="par_id3147472" role="code" l10n="U" oldref="135">CLEAN("Text")</paragraph> + <paragraph xml-lang="en-US" id="par_id3150695" role="paragraph" l10n="U" oldref="136"> + <emph>Text</emph> refers to the text from which to remove all non-printable characters.</paragraph> + </section> + <section id="code"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3155498"><bookmark_value>CODE function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_CODE" id="bm_id3159084" localize="false"/> +<paragraph xml-lang="en-US" id="hd_id3155498" role="heading" level="2" l10n="U" oldref="3">CODE</paragraph> + <paragraph xml-lang="en-US" id="par_id3152770" role="paragraph" l10n="U" oldref="4"><ahelp hid="HID_FUNC_CODE">Returns a numeric code for the first character in a text string.</ahelp></paragraph> + <paragraph xml-lang="en-US" id="hd_id3155830" role="heading" level="3" l10n="U" oldref="5">Syntax</paragraph> + <paragraph xml-lang="en-US" id="par_id3149188" role="code" l10n="U" oldref="6">CODE("Text")</paragraph> + <paragraph xml-lang="en-US" id="par_id3154383" role="paragraph" l10n="U" oldref="7"> + <emph>Text</emph> is the text for which the code of the first character is to be found.</paragraph> + <embed href="text/scalc/00/00000004.xhp#codes"/> + <paragraph xml-lang="en-US" id="hd_id3154394" role="heading" level="3" l10n="U" oldref="8">Example</paragraph> + <paragraph xml-lang="en-US" id="par_id3159209" role="paragraph" l10n="U" oldref="9"> + <item type="input">=CODE("Hieronymus")</item> returns 72, <item type="input">=CODE("hieroglyphic")</item> returns 104.</paragraph> + <paragraph xml-lang="en-US" id="par_id3150280" role="note" l10n="U" oldref="211">The code used here does not refer to ASCII, but to the code table currently loaded.</paragraph> + </section> + <section id="concatenate"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3149688"><bookmark_value>CONCATENATE function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_VERKETTEN" id="bm_id3153084" localize="false"/> +<paragraph xml-lang="en-US" id="hd_id3149688" role="heading" level="2" l10n="U" + oldref="167">CONCATENATE</paragraph> + <paragraph xml-lang="en-US" id="par_id3154524" role="paragraph" l10n="U" oldref="168"><ahelp hid="HID_FUNC_VERKETTEN">Combines several text strings into one string.</ahelp></paragraph> + <paragraph xml-lang="en-US" id="hd_id3149542" role="heading" level="3" l10n="U" + oldref="169">Syntax</paragraph> + <paragraph xml-lang="en-US" id="par_id3155954" role="code" l10n="U" oldref="170">CONCATENATE("Text1"; ...; "Text30")</paragraph> + <paragraph xml-lang="en-US" id="par_id3146847" role="paragraph" l10n="U" oldref="171"> + <emph>Text 1; Text 2; ...</emph> represent up to 30 text passages which are to be combined into one string.</paragraph> + <paragraph xml-lang="en-US" id="hd_id3153110" role="heading" level="3" l10n="U" + oldref="172">Example</paragraph> + <paragraph xml-lang="en-US" id="par_id3150008" role="paragraph" l10n="U" oldref="173"> + <item type="input">=CONCATENATE("Good ";"Morning ";"Mrs. ";"Doe")</item> returns: Good Morning Mrs. Doe.</paragraph> + </section> + <section id="decimal"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3145166"><bookmark_value>DECIMAL function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_DEZIMAL" id="bm_id3150338" localize="false"/> +<paragraph xml-lang="en-US" id="hd_id3145166" role="heading" level="2" l10n="U" + oldref="225">DECIMAL</paragraph> + <paragraph xml-lang="en-US" id="par_id3156361" role="paragraph" l10n="U" oldref="226"><ahelp hid="HID_FUNC_DEZIMAL">Converts text with characters from a <link href="text/shared/00/00000005.xhp#zahlensystem" name="number system">number system</link> to a positive integer in the base radix given.</ahelp> The radix must be in the range 2 to 36. Spaces and tabs are ignored. The <emph>Text</emph> field is not case-sensitive.</paragraph> + <paragraph xml-lang="en-US" id="par_id3157994" role="paragraph" l10n="U" oldref="227">If the radix is 16, a leading x or X or 0x or 0X, and an appended h or H, is disregarded. If the radix is 2, an appended b or B is disregarded. Other characters that do not belong to the number system generate an error.</paragraph> + <paragraph xml-lang="en-US" id="hd_id3150014" role="heading" level="3" l10n="U" + oldref="228">Syntax</paragraph> + <paragraph xml-lang="en-US" id="par_id3154328" role="code" l10n="U" oldref="229">DECIMAL("Text"; Radix)</paragraph> + <paragraph xml-lang="en-US" id="par_id3150128" role="paragraph" l10n="U" oldref="230"> + <emph>Text</emph> is the text to be converted. To differentiate between a hexadecimal number, such as A1 and the reference to cell A1, you must place the number in quotation marks, for example, "A1" or "FACE".</paragraph> + <paragraph xml-lang="en-US" id="par_id3145241" role="paragraph" l10n="U" oldref="231"> + <emph>Radix</emph> indicates the base of the number system. It may be any positive integer between 2 and 36.</paragraph> + <paragraph xml-lang="en-US" id="hd_id3156062" role="heading" level="3" l10n="U" + oldref="232">Example</paragraph> + <paragraph xml-lang="en-US" id="par_id3145355" role="paragraph" l10n="U" oldref="233"> + <item type="input">=DECIMAL("17";10)</item> returns 17.</paragraph> + <paragraph xml-lang="en-US" id="par_id3155622" role="paragraph" l10n="U" oldref="234"> + <item type="input">=DECIMAL("FACE";16)</item> returns 64206.</paragraph> + <paragraph xml-lang="en-US" id="par_id3151015" role="paragraph" l10n="U" oldref="235"> + <item type="input">=DECIMAL("0101";2)</item> returns 5.</paragraph> + </section> + <section id="dollar"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3148402"><bookmark_value>DOLLAR function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_DM" id="bm_id3149532" localize="false"/> +<paragraph xml-lang="en-US" id="hd_id3148402" role="heading" level="2" l10n="U" + oldref="11">DOLLAR</paragraph> + <paragraph xml-lang="en-US" id="par_id3153049" role="paragraph" l10n="U" oldref="12"><ahelp hid="HID_FUNC_DM">Converts a number to an amount in the currency format, rounded to a specified decimal place.</ahelp> In the <item type="literal">Value</item> field enter the number to be converted to currency. Optionally, you may enter the number of decimal places in the <item type="literal">Decimals</item> field. If no value is specified, all numbers in currency format will be displayed with two decimal places. </paragraph> + <paragraph xml-lang="en-US" id="par_id3151280" role="paragraph" l10n="U" oldref="263">You set the currency format in your system settings.</paragraph> + <paragraph xml-lang="en-US" id="hd_id3150569" role="heading" level="3" l10n="U" + oldref="13">Syntax</paragraph> + <paragraph xml-lang="en-US |