diff options
Diffstat (limited to 'helpcontent2/source/text/scalc/01')
274 files changed, 35462 insertions, 0 deletions
diff --git a/helpcontent2/source/text/scalc/01/01120000.xhp b/helpcontent2/source/text/scalc/01/01120000.xhp new file mode 100644 index 000000000..058adc0fb --- /dev/null +++ b/helpcontent2/source/text/scalc/01/01120000.xhp @@ -0,0 +1,49 @@ +<?xml version="1.0" encoding="UTF-8"?> + + + +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . + --> + + + <helpdocument version="1.0"> +<meta> +<topic id="textscalc0101120000xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Print Preview</title> +<filename>/text/scalc/01/01120000.xhp</filename> +</topic> +</meta> +<body> +<section id="printpreview"> +<bookmark xml-lang="en-US" branch="hid/.uno:PrintPreview" id="bm_id2822117" localize="false"/> +<paragraph role="heading" id="hd_id1918698" xml-lang="en-US" level="1"><link href="text/scalc/01/01120000.xhp">Print Preview</link></paragraph> +<paragraph role="paragraph" id="par_id3831598" xml-lang="en-US"><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#view"/> +</section> +<paragraph role="paragraph" id="par_id3145847" xml-lang="en-US">Use the icons on the <emph>Print 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">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">You cannot edit your document while you are in the print preview.</paragraph> +<bookmark xml-lang="en-US" branch="hid/.uno:ClosePreview" id="bm_id9368395" localize="false"/> +<paragraph role="paragraph" id="par_id460829" xml-lang="en-US"><ahelp hid="." visibility="hidden">To exit the print preview, click the <emph>Close Preview</emph> button.</ahelp></paragraph> +<section id="relatedtopics"> +<paragraph role="paragraph" id="par_id3155829" xml-lang="en-US"><link href="text/scalc/main0210.xhp" name="Page View Object Bar">Page View Object Bar</link></paragraph> +</section> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/02110000.xhp b/helpcontent2/source/text/scalc/01/02110000.xhp new file mode 100644 index 000000000..f566781ee --- /dev/null +++ b/helpcontent2/source/text/scalc/01/02110000.xhp @@ -0,0 +1,167 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> + +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . + --> +<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/modules/scalc/ui/navigatorpanel/NavigatorPanel" id="bm_id3904654" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/navigatorpanel/@@nowidget@@" id="bm_id3904654" localize="false"/> + +<h1 id="hd_id3150791"><link href="text/scalc/01/02110000.xhp" name="Navigator">Navigator</link></h1> +<paragraph role="paragraph" id="par_id3156422" xml-lang="en-US"><ahelp hid=".uno:Navigator">Activates and deactivates the Navigator.</ahelp> The Navigator is a <link href="text/shared/00/00000005.xhp#docking" name="dockable window">dockable window</link>.</paragraph> +</section> +<section id="howtoget"> +<embed href="text/shared/00/edit_menu.xhp#navigator"/> +</section> +<embed href="text/shared/guide/navigator.xhp#navigator"/> +<paragraph role="paragraph" id="par_id3145271" xml-lang="en-US">Choose <emph>View - Navigator</emph> to display the Navigator.</paragraph> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/navigatorpanel/column" id="bm_id3163713" localize="false"/> +<h2 id="hd_id3159155">Column</h2> +<paragraph role="paragraph" id="par_id3146984" xml-lang="en-US"><ahelp hid="modules/scalc/ui/navigatorpanel/column">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/modules/scalc/ui/navigatorpanel/row" id="bm_id3156286" localize="false"/> +<h2 id="hd_id3147126">Row</h2> +<paragraph role="paragraph" id="par_id3149958" xml-lang="en-US"><ahelp hid="modules/scalc/ui/navigatorpanel/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/modules/scalc/ui/navigatorpanel/datarange" id="bm_id3149123" localize="false"/> +<h2 id="hd_id3150717">Data Range</h2> +<paragraph role="paragraph" id="par_id3150752" xml-lang="en-US"><ahelp hid="modules/scalc/ui/navigatorpanel/datarange">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"> +<image id="img_id3147338" src="cmd/lc_dataranges.svg" width="1cm" height="1cm"><alt id="alt_id3147338" xml-lang="en-US">Icon</alt> + </image></paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3146919" xml-lang="en-US">Data Range</paragraph> +</tablecell> +</tablerow> +</table> + +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/navigatorpanel/start" id="bm_id3155111" localize="false"/> +<h2 id="hd_id3148488">Start</h2> +<paragraph role="paragraph" id="par_id3150086" xml-lang="en-US"><ahelp hid="modules/scalc/ui/navigatorpanel/start">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"> +<image id="img_id3150515" src="cmd/lc_prevrecord.svg" width="1cm" height="1cm"><alt id="alt_id3150515" xml-lang="en-US">Icon Start</alt> + </image></paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3154372" xml-lang="en-US">Start</paragraph> +</tablecell> +</tablerow> +</table> + +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/navigatorpanel/end" id="bm_id3156449" localize="false"/> +<h2 id="hd_id3146982">End</h2> +<paragraph role="paragraph" id="par_id3152985" xml-lang="en-US"><ahelp hid="modules/scalc/ui/navigatorpanel/end">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"> +<image id="img_id3148871" src="cmd/lc_nextrecord.svg" width="1cm" height="1cm"><alt id="alt_id3148871" xml-lang="en-US">Icon End</alt></image></paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3147072" xml-lang="en-US">End</paragraph> +</tablecell> +</tablerow> +</table> + +<h2 id="hd_id3150107">Toggle</h2> +<paragraph role="paragraph" id="par_id3159098" xml-lang="en-US">Toggles the content view. Only the selected Navigator element and its subelements are displayed. 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"> +<image id="img_id3149126" src="sw/res/sc20244.svg" width="1cm" height="1cm"><alt id="alt_id3149126" xml-lang="en-US">Icon Toggle</alt></image></paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3159229" xml-lang="en-US">Toggle</paragraph> +</tablecell> +</tablerow> +</table> + +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/navigatorpanel/scenarios" id="bm_id3145115" localize="false"/> +<h2 id="hd_id3147244">Scenarios</h2> +<paragraph role="paragraph" id="par_id3153955" xml-lang="en-US"><ahelp hid="modules/scalc/ui/navigatorpanel/scenarios">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"> +<image id="img_id3159256" src="cmd/sc_thesaurus.svg" width="1cm" height="1cm"><alt id="alt_id3159256" xml-lang="en-US">Icon Scenarios</alt></image></paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3166466" xml-lang="en-US">Scenarios</paragraph> +</tablecell> +</tablerow> +</table> + +<paragraph role="paragraph" id="par_idN10A6C" xml-lang="en-US">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/modules/scalc/ui/scenariomenu/delete" id="bm_id1900997" localize="false"/> +<h3 id="par_idN10A77">Delete</h3> +<paragraph role="paragraph" id="par_idN10A7B" xml-lang="en-US"><ahelp hid="modules/scalc/ui/scenariomenu/delete">Deletes the selected scenario.</ahelp></paragraph> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/scenariomenu/edit" id="bm_id4495376" localize="false"/> +<h3 id="par_idN10A92">Properties</h3> +<paragraph role="paragraph" id="par_idN10A96" xml-lang="en-US"><ahelp hid="modules/scalc/ui/scenariomenu/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/modules/scalc/ui/navigatorpanel/dragmode" id="bm_id3157871" localize="false"/> +<h2 id="hd_id3150037">Drag Mode</h2> +<paragraph role="paragraph" id="par_id3157876" xml-lang="en-US"><ahelp hid="modules/scalc/ui/navigatorpanel/dragmode">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"> +<image id="img_id3159119" src="cmd/lc_chainframes.svg" width="1cm" height="1cm"><alt id="alt_id3159119" xml-lang="en-US">Icon Drag Mode</alt></image></paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3150656" xml-lang="en-US">Drag Mode</paragraph> +</tablecell> +</tablerow> +</table> + +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/dropmenu/hyperlink" id="bm_id3146876" localize="false"/> +<h3 id="hd_id3149009">Insert as Hyperlink</h3> +<paragraph role="paragraph" id="par_id3146938" xml-lang="en-US"><ahelp hid="modules/scalc/ui/dropmenu/hyperlink">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> +<note id="par_id3880733">If you insert a hyperlink that links to an open document, you need to save the document before you can use the hyperlink.</note> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/dropmenu/link" id="bm_id3150740" localize="false"/> +<h3 id="hd_id3154682">Insert as Link</h3> +<paragraph role="paragraph" id="par_id3150746" xml-lang="en-US"><ahelp hid="modules/scalc/ui/dropmenu/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/modules/scalc/ui/dropmenu/copy" id="bm_id3154846" localize="false"/> +<h3 id="hd_id3145824">Insert as Copy</h3> +<paragraph role="paragraph" id="par_id3147471" xml-lang="en-US"><ahelp hid="modules/scalc/ui/dropmenu/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/modules/scalc/ui/navigatorpanel/contentbox" id="bm_id3150695" localize="false"/> +<h2 id="hd_id3147423">Objects</h2> +<paragraph role="paragraph" id="par_id3150700" xml-lang="en-US"><ahelp hid="modules/scalc/ui/navigatorpanel/contentbox">Displays all objects in your document.</ahelp></paragraph> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/navigatorpanel/documents" id="bm_id3152785" localize="false"/> +<h2 id="hd_id3150860">Documents</h2> +<paragraph role="paragraph" id="par_id3153929" xml-lang="en-US"><ahelp hid="modules/scalc/ui/navigatorpanel/documents">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/helpcontent2/source/text/scalc/01/02120000.xhp b/helpcontent2/source/text/scalc/01/02120000.xhp new file mode 100644 index 000000000..53214c215 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/02120000.xhp @@ -0,0 +1,40 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . +--> + +<meta> + <topic id="textscalc0102120000xml" indexer="include" status="PUBLISH"> + <title id="tit" xml-lang="en-US">Headers & Footers</title> + <filename>/text/scalc/01/02120000.xhp</filename> + </topic> +</meta> +<body> +<section id="headers_footers"> +<bookmark xml-lang="en-US" branch="hid/.uno:EditHeaderAndFooter" id="bm_id6105651" localize="false"/> +<paragraph id="hd_id3145251" role="heading" level="1" xml-lang="en-US"><link href="text/scalc/01/02120000.xhp" name="Headers & Footers">Headers & Footers</link></paragraph> +<paragraph id="par_id3151073" role="paragraph" xml-lang="en-US"><variable id="kopfundfusszeilentext"><ahelp hid=".">Allows you to define and format headers and footers.</ahelp> </variable></paragraph> +</section> +<paragraph id="par_id3153415" role="paragraph" xml-lang="en-US">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"><emph>Page Style</emph></link> dialog.</paragraph> +<section id="howtoget"> +<embed href="text/scalc/00/00000402.xhp#kopffuss"/> +</section> +<embed href="text/scalc/01/02120100.xhp#header"/> +<embed href="text/shared/00/00000001.xhp#reset"/> +</body> +</helpdocument>
\ No newline at end of file diff --git a/helpcontent2/source/text/scalc/01/02120100.xhp b/helpcontent2/source/text/scalc/01/02120100.xhp new file mode 100644 index 000000000..7ca98d272 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/02120100.xhp @@ -0,0 +1,164 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> + +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . + --> + +<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="header"> +<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/modules/scalc/ui/headerfootercontent/HeaderFooterContent" id="bm_id3156422" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/headerfootercontent/@@nowidget@@" id="bm_id3156422" localize="false"/> +<paragraph xml-lang="en-US" id="hd_id3153360" role="heading" level="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"><ahelp hid="modules/scalc/ui/headerfootercontent/HeaderFooterContent">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/modules/scalc/ui/headerfootercontent/textviewWND_LEFT" id="bm_id3153726" localize="false"/> +<paragraph xml-lang="en-US" id="hd_id3145748" role="heading" level="2">Left Area</paragraph> + <paragraph xml-lang="en-US" id="par_id3147434" role="paragraph"><ahelp hid="modules/scalc/ui/headerfootercontent/textviewWND_LEFT">Enter the text to be displayed at the left side of the header or footer.</ahelp></paragraph> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/headerfootercontent/textviewWND_CENTER" id="bm_id3153951" localize="false"/> +<paragraph xml-lang="en-US" id="hd_id3148648" role="heading" level="2">Center Area</paragraph> + <paragraph xml-lang="en-US" id="par_id3163710" role="paragraph"><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/modules/scalc/ui/headerfootercontent/textviewWND_RIGHT" id="bm_id3155418" localize="false"/> +<paragraph xml-lang="en-US" id="hd_id3154942" role="heading" level="2">Right Area</paragraph> + <paragraph xml-lang="en-US" id="par_id3147126" role="paragraph"><ahelp hid="modules/scalc/ui/headerfootercontent/textviewWND_RIGHT">Enter the text to be displayed at the right side of the header or footer.</ahelp></paragraph> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/headerfootercontent/comboLB_DEFINED" id="bm_id0609200910173918" localize="false"/> +<paragraph xml-lang="en-US" id="par_idN10811" role="heading" level="2">Header/Footer</paragraph> + <paragraph xml-lang="en-US" id="par_idN10815" role="paragraph"><ahelp hid=".">Select a predefined header or footer from the list.</ahelp></paragraph> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/headerfootercontent/buttonBTN_TEXT" id="bm_id3144766" localize="false"/> +<paragraph xml-lang="en-US" id="hd_id3154729" role="heading" level="2">Text attributes</paragraph> + <paragraph xml-lang="en-US" id="par_id3150717" role="paragraph"><ahelp hid="modules/scalc/ui/headerfootercontent/buttonBTN_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"><emph>Font</emph></link>, <link href="text/shared/01/05020200.xhp" name="Font Effects"><emph>Font Effects</emph></link> and <link href="text/shared/01/05020500.xhp" name="Font Position"><emph>Font Position</emph></link>.</paragraph> + <table id="tbl_id3149018"> + <tablerow> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3159266" role="paragraph"> +<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">Text Attributes</paragraph> + </tablecell> + </tablerow> + </table> + +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/headerfootercontent/buttonBTN_FILE" id="bm_id3154020" localize="false"/> +<paragraph xml-lang="en-US" id="hd_id3145792" role="heading" level="2">File Name </paragraph> + <paragraph xml-lang="en-US" id="par_id3150206" role="paragraph"><ahelp hid="modules/scalc/ui/headerfootercontent/buttonBTN_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"> +<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">File Name</paragraph> + </tablecell> + </tablerow> + </table> + +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/headerfootercontent/buttonBTN_TABLE" id="bm_id3149408" localize="false"/> +<paragraph xml-lang="en-US" id="hd_id3155812" role="heading" level="2">Sheet Name</paragraph> + <paragraph xml-lang="en-US" id="par_id3148842" role="paragraph"><ahelp hid="modules/scalc/ui/headerfootercontent/buttonBTN_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"> +<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">Sheet Name</paragraph> + </tablecell> + </tablerow> + </table> + +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/headerfootercontent/buttonBTN_PAGE" id="bm_id3153288" localize="false"/> +<paragraph xml-lang="en-US" id="hd_id3144768" role="heading" level="2">Page</paragraph> + <paragraph xml-lang="en-US" id="par_id3154960" role="paragraph"><ahelp hid="modules/scalc/ui/headerfootercontent/buttonBTN_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"> +<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">Page</paragraph> + </tablecell> + </tablerow> + </table> + +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/headerfootercontent/buttonBTN_PAGES" id="bm_id3153012" localize="false"/> +<paragraph xml-lang="en-US" id="hd_id3146962" role="heading" level="2">Pages</paragraph> + <paragraph xml-lang="en-US" id="par_id3153812" role="paragraph"><ahelp hid="modules/scalc/ui/headerfootercontent/buttonBTN_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"> +<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">Pages</paragraph> + </tablecell> + </tablerow> + </table> + +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/headerfootercontent/buttonBTN_DATE" id="bm_id3150438" localize="false"/> +<paragraph xml-lang="en-US" id="hd_id3149050" role="heading" level="2">Date</paragraph> + <paragraph xml-lang="en-US" id="par_id3153960" role="paragraph"><ahelp hid="modules/scalc/ui/headerfootercontent/buttonBTN_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"> +<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">Date</paragraph> + </tablecell> + </tablerow> + </table> + +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/headerfootercontent/buttonBTN_TIME" id="bm_id3147412" localize="false"/> +<paragraph xml-lang="en-US" id="hd_id3147610" role="heading" level="2">Time</paragraph> + <paragraph xml-lang="en-US" id="par_id3145638" role="paragraph"><ahelp hid="modules/scalc/ui/headerfootercontent/buttonBTN_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"> +<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">Time</paragraph> + </tablecell> + </tablerow> + </table> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/02140000.xhp b/helpcontent2/source/text/scalc/01/02140000.xhp new file mode 100644 index 000000000..50893fb3b --- /dev/null +++ b/helpcontent2/source/text/scalc/01/02140000.xhp @@ -0,0 +1,66 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> + +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . + --> + + +<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="fill"> +<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"><link href="text/scalc/01/02140000.xhp" name="Fill">Fill</link></paragraph> + <paragraph xml-lang="en-US" id="par_id3156285" role="paragraph"><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">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#down"/> + <embed href="text/scalc/01/02140200.xhp#right"/> + <embed href="text/scalc/01/02140300.xhp#up"/> + <embed href="text/scalc/01/02140400.xhp#left"/> + <paragraph xml-lang="en-US" id="hd_id3149207" role="heading" level="2"><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"><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"> +<emph>Filling cells using context menus:</emph> +</paragraph> + <list type="unordered"> + <listitem> + <paragraph xml-lang="en-US" id="par_id3145384" role="listitem">Call the <link href="text/shared/00/00000005.xhp#contextmenu" 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"/> +<paragraph xml-lang="en-US" id="par_id3156450" role="listitem"><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">Click one of the listed entries to copy it to the cell.</paragraph> + </listitem> + </list> + </body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/02140100.xhp b/helpcontent2/source/text/scalc/01/02140100.xhp new file mode 100644 index 000000000..aef7a17d6 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/02140100.xhp @@ -0,0 +1,45 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . + --> + +<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> +</history> +</meta> +<body> + + + <section id="down"> +<bookmark branch="hid/.uno:FillDown" xml-lang="en-US" id="bm_id3145173" localize="false"/> +<paragraph id="hd_id3150792" role="heading" level="1" xml-lang="en-US"><link href="text/scalc/01/02140100.xhp" name="Down">Down</link></paragraph> + <paragraph role="paragraph" id="par_id3153969" xml-lang="en-US"><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" xml-lang="en-US">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/helpcontent2/source/text/scalc/01/02140200.xhp b/helpcontent2/source/text/scalc/01/02140200.xhp new file mode 100644 index 000000000..a05a478d3 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/02140200.xhp @@ -0,0 +1,45 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . + --> + +<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> +</history> +</meta> +<body> + + + <section id="right"> +<bookmark branch="hid/.uno:FillRight" xml-lang="en-US" id="bm_id3149456" localize="false"/> +<paragraph id="hd_id3153896" role="heading" level="1" xml-lang="en-US"><link href="text/scalc/01/02140200.xhp" name="Right">Right</link></paragraph> + <paragraph role="paragraph" id="par_id3153361" xml-lang="en-US"><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" xml-lang="en-US">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/helpcontent2/source/text/scalc/01/02140300.xhp b/helpcontent2/source/text/scalc/01/02140300.xhp new file mode 100644 index 000000000..a5db87e3e --- /dev/null +++ b/helpcontent2/source/text/scalc/01/02140300.xhp @@ -0,0 +1,45 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . + --> + +<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> +</history> +</meta> +<body> + + + <section id="up"> +<bookmark branch="hid/.uno:FillUp" xml-lang="en-US" id="bm_id3149456" localize="false"/> +<paragraph id="hd_id3147264" role="heading" level="1" xml-lang="en-US"><link href="text/scalc/01/02140300.xhp" name="Up">Up</link></paragraph> + <paragraph role="paragraph" id="par_id3150793" xml-lang="en-US"><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" xml-lang="en-US">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/helpcontent2/source/text/scalc/01/02140400.xhp b/helpcontent2/source/text/scalc/01/02140400.xhp new file mode 100644 index 000000000..a96720e8e --- /dev/null +++ b/helpcontent2/source/text/scalc/01/02140400.xhp @@ -0,0 +1,45 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . + --> + +<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> +</history> +</meta> +<body> + + + <section id="left"> +<bookmark branch="hid/.uno:FillLeft" xml-lang="en-US" id="bm_id3149456" localize="false"/> +<paragraph id="hd_id3153896" role="heading" level="1" xml-lang="en-US"><link href="text/scalc/01/02140400.xhp" name="Left">Left</link></paragraph> + <paragraph role="paragraph" id="par_id3150793" xml-lang="en-US"><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" xml-lang="en-US">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/helpcontent2/source/text/scalc/01/02140500.xhp b/helpcontent2/source/text/scalc/01/02140500.xhp new file mode 100644 index 000000000..c3888d425 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/02140500.xhp @@ -0,0 +1,53 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . + --> +<meta> +<topic id="textscalc0102140500xml" indexer="include" status="PUBLISH"> + <title xml-lang="en-US" id="tit">Fill Sheets</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"/> +<h1 id="hd_id3153897">Fill Sheets</h1> +<paragraph role="paragraph" id="par_id3150791" xml-lang="en-US"><variable id="tabellenfuellentext"><ahelp hid=".uno:FillTable">Specifies the options for transferring sheets or ranges of a certain sheet to the same cells on other selected sheets.</ahelp></variable></paragraph> +<section id="howtoget"> + <embed href="text/scalc/00/00000402.xhp#baustab"/> +</section> +<paragraph xml-lang="en-US" role="warning" id="par_id3150768">This menu command is only active if you have selected at least two sheets in the document.</paragraph> +<paragraph xml-lang="en-US" role="paragraph" id="par_id3150769">To select multiple sheets, click each sheet tab while pressing <switchinline select="sys"><caseinline select="MAC"><keycode>Command</keycode></caseinline><defaultinline><keycode>Ctrl</keycode></defaultinline></switchinline> or <keycode>Shift</keycode>.</paragraph> +<paragraph xml-lang="en-US" role="paragraph" id="par_id3150767">In contrast to copying an area to the clipboard, you can filter certain information and calculate values.</paragraph> +<h2 id="hd_id3155131">Filling a Sheet</h2> + <list type="unordered"> + <listitem> + <paragraph role="listitem" id="par_id3146119" xml-lang="en-US">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">Press <switchinline select="sys"><caseinline select="MAC"><keycode>Command</keycode></caseinline><defaultinline><keycode>Ctrl</keycode></defaultinline></switchinline> and click the tab of the sheet where you want to insert the contents.</paragraph> + </listitem> + <listitem> + <paragraph xml-lang="en-US" role="listitem" id="par_id3147436">Select the command <menuitem>Sheet - Fill Cells - Sheets</menuitem>. 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">Click <emph>OK</emph>.</paragraph> + </listitem> + </list> + <paragraph xml-lang="en-US" role="paragraph" id="par_id3156283">This dialog is similar to the <link href="text/shared/01/02070000.xhp" name="Paste Special"><emph>Paste Special</emph></link> dialog, where you can find additional tips.</paragraph> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/02140600.xhp b/helpcontent2/source/text/scalc/01/02140600.xhp new file mode 100644 index 000000000..da3139a68 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/02140600.xhp @@ -0,0 +1,115 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.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> +</meta> + +<body> + +<bookmark xml-lang="en-US" branch="hid/.uno:FillSeries" id="bm_id709198" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/filldlg/FillSeriesDialog" id="bm_id3150791" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/filldlg/@@nowidget@@" id="bm_id3150791" localize="false"/> + +<paragraph id="hd_id3148664" role="heading" level="1" xml-lang="en-US">Fill Series</paragraph> +<paragraph id="par_id3148797" role="paragraph" xml-lang="en-US"><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 id="par_id3146976" role="note" xml-lang="en-US">Before filling a series, first select the cell range.</paragraph> + +<section id="howtoget"> +<embed href="text/scalc/00/00000402.xhp#bausreihe"/> +</section> +<paragraph id="par_id3145748" role="paragraph" xml-lang="en-US">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 id="hd_id3147435" role="heading" level="2" xml-lang="en-US">Direction</paragraph> +<paragraph id="par_id3154729" role="paragraph" xml-lang="en-US">Determines the direction of series creation.</paragraph> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/filldlg/down" id="bm_id3147124" localize="false"/> + +<paragraph id="hd_id3145253" role="heading" level="3" xml-lang="en-US">Down</paragraph> +<paragraph id="par_id3155418" role="paragraph" xml-lang="en-US"><ahelp hid="modules/scalc/ui/filldlg/down">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/modules/scalc/ui/filldlg/right" id="bm_id3153415" localize="false"/> + +<paragraph id="hd_id3155738" role="heading" level="3" xml-lang="en-US">Right</paragraph> +<paragraph id="par_id3149402" role="paragraph" xml-lang="en-US"><ahelp hid="modules/scalc/ui/filldlg/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/modules/scalc/ui/filldlg/up" id="bm_id3155067" localize="false"/> + +<paragraph id="hd_id3146972" role="heading" level="3" xml-lang="en-US">Up</paragraph> +<paragraph id="par_id3153711" role="paragraph" xml-lang="en-US"><ahelp hid="modules/scalc/ui/filldlg/up">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/modules/scalc/ui/filldlg/left" id="bm_id3147341" localize="false"/> + +<paragraph id="hd_id3153764" role="heading" level="3" xml-lang="en-US">Left</paragraph> +<paragraph id="par_id3156382" role="paragraph" xml-lang="en-US"><ahelp hid="modules/scalc/ui/filldlg/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 id="hd_id3147344" role="heading" level="2" xml-lang="en-US">Series Type</paragraph> +<paragraph id="par_id3149257" role="paragraph" xml-lang="en-US">Defines the series type. Choose between <emph>Linear</emph>, <emph>Growth</emph>, <emph>Date</emph> and <emph>AutoFill</emph>.</paragraph> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/filldlg/linear" id="bm_id3150298" localize="false"/> + +<paragraph id="hd_id3148488" role="heading" level="3" xml-lang="en-US">Linear</paragraph> +<paragraph id="par_id3159238" role="paragraph" xml-lang="en-US"><ahelp hid="modules/scalc/ui/filldlg/linear">Creates a linear number series using the defined increment and end value.</ahelp></paragraph> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/filldlg/growth" id="bm_id3150784" localize="false"/> + +<paragraph id="hd_id3149210" role="heading" level="3" xml-lang="en-US">Growth</paragraph> +<paragraph id="par_id3150364" role="paragraph" xml-lang="en-US"><ahelp hid="modules/scalc/ui/filldlg/growth">Creates a growth series using the defined increment and end value.</ahelp></paragraph> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/filldlg/date" id="bm_id3155378" localize="false"/> + +<paragraph id="hd_id3149528" role="heading" level="3" xml-lang="en-US">Date</paragraph> +<paragraph id="par_id3150887" role="paragraph" xml-lang="en-US"><ahelp hid="modules/scalc/ui/filldlg/date">Creates a date series using the defined increment and end date.</ahelp></paragraph> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/filldlg/autofill" id="bm_id3152985" localize="false"/> + +<paragraph id="hd_id3150202" role="heading" level="3" xml-lang="en-US">AutoFill</paragraph> +<paragraph id="par_id3156288" role="paragraph" xml-lang="en-US"><ahelp hid="modules/scalc/ui/filldlg/autofill">Forms a series directly in the sheet.</ahelp> The <emph>AutoFill</emph> 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 <switchinline select="sys"><caseinline select="MAC"><emph>%PRODUCTNAME - Preferences</emph> +</caseinline><defaultinline><emph>Tools - Options</emph></defaultinline></switchinline><emph> - %PRODUCTNAME Calc - Sort Lists</emph>.</paragraph> +<paragraph id="par_id3155811" role="paragraph" xml-lang="en-US">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 id="par_id2956483" role="paragraph" localize="false" xml-lang="en-US"><embedvar href="text/scalc/guide/calc_series.xhp#calc_series"/></paragraph> + +<paragraph id="hd_id3148700" role="heading" level="2" xml-lang="en-US">Unit of Time</paragraph> +<paragraph id="par_id3153308" role="paragraph" xml-lang="en-US">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/modules/scalc/ui/filldlg/day" id="bm_id3153913" localize="false"/> + +<paragraph id="hd_id3148868" role="heading" level="3" xml-lang="en-US">Day</paragraph> +<paragraph id="par_id3148605" role="paragraph" xml-lang="en-US"><ahelp hid="modules/scalc/ui/filldlg/day">Use the <emph>Date</emph> series type and this option to create a series using all seven days of the week. Unit of <emph>Increment</emph> is day.</ahelp></paragraph> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/filldlg/week" id="bm_id3145074" localize="false"/> + +<paragraph id="hd_id3144771" role="heading" level="3" xml-lang="en-US">Weekday</paragraph> +<paragraph id="par_id3150108" role="paragraph" xml-lang="en-US"><ahelp hid="modules/scalc/ui/filldlg/week">Use the <emph>Date</emph> series type and this option to create a series only using the five weekdays. Unit of <emph>Increment</emph> is day.</ahelp></paragraph> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/filldlg/month" id="bm_id3159204" localize="false"/> + +<paragraph id="hd_id3154957" role="heading" level="3" xml-lang="en-US">Month</paragraph> +<paragraph id="par_id3149126" role="paragraph" xml-lang="en-US"><ahelp hid="modules/scalc/ui/filldlg/month">Use the <emph>Date</emph> series type and this option to form a series which unit of <emph>Increment</emph> is month.</ahelp></paragraph> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/filldlg/year" id="bm_id3146777" localize="false"/> + +<paragraph id="hd_id3152870" role="heading" level="3" xml-lang="en-US">Year</paragraph> +<paragraph id="par_id3151300" role="paragraph" xml-lang="en-US"><ahelp hid="modules/scalc/ui/filldlg/year">Use the <emph>Date</emph> series type and this option to create a series which unit of <emph>Increment</emph> is year.</ahelp></paragraph> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/filldlg/startValue" id="bm_id3145357" localize="false"/> + +<paragraph id="hd_id3154762" role="heading" level="2" xml-lang="en-US">Start Value</paragraph> +<paragraph id="par_id3149381" role="paragraph" xml-lang="en-US"><ahelp hid="modules/scalc/ui/filldlg/startValue">Determines the start value for the series.</ahelp> Use numbers, dates or times.</paragraph> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/filldlg/endValue" id="bm_id3153557" localize="false"/> + +<paragraph id="hd_id3153013" role="heading" level="2" xml-lang="en-US">End Value</paragraph> +<paragraph id="par_id3153487" role="paragraph" xml-lang="en-US"><ahelp hid="modules/scalc/ui/filldlg/endValue">Determines the end value for the series.</ahelp> Use numbers, dates or times.</paragraph> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/filldlg/increment" id="bm_id3151196" localize="false"/> + +<paragraph id="hd_id3149312" role="heading" level="2" xml-lang="en-US">Increment</paragraph> +<paragraph id="par_id3154739" role="paragraph" xml-lang="en-US">The term "increment" denotes the amount by which a given value increases.<ahelp hid="modules/scalc/ui/filldlg/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/helpcontent2/source/text/scalc/01/02140700.xhp b/helpcontent2/source/text/scalc/01/02140700.xhp new file mode 100644 index 000000000..bc5a8f191 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/02140700.xhp @@ -0,0 +1,194 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . + --> + +<meta> +<topic id="ID" indexer="include" status="PUBLISH"> +<title xml-lang="en-US" id="tit">Fill Random Numbers</title> +<filename>/text/scalc/01/02140700.xhp</filename> +</topic> +</meta> +<body> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/randomnumbergenerator/RandomNumberGeneratorDialog" id="bm_id3150791" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/randomnumbergenerator/@@nowidget@@" id="bm_id3150791" localize="false"/> +<paragraph id="hd_id2308201415431520596" role="heading" xml-lang="en-US" level="1">Fill Random Numbers</paragraph> +<paragraph id="par_id2308201415431525817" role="paragraph" xml-lang="en-US"><ahelp hid=".">Populate a cell range with automatically generated pseudo random numbers with the selected distribution function and its parameters.</ahelp></paragraph> +<bookmark xml-lang="en-US" branch="index" id="bm_id2308201416102526759"> +<bookmark_value>fill range;random numbers</bookmark_value> +<bookmark_value>random rumbers;fill range</bookmark_value> +<bookmark_value>random rumbers;distribution</bookmark_value> +</bookmark> +<section id="howtoget"> +<paragraph id="par_id2308201415500176457" role="paragraph" xml-lang="en-US">Choose <item type="menuitem">Sheet - Fill Cells - Random Number</item></paragraph> +</section> +<paragraph id="hd_id2308201415431233475" role="heading" xml-lang="en-US" level="2">Data</paragraph> +<paragraph id="hd_id2308201415431883475" role="heading" xml-lang="en-US" level="3">Cell Range</paragraph> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/randomnumbergenerator/cell-range-edit" id="bm_id3150792" localize="false"/> +<paragraph id="par_id2308201415431811111" role="paragraph" xml-lang="en-US"><ahelp hid=".">Define the range of cells to fill with random numbers. If you have previously selected a range, it will be displayed here.</ahelp></paragraph> +<paragraph id="hd_id2308201415431850229" role="heading" xml-lang="en-US" level="2">Random number generator</paragraph> +<paragraph id="hd_id2308201415431880497" role="heading" xml-lang="en-US" level="3">Distribution</paragraph> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/randomnumbergenerator/distribution-combo" id="bm_id2308201416384294287" localize="false"/> +<paragraph id="par_id2308201415431874867" role="paragraph" xml-lang="en-US"><ahelp hid=".">The distribution function for the random number generator.</ahelp></paragraph> +<paragraph id="par_id2308201416441240058" role="paragraph" xml-lang="en-US">Valid distributions function and their parameters are</paragraph> + + +<table id="Tabela1"> +<tablerow> +<tablecell> +<paragraph id="par_id230820141543181813" role="tablehead" xml-lang="en-US">Distribution</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id2308201415431868807" role="tablehead" xml-lang="en-US">Parameters</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph id="par_id2308201415431869872" role="tablecontent" xml-lang="en-US">Uniform</paragraph> +</tablecell> +<tablecell> +<list type="unordered"> +<listitem> +<paragraph id="par_id2308201415431850857" role="ul_item" xml-lang="en-US"><emph>Minimum:</emph> The minimum value of the sample.</paragraph> +</listitem> +<listitem> +<paragraph id="par_id2308201415431859422" role="ul_item" xml-lang="en-US"><emph>Maximum:</emph> The maximum value of the sample.</paragraph> +</listitem></list> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph id="par_id2308201415431848733" role="tablecontent" xml-lang="en-US">Uniform Integer</paragraph> +</tablecell> +<tablecell> +<list type="unordered"> +<listitem> +<paragraph id="par_id2308201415431813421" role="ul_item" xml-lang="en-US"><emph>Minimum:</emph> The minimum value of the sample.</paragraph> +</listitem> +<listitem> +<paragraph id="par_id2308201415431821789" role="ul_item" xml-lang="en-US"><emph>Maximum:</emph> The maximum value of the sample.</paragraph> +</listitem></list> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph id="par_id2308201415431870493" role="tablecontent" xml-lang="en-US">Normal</paragraph> +</tablecell> +<tablecell> +<list type="unordered"> +<listitem> +<paragraph id="par_id2308201415431973994" role="ul_item" xml-lang="en-US"><emph>Mean:</emph> The mean of the Normal distribution.</paragraph> +</listitem> +<listitem> +<paragraph id="par_id2308201415431951090" role="ul_item" xml-lang="en-US"><emph>Standard Deviation:</emph> The standard deviation of the Normal distribution.</paragraph> +</listitem></list> +<paragraph id="par_id2308201415431990992" role="warning" xml-lang="en-US">The mean and standard deviation of the numbers generated may not equal the Mean and Standard Deviation inserted in the dialog.</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph id="par_id2308201415431912748" role="tablecontent" xml-lang="en-US">Cauchy</paragraph> +</tablecell> +<tablecell> +<list type="unordered"> +<listitem> +<paragraph id="par_id2308201415431923135" role="ul_item" xml-lang="en-US"><emph>Median:</emph> the median of the data or location parameter.</paragraph> +</listitem> +<listitem> +<paragraph id="par_id2308201415431997296" role="ul_item" xml-lang="en-US"><emph>Sigma:</emph> the scale parameter.</paragraph> +</listitem></list> +<paragraph id="par_id2308201415431971536" role="warning" xml-lang="en-US">The median and sigma of the generated numbers may not equal the data inserted in the dialog.</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph id="par_id2308201415431962173" role="tablecontent" xml-lang="en-US">Bernoulli</paragraph> +</tablecell> +<tablecell> +<list type="unordered"> +<listitem> +<paragraph id="par_id2308201415431994157" role="ul_item" xml-lang="en-US"><emph>p Value:</emph> The probability of success.</paragraph> +</listitem></list> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph id="par_id2308201415431979367" role="tablecontent" xml-lang="en-US">Binomial</paragraph> +</tablecell> +<tablecell> +<list type="unordered"> +<listitem> +<paragraph id="par_id2308201415431958372" role="ul_item" xml-lang="en-US"><emph>p Value:</emph> The probability of success of each trial.</paragraph> +</listitem> +<listitem> +<paragraph id="par_id2308201415431919718" role="ul_item" xml-lang="en-US"><emph>Number of trials:</emph> the number of trials of the experiment.</paragraph> +</listitem></list> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph id="par_id2308201415431985648" role="tablecontent" xml-lang="en-US">Chi Squared</paragraph> +</tablecell> +<tablecell> +<list type="unordered"> +<listitem> +<paragraph id="par_id230820141543194944" role="ul_item" xml-lang="en-US"><emph>Nu Value: </emph>a positive integer that specifies the number of degrees of freedom.</paragraph> +</listitem></list> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph id="par_id2308201415431935636" role="tablecontent" xml-lang="en-US">Geometric</paragraph> +</tablecell> +<tablecell> +<list type="unordered"> +<listitem> +<paragraph id="par_id2308201415431978150" role="ul_item" xml-lang="en-US"><emph>p Value:</emph> The probability of success of each trial.</paragraph> +</listitem></list> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph id="par_id230820141543197085" role="tablecontent" xml-lang="en-US">Negative Binomial</paragraph> +</tablecell> +<tablecell> +<list type="unordered"> +<listitem> +<paragraph id="par_id2308201415431916718" role="ul_item" xml-lang="en-US"><emph>p Value:</emph> The probability of success of each trial.</paragraph> +</listitem> +<listitem> +<paragraph id="par_id2308201415431951891" role="ul_item" xml-lang="en-US"><emph>Number of trials:</emph> the number of trials of the experiment.</paragraph> +</listitem></list> +</tablecell> +</tablerow> +</table> +<paragraph id="hd_id2308201415431232932" role="heading" xml-lang="en-US" level="2">Options</paragraph> +<paragraph id="hd_id2308201415431832932" role="heading" xml-lang="en-US" level="3">Enable custom seed</paragraph> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/randomnumbergenerator/enable-seed-check" id="bm_id3150793" localize="false"/> +<paragraph id="par_id2308201415431841782" role="paragraph" xml-lang="en-US"><ahelp hid=".">Set the initial value of the random number generator to a known value <emph>Seed.</emph></ahelp></paragraph> +<paragraph id="hd_id2308201415431881107" role="heading" xml-lang="en-US" level="3">Seed</paragraph> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/randomnumbergenerator/seed-spin" id="bm_id3150794" localize="false"/> +<paragraph id="par_id2308201415431834837" role="paragraph" xml-lang="en-US"><ahelp hid=".">Value set to initiate the random number generator algorithm. It is used to initialize (seed) the random number generator in order to reproduce the same sequence of pseudorandom numbers. Specify a positive integer number (1, 2, ...) to produce a specific sequence, or leave the field blank if you don't need this particular feature.</ahelp></paragraph> +<paragraph id="hd_id2308201415431875641" role="heading" xml-lang="en-US" level="3">Enable rounding</paragraph> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/randomnumbergenerator/enable-rounding-check" id="bm_id3150795" localize="false"/> +<paragraph id="par_id2308201415431822157" role="paragraph" xml-lang="en-US"><ahelp hid=".">Truncate the number to a given number of <emph>Decimal Places</emph>.</ahelp></paragraph> +<paragraph id="hd_id2308201415431826506" role="heading" xml-lang="en-US" level="3">Decimal places</paragraph> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/randomnumbergenerator/decimal-places-spin" id="bm_id3150796" localize="false"/> +<paragraph id="par_id2308201415431820502" role="paragraph" xml-lang="en-US"><ahelp hid=".">Number of decimal places of the numbers generated.</ahelp></paragraph> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/02150000.xhp b/helpcontent2/source/text/scalc/01/02150000.xhp new file mode 100644 index 000000000..5721ab049 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/02150000.xhp @@ -0,0 +1,70 @@ +<?xml version="1.0" encoding="UTF-8"?> + + + +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . + --> + + + <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> +<section id="del_contents"> +<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/modules/scalc/ui/deletecontents/DeleteContentsDialog" id="bm_id3145382" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/deletecontents/@@nowidget@@" id="bm_id3145382" localize="false"/> +<paragraph role="heading" id="hd_id3143284" xml-lang="en-US" level="1">Deleting Contents</paragraph> +<paragraph role="paragraph" id="par_id3149456" xml-lang="en-US"><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> +<section id="howtoget"> + <embed href="text/scalc/00/00000402.xhp#clear_cells"/> +</section> +<paragraph role="tip" id="par_id3159154" xml-lang="en-US">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">Pressing Delete deletes content without calling the dialog or changing formats.</paragraph> +<paragraph role="tip" id="par_id3153951" xml-lang="en-US">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">Selection</paragraph> +<paragraph role="paragraph" id="par_id3149665" xml-lang="en-US">This area lists the options for deleting contents.</paragraph> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/deletecontents/deleteall" id="bm_id3144766" localize="false"/><paragraph role="heading" id="hd_id3146975" xml-lang="en-US" level="3">Delete All</paragraph> +<paragraph role="paragraph" id="par_id3154729" xml-lang="en-US"><ahelp hid="modules/scalc/ui/deletecontents/deleteall">Deletes all content from the selected cell range.</ahelp></paragraph> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/deletecontents/text" id="bm_id3147394" localize="false"/><paragraph role="heading" id="hd_id3156286" xml-lang="en-US" level="3">Text<comment>i50439</comment></paragraph> +<paragraph role="paragraph" id="par_id3154015" xml-lang="en-US"><ahelp hid="modules/scalc/ui/deletecontents/text">Deletes text only. Formats, formulas, numbers and dates are not affected.</ahelp></paragraph> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/deletecontents/numbers" id="bm_id3156276" localize="false"/><paragraph role="heading" id="hd_id3153840" xml-lang="en-US" level="3">Numbers</paragraph> +<paragraph role="paragraph" id="par_id3148405" xml-lang="en-US"><ahelp hid="modules/scalc/ui/deletecontents/numbers">Deletes numbers only. Formats and formulas remain unchanged.</ahelp></paragraph> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/deletecontents/datetime" id="bm_id3154757" localize="false"/><paragraph role="heading" id="hd_id3155764" xml-lang="en-US" level="3">Date & time</paragraph> +<paragraph role="paragraph" id="par_id3149567" xml-lang="en-US"><ahelp hid="modules/scalc/ui/deletecontents/datetime">Deletes date and time values. Formats, text, numbers and formulas remain unchanged.</ahelp></paragraph> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/deletecontents/formulas" id="bm_id3149256" localize="false"/><paragraph role="heading" id="hd_id3154703" xml-lang="en-US" level="3">Formulas</paragraph> +<paragraph role="paragraph" id="par_id3148485" xml-lang="en-US"><ahelp hid="modules/scalc/ui/deletecontents/formulas">Deletes formulas. Text, numbers, formats, dates and times remain unchanged.</ahelp></paragraph> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/deletecontents/comments" id="bm_id3152775" localize="false"/><paragraph role="heading" id="hd_id3150300" xml-lang="en-US" level="3">Comments</paragraph> +<paragraph role="paragraph" id="par_id3154658" xml-lang="en-US"><ahelp hid="modules/scalc/ui/deletecontents/comments">Deletes comments added to cells. All other elements remain unchanged.</ahelp></paragraph> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/deletecontents/formats" id="bm_id3145258" localize="false"/><paragraph role="heading" id="hd_id3155112" xml-lang="en-US" level="3">Formats</paragraph> +<paragraph role="paragraph" id="par_id3146134" xml-lang="en-US"><ahelp hid="modules/scalc/ui/deletecontents/formats">Deletes format attributes applied to cells. All cell content remains unchanged.</ahelp></paragraph> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/deletecontents/objects" id="bm_id3152582" localize="false"/><paragraph role="heading" id="hd_id3150088" xml-lang="en-US" level="3">Objects</paragraph> +<paragraph role="paragraph" id="par_id3152990" xml-lang="en-US"><ahelp hid="modules/scalc/ui/deletecontents/objects">Deletes objects. All cell content remains unchanged.</ahelp></paragraph> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/02160000.xhp b/helpcontent2/source/text/scalc/01/02160000.xhp new file mode 100644 index 000000000..dd185bef7 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/02160000.xhp @@ -0,0 +1,82 @@ +<?xml version="1.0" encoding="UTF-8"?> + + + +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . + --> + + + <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> + + <section id="del_cells"> + +<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"/> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/deletecells/DeleteCellsDialog" id="bm_id3151116" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/deletecells/@@nowidget@@" id="bm_id3151116" localize="false"/> + <paragraph xml-lang="en-US" id="hd_id3153726" role="heading" level="1">Delete Cells</paragraph> + <paragraph xml-lang="en-US" id="par_id3154490" role="paragraph"><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> + <section id="howtoget"> + + <embed href="text/scalc/00/00000402.xhp#bzelo"/> + + </section> + <paragraph id="par_id082520160232335032" role="paragraph" xml-lang="en-US"><image id="img_id083120161149318932" src="media/screenshots/modules/scalc/ui/deletecells/DeleteCellsDialog.png" width="3.3126in" height="1.5209in"><alt xml-lang="en-US" id="alt_id083120161149318932">Delete cells dialog</alt></image></paragraph> + <paragraph xml-lang="en-US" id="hd_id3149121" role="heading" level="2">Selection</paragraph> + <paragraph xml-lang="en-US" id="par_id3150751" role="paragraph">This area contains options for specifying how sheets are displayed after deleting cells.</paragraph> + +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/deletecells/up" id="bm_id3154755" localize="false"/> + <paragraph xml-lang="en-US" id="hd_id3155767" role="heading" level="3">Shift cells up</paragraph> + <paragraph xml-lang="en-US" id="par_id3153714" role="paragraph"><ahelp hid="modules/scalc/ui/deletecells/up">Fills the space produced by the deleted cells with the cells underneath it.</ahelp></paragraph> + +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/deletecells/left" id="bm_id3147346" localize="false"/> + <paragraph xml-lang="en-US" id="hd_id3156382" role="heading" level="3">Shift cells left</paragraph> + <paragraph xml-lang="en-US" id="par_id3154702" role="paragraph"><ahelp hid="modules/scalc/ui/deletecells/left">Fills the resulting space by the cells to the right of the deleted cells.</ahelp></paragraph> + +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/deletecells/rows" 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">Delete entire row(s)</paragraph> + <paragraph xml-lang="en-US" id="par_id3148487" role="paragraph"><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/modules/scalc/ui/deletecells/cols" 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">Delete entire column(s)</paragraph> + <paragraph xml-lang="en-US" id="par_id3150086" role="paragraph"><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"><link href="text/scalc/01/02150000.xhp" name="Deleting Contents">Deleting Contents</link></paragraph> + + </section> + </body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/02170000.xhp b/helpcontent2/source/text/scalc/01/02170000.xhp new file mode 100644 index 000000000..531253d84 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/02170000.xhp @@ -0,0 +1,50 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . + --> + +<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> +</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_id3150769" localize="false"/> +<paragraph role="heading" id="hd_id3156424" xml-lang="en-US" level="1"> Delete Sheet</paragraph> +<paragraph role="paragraph" id="par_id3153193" xml-lang="en-US"><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#delete_sheet"/> +</section> +<paragraph role="note" id="par_id3145801" xml-lang="en-US">You cannot delete a sheet while <emph>Edit - Track Changes - Record</emph> is activated.</paragraph> +<paragraph role="heading" id="hd_id3147124" xml-lang="en-US" level="2">Yes</paragraph> +<paragraph role="paragraph" id="par_id3154943" xml-lang="en-US">Deletes the current sheet.</paragraph> +<paragraph role="heading" id="hd_id3149412" xml-lang="en-US" level="2">No</paragraph> +<paragraph role="paragraph" id="par_id3154510" xml-lang="en-US">Cancels the dialog. No delete is performed.</paragraph> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/02180000.xhp b/helpcontent2/source/text/scalc/01/02180000.xhp new file mode 100644 index 000000000..d18b1e473 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/02180000.xhp @@ -0,0 +1,58 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . + --> + +<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> +</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/modules/scalc/ui/movecopysheet/MoveCopySheetDialog" id="bm_id3149657" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/movecopysheet/@@nowidget@@" id="bm_id3149657" localize="false"/> +<paragraph role="heading" id="hd_id3153360" xml-lang="en-US" level="1">Move or Copy a Sheet</paragraph> +<paragraph role="paragraph" id="par_id3154686" xml-lang="en-US"><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#move_or_copy_sheet"/> +</section> +<paragraph role="warning" id="par_id2282479" xml-lang="en-US">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/modules/scalc/ui/movecopysheet/toDocument" id="bm_id3146119" localize="false"/> +<paragraph role="heading" id="hd_id3163710" xml-lang="en-US" level="2">To Document</paragraph> +<paragraph role="paragraph" id="par_id3148645" xml-lang="en-US"><ahelp hid="modules/scalc/ui/movecopysheet/toDocument">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/modules/scalc/ui/movecopysheet/insertBefore" id="bm_id3147350" localize="false"/> +<paragraph role="heading" id="hd_id3154012" xml-lang="en-US" level="2">Insert Before</paragraph> +<paragraph role="paragraph" id="par_id3145366" xml-lang="en-US"><ahelp hid="modules/scalc/ui/movecopysheet/insertBefore">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/modules/scalc/ui/movecopysheet/copy" id="bm_id3156283" localize="false"/> +<paragraph role="heading" id="hd_id3153726" xml-lang="en-US" level="2">Copy</paragraph> +<paragraph role="paragraph" id="par_id3144764" xml-lang="en-US"><ahelp hid="modules/scalc/ui/movecopysheet/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/helpcontent2/source/text/scalc/01/02190000.xhp b/helpcontent2/source/text/scalc/01/02190000.xhp new file mode 100644 index 000000000..2e42de1b2 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/02190000.xhp @@ -0,0 +1,44 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . +--> + +<meta> + <topic id="textscalc0102190000xml" indexer="include" status="PUBLISH"> + <title id="tit" xml-lang="en-US">Delete Page Break</title> + <filename>/text/scalc/01/02190000.xhp</filename> + </topic> +</meta> + +<body> + +<section id="del_page_break"> +<bookmark xml-lang="en-US" branch="hid/.uno:DelBreakMenu" id="bm_id8417004" localize="false"/> + +<paragraph id="hd_id3150541" role="heading" level="1" xml-lang="en-US"><link href="text/scalc/01/02190000.xhp" name="Delete Page Break">Delete Page Break</link></paragraph> +<paragraph id="par_id3154365" role="paragraph" xml-lang="en-US"><ahelp hid=".">Choose the type of page break that you want to delete.</ahelp></paragraph> +</section> + +<section id="howtoget"> +<embed href="text/scalc/00/sheet_menu.xhp#delete_page_break"/> +</section> +<embed href="text/scalc/01/02190100.xhp#row_break"/> +<embed href="text/scalc/01/02190200.xhp#column_break"/> +</body> + +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/02190100.xhp b/helpcontent2/source/text/scalc/01/02190100.xhp new file mode 100644 index 000000000..7c62fa602 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/02190100.xhp @@ -0,0 +1,47 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . + --> + +<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> +</history> +</meta> +<body> +<section id="row_break"> +<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"/> +<paragraph role="heading" id="hd_id3156326" xml-lang="en-US" level="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"><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">Position the cursor in a cell directly below the row break indicated by a horizontal line and choose <emph>Sheet - Delete Page Break - Row Break</emph>. The manual row break is removed.</paragraph> +<section id="howtoget"> + <embed href="text/scalc/00/sheet_menu.xhp#delete_page_break_row"/> +</section> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/02190200.xhp b/helpcontent2/source/text/scalc/01/02190200.xhp new file mode 100644 index 000000000..eccab059f --- /dev/null +++ b/helpcontent2/source/text/scalc/01/02190200.xhp @@ -0,0 +1,56 @@ +<?xml version="1.0" encoding="UTF-8"?> + + + +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . + --> + + + <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="column_break"> + + +<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"/> + + <paragraph xml-lang="en-US" id="hd_id3151384" role="heading" level="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"><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">Position the cursor in the cell to the right of the column break indicated by a vertical line and choose <emph>Sheet - Delete Page Break - Column Break</emph>. The manual column break is removed.</paragraph> + <section id="howtoget"> + + <embed href="text/scalc/00/sheet_menu.xhp#delete_page_break_column"/> + + </section> + </body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/02200000.xhp b/helpcontent2/source/text/scalc/01/02200000.xhp new file mode 100644 index 000000000..a8cb4735b --- /dev/null +++ b/helpcontent2/source/text/scalc/01/02200000.xhp @@ -0,0 +1,39 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.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="sheet"> +<bookmark xml-lang="en-US" branch="hid/.uno:EditSheetMenu" id="bm_id8190862" localize="false"/> + +<paragraph id="hd_id3146794" role="heading" level="1" xml-lang="en-US"><link href="text/scalc/01/02200000.xhp" name="Sheet">Sheet</link></paragraph> +<paragraph id="par_id3149456" role="paragraph" xml-lang="en-US"><ahelp hid=".">Edit commands for entire sheets.</ahelp></paragraph> +</section> +</body> + +</helpdocument>
\ No newline at end of file diff --git a/helpcontent2/source/text/scalc/01/02210000.xhp b/helpcontent2/source/text/scalc/01/02210000.xhp new file mode 100644 index 000000000..43f4cc522 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/02210000.xhp @@ -0,0 +1,42 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . + --> + +<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> +</history> +</meta> +<body> + + +<bookmark branch="hid/.uno:SelectTables" xml-lang="en-US" id="bm_id3154758" localize="false"/> +<paragraph role="heading" level="1" id="hd_id3156023" xml-lang="en-US">Selecting Sheets</paragraph> + <paragraph role="paragraph" id="par_id3147265" xml-lang="en-US"><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" localize="false"/> +<paragraph role="heading" level="2" id="hd_id3125863" xml-lang="en-US">Selected Sheets</paragraph> + <paragraph role="paragraph" id="par_id3153969" xml-lang="en-US"><ahelp hid="SC_HID_SELECTTABLES">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 <switchinline select="sys"><caseinline select="MAC">Command</caseinline><defaultinline>Ctrl</defaultinline></switchinline> 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/helpcontent2/source/text/scalc/01/02220000.xhp b/helpcontent2/source/text/scalc/01/02220000.xhp new file mode 100644 index 000000000..8d5ae097c --- /dev/null +++ b/helpcontent2/source/text/scalc/01/02220000.xhp @@ -0,0 +1,38 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- +* This file is part of the LibreOffice project. +* +* This Source Code Form is subject to the terms of the Mozilla Public +* License, v. 2.0. If a copy of the MPL was not distributed with this +* file, You can obtain one at http://mozilla.org/MPL/2.0/. +* +--> +<helpdocument version="1.0"> +<meta> +<topic id="textscalc0102220000xml" indexer="include" status="PUBLISH"> +<title xml-lang="en-US" id="tit">Go to Sheet</title> +<filename>/text/scalc/01/02220000.xhp</filename> +</topic> +<history> +<created date="2022-05-25T00:00:00">LibreOffice</created> +</history> +</meta> +<body> + + +<bookmark branch="hid/.uno:JumpToTable" xml-lang="en-US" id="bm_id3154761" localize="false"/> +<bookmark xml-lang="en-US" branch="index" id="bm_id781654171314500"> +<bookmark_value>Go to sheet</bookmark_value> +<bookmark_value>jump; to given sheet</bookmark_value> +<bookmark_value>sheet; go to directly</bookmark_value> +<bookmark_value>sheet; search and go to</bookmark_value> +</bookmark> +<h1 id="hd_id3156025">Go to Sheet</h1> + <paragraph role="paragraph" id="par_id3147266" xml-lang="en-US"><variable id="gototable"><ahelp hid=".uno:JumpToTable" visibility="visible">Go to a specified sheet.</ahelp></variable></paragraph> + <bookmark branch="hid/SC_HID_GOTOTABLE" xml-lang="en-US" id="bm_id3154128" localize="false"/> +<h2 id="hd_id3125862">Type a sheet name</h2> + <paragraph role="paragraph" id="par_id3153975" xml-lang="en-US"><ahelp hid="SC_HID_GOTOTABLEMASK">Type some characters contained in the searched sheet name. List of sheets will be limited to the sheet names containing these characters.</ahelp></paragraph> +<h2 id="hd_id3125866">Sheets</h2> + <paragraph role="paragraph" id="par_id3153971" xml-lang="en-US"><ahelp hid="SC_HID_GOTOTABLE">Lists the sheets in the current document. Hidden sheets are not listed. To select a sheet, press the up or down arrow keys to move to a sheet in the list. Double click on a name will directly jump to this sheet.</ahelp></paragraph> + </body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/03070000.xhp b/helpcontent2/source/text/scalc/01/03070000.xhp new file mode 100644 index 000000000..a9ef012f3 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/03070000.xhp @@ -0,0 +1,58 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.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> +</meta> + +<body> + + +<section id="column_and_row_headers"> +<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"/> + +<paragraph id="hd_id3156024" role="heading" level="1" xml-lang="en-US"><link href="text/scalc/01/03070000.xhp" name="Column & Row Headers">Column & Row Headers</link></paragraph> +<paragraph id="par_id3147230" role="paragraph" xml-lang="en-US"><ahelp hid=".">Shows column headers and row headers.</ahelp></paragraph> +</section> + +<list type="unordered"> + <listitem> + <paragraph id="par_id3156280" role="listitem" xml-lang="en-US">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 id="par_id3156441" role="listitem" xml-lang="en-US">You can also set the view of the column and row headers in <switchinline select="sys"><caseinline select="MAC"><item type="menuitem">%PRODUCTNAME - Preferences</item></caseinline><defaultinline><item type="menuitem">Tools - Options</item></defaultinline></switchinline> - <link href="text/shared/optionen/01060100.xhp" name="Spreadsheet - View"><emph>%PRODUCTNAME Calc - View</emph></link>.</paragraph> + </listitem></list> +</body> + +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/03080000.xhp b/helpcontent2/source/text/scalc/01/03080000.xhp new file mode 100644 index 000000000..e51a75913 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/03080000.xhp @@ -0,0 +1,55 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . +--> + +<meta> + <topic id="textscalc0103080000xml" indexer="include" status="PUBLISH"> + <title id="tit" xml-lang="en-US">Value Highlighting</title> + <filename>/text/scalc/01/03080000.xhp</filename> + </topic> +</meta> + +<body> + + +<section id="value_highlighting"> +<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" level="1" xml-lang="en-US"><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=".">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_id3145784" role="paragraph" xml-lang="en-US">By default:</paragraph> +<paragraph id="par_id3145785" role="paragraph" xml-lang="en-US">Text cells are formatted in black, formulas in green, number cells in blue, and protected cells are shown with light grey background, no matter how their display is formatted.</paragraph> +<paragraph id="par_id3145786" role="paragraph" xml-lang="en-US">These colors can be customized in <switchinline select="sys"><caseinline select="MAC"><item type="menuitem">%PRODUCTNAME - Preferences</item></caseinline><defaultinline><item type="menuitem">Tools - Options</item></defaultinline></switchinline><item type="menuitem"> - %PRODUCTNAME - Application Colors</item>.</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/helpcontent2/source/text/scalc/01/03090000.xhp b/helpcontent2/source/text/scalc/01/03090000.xhp new file mode 100644 index 000000000..1ced423ed --- /dev/null +++ b/helpcontent2/source/text/scalc/01/03090000.xhp @@ -0,0 +1,50 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.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> +</meta> + +<body> + + +<section id="formula_bar"> +<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"/> + +<paragraph id="hd_id3147264" role="heading" level="1" xml-lang="en-US"><link href="text/scalc/01/03090000.xhp" name="Formula Bar">Formula Bar</link></paragraph> +<paragraph id="par_id3156423" role="paragraph" xml-lang="en-US"><ahelp hid=".">Shows or hides the Formula Bar, which is used for entering and editing formulas. The Formula Bar is the most important tool when working with spreadsheets.</ahelp></paragraph> +</section> +<paragraph id="par_id3154686" role="paragraph" xml-lang="en-US">To hide the Formula Bar, unmark the menu item.</paragraph> + +<section id="howtoget"> +<embed href="text/scalc/00/00000403.xhp#rechenleiste"/> +</section> +<paragraph id="par_id3145787" role="paragraph" xml-lang="en-US">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/helpcontent2/source/text/scalc/01/03100000.xhp b/helpcontent2/source/text/scalc/01/03100000.xhp new file mode 100644 index 000000000..8228e4b20 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/03100000.xhp @@ -0,0 +1,53 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . +--> + +<meta> + <topic id="textscalc0103100000xml" indexer="include" status="PUBLISH"> + <title id="tit" xml-lang="en-US">Page Break View</title> + <filename>/text/scalc/01/03100000.xhp</filename> + </topic> +</meta> + +<body> + + +<section id="page_break_view_title"> +<bookmark xml-lang="en-US" branch="hid/.uno:PagebreakMode" id="bm_id3465342" localize="false"/> + +<paragraph id="hd_id3151384" role="heading" level="1" xml-lang="en-US"><link href="text/scalc/01/03100000.xhp" name="Page Break View">Page Break View</link></paragraph> +<paragraph id="par_id3150792" role="paragraph" xml-lang="en-US"><variable id="page_break_view_text"><ahelp hid=".">Display the page breaks and print ranges in the sheet.</ahelp></variable> Choose <item type="menuitem">View - Normal</item> to switch this mode off.</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 id="par_id3153877" role="paragraph" xml-lang="en-US">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"/> + +<paragraph id="hd_id3154731" role="heading" level="2" xml-lang="en-US">Delete Page Breaks</paragraph> +<paragraph id="par_id3149400" role="paragraph" xml-lang="en-US"><ahelp hid=".">Deletes all manual breaks in the current sheet.</ahelp></paragraph> + +<paragraph id="hd_id3155067" role="heading" level="2" xml-lang="en-US">Add Print Range</paragraph> +<paragraph id="par_id3155764" role="paragraph" xml-lang="en-US">Adds the selected cells to print ranges.</paragraph> +</body> + +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/04010000.xhp b/helpcontent2/source/text/scalc/01/04010000.xhp new file mode 100644 index 000000000..00344263a --- /dev/null +++ b/helpcontent2/source/text/scalc/01/04010000.xhp @@ -0,0 +1,49 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . + --> + +<helpdocument version="1.0"> +<meta> +<topic id="textscalc0104010000xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Insert Page Break</title> +<filename>/text/scalc/01/04010000.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +</history> +</meta> +<body> +<section id="ins_page_break"> +<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"><link href="text/scalc/01/04010000.xhp" name="Insert Page Break">Insert Page Break</link></paragraph> +<paragraph role="paragraph" id="par_id3125864" xml-lang="en-US"><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">Choose <link href="text/scalc/01/02190000.xhp" name="Sheet - Delete Page Break">Sheet - Delete Page Break</link> to remove breaks created manually.</paragraph> +<section id="howtoget"> + <embed href="text/scalc/00/sheet_menu.xhp#insert_page_break"/> +</section> +<embed href="text/scalc/01/04010100.xhp#row_break"/> +<embed href="text/scalc/01/04010200.xhp#column_break"/> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/04010100.xhp b/helpcontent2/source/text/scalc/01/04010100.xhp new file mode 100644 index 000000000..c6c8824b6 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/04010100.xhp @@ -0,0 +1,48 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . + --> + +<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> +</history> +</meta> +<body> +<section id="row_break"> +<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_id3151245" localize="false"/> +<paragraph role="heading" id="hd_id3153821" xml-lang="en-US" level="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"><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">The manual row break is indicated by a dark blue horizontal line.</paragraph> +<section id="howtoget"> + <embed href="text/scalc/00/sheet_menu.xhp#insert_page_break_row"/> +</section> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/04010200.xhp b/helpcontent2/source/text/scalc/01/04010200.xhp new file mode 100644 index 000000000..c2f81fbd4 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/04010200.xhp @@ -0,0 +1,48 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . + --> + +<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> +</history> +</meta> +<body> +<section id="column_break"> +<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_id3148947" localize="false"/> +<paragraph role="heading" id="hd_id3155923" xml-lang="en-US" level="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"><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">The manual column break is indicated by a dark blue vertical line.</paragraph> +<section id="howtoget"> + <embed href="text/scalc/00/sheet_menu.xhp#insert_page_break_column"/> +</section> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/04020000.xhp b/helpcontent2/source/text/scalc/01/04020000.xhp new file mode 100644 index 000000000..3d9ccd2dd --- /dev/null +++ b/helpcontent2/source/text/scalc/01/04020000.xhp @@ -0,0 +1,68 @@ +<?xml version="1.0" encoding="UTF-8"?> + + + +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . + --> + + + <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/modules/scalc/ui/insertcells/InsertCellsDialog" id="bm_id3147264" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/insertcells/@@nowidget@@" id="bm_id3147264" localize="false"/> +<paragraph role="heading" id="hd_id3156023" xml-lang="en-US" level="1"> Insert Cells</paragraph> +<paragraph role="paragraph" id="par_id3150542" xml-lang="en-US"><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#insert_cells"/> +</section> +<paragraph role="heading" id="hd_id3153768" xml-lang="en-US" level="2">Selection</paragraph> +<paragraph role="paragraph" id="par_id3149262" xml-lang="en-US">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/modules/scalc/ui/insertcells/down" id="bm_id3152578" localize="false"/> +<paragraph role="heading" id="hd_id3146120" xml-lang="en-US" level="3">Shift cells down</paragraph> +<paragraph role="paragraph" id="par_id3152596" xml-lang="en-US"><variable id="zellenuntentext"><ahelp hid="modules/scalc/ui/insertcells/down">Moves the contents of the selected range downward when cells are inserted.</ahelp> +</variable></paragraph> +<embed href="text/scalc/00/00000404.xhp#syinsert_cells_down"/> +<bookmark xml-lang="en-US" branch="hid/.uno:InsertCellsRight" id="bm_id7689959" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/insertcells/right" id="bm_id3147348" localize="false"/> +<paragraph role="heading" id="hd_id3147434" xml-lang="en-US" level="3">Shift cells right</paragraph> +<paragraph role="paragraph" id="par_id3144764" xml-lang="en-US"><variable id="zellenrechtstext"><ahelp hid="modules/scalc/ui/insertcells/right">Moves the contents of the selected range to the right when cells are inserted.</ahelp> +</variable></paragraph> +<embed href="text/scalc/00/00000404.xhp#syinsert_cells_right"/> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/insertcells/rows" id="bm_id3154731" localize="false"/><paragraph role="heading" id="hd_id3153877" xml-lang="en-US" level="3">Entire row</paragraph> +<paragraph role="paragraph" id="par_id3155417" xml-lang="en-US"><variable id="zeilenganzetext"><ahelp hid="modules/scalc/ui/insertcells/rows">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#syinsert_rows"/> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/insertcells/cols" id="bm_id3150750" localize="false"/><paragraph role="heading" id="hd_id3146971" xml-lang="en-US" level="3">Entire column</paragraph> +<paragraph role="paragraph" id="par_id3155068" xml-lang="en-US"><variable id="spaltenganzetext"><ahelp hid="modules/scalc/ui/insertcells/cols">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#syinsert_columns"/> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/04030000.xhp b/helpcontent2/source/text/scalc/01/04030000.xhp new file mode 100644 index 000000000..367ad26d4 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/04030000.xhp @@ -0,0 +1,58 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . +--> + +<meta> + <topic id="textscalc0104030000xml" indexer="include" status="PUBLISH"> + <title id="tit" xml-lang="en-US">Insert Rows</title> + <filename>/text/scalc/01/04030000.xhp</filename> + </topic> +</meta> + +<body> + + +<bookmark xml-lang="en-US" branch="index" 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:InsertRowsBefore" id="bm_id4302477" localize="false"/> + +<paragraph id="hd_id3150541" role="heading" level="1" xml-lang="en-US"><link href="text/scalc/01/04030000.xhp" name="Insert Rows">Insert Rows</link></paragraph> +<paragraph id="par_id160220162210581072" role="paragraph" xml-lang="en-US"><variable id="sheet_insert_rows">Insert rows above or below the active cell.</variable> The number of rows inserted corresponds to the number of rows selected. If no row is selected, one row is inserted. The existing rows are moved downward.</paragraph> + +<paragraph id="hd_id160220162131439740" role="heading" level="2" xml-lang="en-US">Rows Above</paragraph> +<paragraph id="par_id3150767" role="paragraph" xml-lang="en-US"><ahelp hid=".uno:InsertRowsBefore">Inserts a new row above the active cell.</ahelp></paragraph> + +<section id="howtoget"> +<embed href="text/scalc/00/sheet_menu.xhp#insert_rows_above"/> +</section> + +<bookmark xml-lang="en-US" branch="hid/.uno:InsertColumnsAfter" id="bm_id601010" localize="false"/> +<paragraph id="hd_id160220162133372726" role="heading" level="2" xml-lang="en-US">Rows Below</paragraph> +<paragraph id="par_id3150768" role="paragraph" xml-lang="en-US"><ahelp hid=".uno:InsertRowsAfter">Inserts a new row below the active cell.</ahelp></paragraph> + +<section id="howtoget"> +<embed href="text/scalc/00/sheet_menu.xhp#insert_rows_below"/> +</section> +</body> + +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/04040000.xhp b/helpcontent2/source/text/scalc/01/04040000.xhp new file mode 100644 index 000000000..f51d1311f --- /dev/null +++ b/helpcontent2/source/text/scalc/01/04040000.xhp @@ -0,0 +1,58 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . +--> + +<meta> + <topic id="textscalc0104040000xml" indexer="include"> + <title id="tit" xml-lang="en-US">Insert Columns</title> + <filename>/text/scalc/01/04040000.xhp</filename> + </topic> +</meta> + +<body> + + +<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:InsertColumnsBefore" id="bm_id601010" localize="false"/> + +<paragraph id="hd_id3155628" role="heading" level="1" xml-lang="en-US"><link href="text/scalc/01/04040000.xhp" name="Insert Columns">Insert Columns</link></paragraph> +<paragraph id="par_id160220162214111932" role="paragraph" xml-lang="en-US"><variable id="sheet_insert_columns">Inserts columns to the left or to the right of the active cell.</variable> The number of columns inserted corresponds to the number of columns selected. If no column is selected, one column is inserted. The existing columns are moved to the right.</paragraph> + +<paragraph id="hd_id160220162139258865" role="heading" level="2" xml-lang="en-US">Columns Before</paragraph> +<paragraph id="par_id3150791" role="paragraph" xml-lang="en-US"><ahelp hid=".uno:InsertColumnsBefore">Inserts a new column before the active cell.</ahelp></paragraph> + +<section id="howtoget"> +<embed href="text/scalc/00/sheet_menu.xhp#insert_columns_left"/> +</section> + +<bookmark xml-lang="en-US" branch="hid/.uno:InsertColumnsAfter" id="bm_id601010" localize="false"/> +<paragraph id="hd_id160220162139252941" role="heading" level="2" xml-lang="en-US">Columns After</paragraph> +<paragraph id="par_id160220162138041164" role="paragraph" xml-lang="en-US"><ahelp hid=".uno:InsertColumnsAfter">Inserts a new column after the active cell.</ahelp></paragraph> + +<section id="howtoget"> +<embed href="text/scalc/00/sheet_menu.xhp#insert_columns_right"/> +</section> +</body> + +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/04050000.xhp b/helpcontent2/source/text/scalc/01/04050000.xhp new file mode 100644 index 000000000..7f4eab60f --- /dev/null +++ b/helpcontent2/source/text/scalc/01/04050000.xhp @@ -0,0 +1,74 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> + +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . + --> + + +<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/modules/scalc/ui/insertsheet/InsertSheetDialog" id="bm_id3151384" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/insertsheet/@@nowidget@@" id="bm_id3151384" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/.uno:Insert" id="bm_id1669896" localize="false"/> +<paragraph role="heading" id="hd_id3155629" xml-lang="en-US" level="1">Insert Sheet</paragraph> +<paragraph role="paragraph" id="par_id3147264" xml-lang="en-US"><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">Position</paragraph> +<paragraph role="paragraph" id="par_id3156281" xml-lang="en-US">Specifies where the new sheet is to be inserted into your document.</paragraph> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/insertsheet/before" id="bm_id3155131" localize="false"/> +<paragraph role="heading" id="hd_id3154123" xml-lang="en-US" level="3">Before current sheet</paragraph> +<paragraph role="paragraph" id="par_id3145787" xml-lang="en-US"><ahelp hid="modules/scalc/ui/insertsheet/before">Inserts a new sheet directly before the current sheet.</ahelp></paragraph> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/insertsheet/after" id="bm_id3147434" localize="false"/> +<paragraph role="heading" id="hd_id3155414" xml-lang="en-US" level="3">After current sheet</paragraph> +<paragraph role="paragraph" id="par_id3145271" xml-lang="en-US"><ahelp hid="modules/scalc/ui/insertsheet/after">Inserts a new sheet directly after the current sheet.</ahelp></paragraph> +<paragraph role="heading" id="hd_id3147428" xml-lang="en-US" level="2">Sheet</paragraph> +<paragraph role="paragraph" id="par_id3154012" xml-lang="en-US">Specifies whether a new sheet or an existing sheet is inserted into the document.</paragraph> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/insertsheet/new" id="bm_id3145750" localize="false"/> +<paragraph role="heading" id="hd_id3147350" xml-lang="en-US" level="2">New sheet</paragraph> +<paragraph role="paragraph" id="par_id3149262" xml-lang="en-US"><ahelp hid="modules/scalc/ui/insertsheet/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/modules/scalc/ui/insertsheet/countnf" id="bm_id3153157" localize="false"/> +<paragraph role="heading" id="hd_id3155418" xml-lang="en-US" level="3">No. of sheets</paragraph> +<paragraph role="paragraph" id="par_id3148457" xml-lang="en-US"><ahelp hid="modules/scalc/ui/insertsheet/countnf">Specifies the number of sheets to be created.</ahelp></paragraph> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/insertsheet/nameed" id="bm_id3154510" localize="false"/> +<paragraph role="heading" id="hd_id3149379" xml-lang="en-US" level="3">Name</paragraph> +<paragraph role="paragraph" id="par_id3150718" xml-lang="en-US"><ahelp hid="modules/scalc/ui/insertsheet/nameed">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/modules/scalc/ui/insertsheet/fromfile" id="bm_id3150328" localize="false"/> +<paragraph role="heading" id="hd_id3155066" xml-lang="en-US" level="2">From File</paragraph> +<paragraph role="paragraph" id="par_id3153714" xml-lang="en-US"><ahelp hid="modules/scalc/ui/insertsheet/fromfile">Inserts a sheet from an existing file into the current document.</ahelp></paragraph> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/insertsheet/browse" id="bm_id3150044" localize="false"/> +<paragraph role="heading" id="hd_id3149020" xml-lang="en-US" level="3">Browse</paragraph> +<paragraph role="paragraph" id="par_id3159267" xml-lang="en-US"><ahelp hid="modules/scalc/ui/insertsheet/browse">Opens a dialog for selecting a file.</ahelp></paragraph> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/insertsheet/tables" id="bm_id3146314" localize="false"/> +<paragraph role="heading" id="hd_id3149255" xml-lang="en-US" level="3">Available Sheets</paragraph> +<paragraph role="paragraph" id="par_id3155336" xml-lang="en-US"><ahelp hid="modules/scalc/ui/insertsheet/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/modules/scalc/ui/insertsheet/link" id="bm_id3149814" localize="false"/> +<paragraph role="heading" id="hd_id3145791" xml-lang="en-US" level="3">Link</paragraph> +<paragraph role="paragraph" id="par_id3152580" xml-lang="en-US"><ahelp hid="modules/scalc/ui/insertsheet/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/helpcontent2/source/text/scalc/01/04050100.xhp b/helpcontent2/source/text/scalc/01/04050100.xhp new file mode 100644 index 000000000..0d120c768 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/04050100.xhp @@ -0,0 +1,49 @@ +<?xml version="1.0" encoding="UTF-8"?> + + + +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . + --> + + + <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"/> +<paragraph role="heading" id="par_idN105C1" xml-lang="en-US" level="1"><link href="text/scalc/01/04050100.xhp">Sheet from file</link></paragraph> +<paragraph role="paragraph" id="par_idN105D1" xml-lang="en-US"><ahelp hid=".">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">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">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/helpcontent2/source/text/scalc/01/04060000.xhp b/helpcontent2/source/text/scalc/01/04060000.xhp new file mode 100644 index 000000000..4fad66a05 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/04060000.xhp @@ -0,0 +1,110 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> + +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . + --> + + +<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> + +<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/formula/ui/functionpage/FunctionPage" id="bm_id3145749" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/formula/ui/functionpage/@@nowidget@@" id="bm_id3145749" localize="false"/> +<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"/> +<section id="function_wizard"> +<h1 id="hd_id3147426"><link href="text/scalc/01/04060000.xhp" name="AutoPilot: Functions">Function</link></h1> +<paragraph role="paragraph" id="par_id3145271" xml-lang="en-US"><variable id="funktionsautopilottext"><ahelp hid=".">Opens the <emph>Function Wizard</emph>, which helps you to interactively create formulas.</ahelp></variable></paragraph> +</section> +<paragraph role="paragraph" id="par_id491577286833512">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#insert_function"/> +</section> +<note id="par_id8007446">You can download the complete ODFF (OpenDocument Format Formula) specification from the <link href="https://docs.oasis-open.org/office/v1.2/OpenDocument-v1.2-part2.odt"><emph>OASIS</emph></link> web site.</note> +<paragraph role="paragraph" id="par_id3159153" xml-lang="en-US">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> +<h2 id="hd_id3154490">Functions Tab</h2> +<bookmark xml-lang="en-US" branch="hid/formula/ui/functionpage/search" id="bm_id1185225" localize="false"/> +<h3 id="hd_id3154731">Search</h3> +<paragraph role="paragraph" id="par_id3155440" xml-lang="en-US"><ahelp hid="formula/ui/functionpage/search">Search for a part of the function name.</ahelp></paragraph> +<bookmark xml-lang="en-US" branch="hid/formula/ui/functionpage/category" id="bm_id1185226" localize="false"/> +<h3 id="hd_id3154730">Category</h3> +<paragraph role="paragraph" id="par_id3153417" xml-lang="en-US"><variable id="kategorienliste"><ahelp hid="formula/ui/functionpage/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> +<paragraph role="paragraph" id="par_id3149378" xml-lang="en-US">You can browse the full <link href="text/scalc/01/04060100.xhp" name="List of Categories and Functions"><emph>List of Categories and Functions</emph></link>.</paragraph> +<bookmark xml-lang="en-US" branch="hid/formula/ui/functionpage/function" id="bm_id1185227" localize="false"/> +<h3 id="hd_id3150749">Function</h3> +<paragraph role="paragraph" id="par_id3155445" xml-lang="en-US"><ahelp hid="formula/ui/functionpage/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> +<bookmark xml-lang="en-US" branch="hid/formula/ui/formuladialog/array" id="bm_id1185228" localize="false"/> +<h3 id="hd_id3159264">Array</h3> +<paragraph role="paragraph" id="par_id3149566" xml-lang="en-US"><ahelp hid="formula/ui/formuladialog/array">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">The <emph>Array</emph> option is identical to the <switchinline select="sys"><caseinline select="MAC"><emph>Command</emph></caseinline><defaultinline><emph>Ctrl</emph></defaultinline></switchinline><emph>+Shift+Enter</emph> command, which is used to enter and confirm formulas in the sheet. The formula is inserted as a matrix formula indicated by two braces: <emph>{ }</emph>.</paragraph> +<note id="par_id3152993">The maximum size of an array range is 128 by 128 cells.</note> +<h3 id="hd_id3150367">Argument Input Fields</h3> +<paragraph role="paragraph" id="par_id3145587" xml-lang="en-US">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"><emph>date entries</emph></link>, make sure you use the correct format. Click <emph>OK</emph> to insert the result into the spreadsheet.</paragraph> +<embed href="text/shared/00/00000001.xhp#shrink_maximize"/> +<bookmark xml-lang="en-US" branch="hid/formula/ui/formuladialog/result" id="bm_id1185233" localize="false"/> +<h3 id="hd_id3149408">Function Result</h3> +<paragraph role="paragraph" id="par_id3155809" xml-lang="en-US">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"><emph>error code</emph></link> is displayed.</paragraph> +<paragraph role="paragraph" id="par_id3148700" xml-lang="en-US">The required arguments are indicated by names in bold print.</paragraph> +<bookmark xml-lang="en-US" branch="hid/formula/ui/parameter/FX1" id="bm_id1185230" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/formula/ui/parameter/FX2" id="bm_id1185231" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/formula/ui/parameter/FX3" id="bm_id1185232" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/formula/ui/parameter/FX4" id="bm_id1185233" localize="false"/> +<h3 id="hd_id3153064">f(x) (depending on the selected function)</h3> +<paragraph role="paragraph" id="par_id3157980" xml-lang="en-US"><ahelp hid=".">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> +<h3 id="hd_id3145076">Argument/Parameter/Cell Reference (depending on the selected function)</h3> +<paragraph role="paragraph" id="par_id3159097" xml-lang="en-US">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.</paragraph> +<bookmark xml-lang="en-US" branch="hid/formula/ui/formuladialog/formula_result" id="bm_id1185239" localize="false"/> +<h3 id="hd_id3154957">Result</h3> +<paragraph role="paragraph" id="par_id3150211" xml-lang="en-US"><ahelp hid="formula/ui/formuladialog/formula_result">Displays the calculation result or an error message.</ahelp></paragraph> +<bookmark xml-lang="en-US" branch="hid/formula/ui/formuladialog/ed_formula" id="bm_id1185234" localize="false"/> +<h3 id="hd_id3151304">Formula</h3> +<paragraph role="paragraph" id="par_id3149898" xml-lang="en-US"><ahelp hid="formula/ui/formuladialog/ed_formula">Displays the created formula. Type your entries directly, or create the formula using the wizard.</ahelp></paragraph> +<bookmark xml-lang="en-US" branch="hid/formula/ui/formuladialog/back" id="bm_id1185235" localize="false"/> +<h3 id="hd_id3153249">Back</h3> +<paragraph role="paragraph" id="par_id3152869" xml-lang="en-US"><ahelp hid="formula/ui/formuladialog/back">Moves the focus back through the formula components, marking them as it does so.</ahelp></paragraph> +<tip id="par_id3146966">To select a single function from a complex formula consisting of several functions, double-click the function in the formula window.</tip> +<bookmark xml-lang="en-US" branch="hid/formula/ui/formuladialog/next" id="bm_id1185236" localize="false"/> +<h3 id="hd_id3155762">Next</h3> +<paragraph role="paragraph" id="par_id3149316" xml-lang="en-US"><ahelp hid="formula/ui/formuladialog/next">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> +<tip id="par_id3159262">Double-click a function in the selection window to transfer it to the formula window.</tip> +<bookmark xml-lang="en-US" branch="hid/formula/ui/formuladialog/ok" id="bm_id1185238" localize="false"/> +<h3 id="hd_id3150534">OK</h3> +<paragraph role="paragraph" id="par_id3153029" xml-lang="en-US"><ahelp hid="formula/ui/formuladialog/ok">Ends the <emph>Function Wizard</emph>, and transfers the formula to the selected cells.</ahelp></paragraph> +<bookmark xml-lang="en-US" branch="hid/formula/ui/formuladialog/cancel" id="bm_id1185237" localize="false"/> +<h3 id="hd_id3148745">Cancel</h3> +<paragraph role="paragraph" id="par_id3147402" xml-lang="en-US"><ahelp hid="formula/ui/formuladialog/cancel">Closes the dialog without implementing the formula.</ahelp></paragraph> +<h2 id="hd_id3147610">Structure tab</h2> +<paragraph role="paragraph" id="par_id3153122" xml-lang="en-US">On this page, you can view the structure of the function.</paragraph> +<note id="par_id3149350">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.</note> +<bookmark xml-lang="en-US" branch="hid/formula/ui/structpage/struct" id="bm_id1185240" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/formula/ui/structpage/StructPage" id="bm_id671598996689983" localize="false"/> +<h3 id="hd_id3149014">Structure</h3> +<paragraph role="paragraph" id="par_id3150481" xml-lang="en-US"><ahelp hid="formula/ui/structpage/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> +<note id="par_id3148886">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.</note> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/04060100.xhp b/helpcontent2/source/text/scalc/01/04060100.xhp new file mode 100644 index 000000000..d5aa76ba5 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/04060100.xhp @@ -0,0 +1,60 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . + --> + +<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> +<h1 xml-lang="en-US" id="hd_id3154944"><variable id="drking"><link href="text/scalc/01/04060100.xhp" name="Functions by Category">Functions by Category</link></variable></h1> + <paragraph xml-lang="en-US" id="par_id3149378" role="paragraph">This section describes the functions of $[officename] Calc. The various functions are divided into categories in the Function Wizard.</paragraph> + <h2 xml-lang="en-US" id="hd_id3146972"><link href="text/scalc/01/04060101.xhp" name="Database">Database</link></h2> + <embed href="text/scalc/01/04060101.xhp#datenbanktext"/> + <paragraph xml-lang="en-US" id="hd_id3155443" role="heading" level="2"><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"><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"><link href="text/scalc/01/04060104.xhp" name="Information">Information</link></paragraph> + <embed href="text/scalc/01/04060104.xhp#informationtext"/> + <h2 xml-lang="en-US" id="hd_id3146316"><link href="text/scalc/01/04060105.xhp" name="Logical">Logical</link></h2> + <embed href="text/scalc/01/04060105.xhp#logicaltext"/> + <paragraph xml-lang="en-US" id="hd_id3148485" role="heading" level="2"><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"><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"><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"><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"><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"><link href="text/scalc/01/04060111.xhp" name="Add-in">Add-in</link></paragraph> + <embed href="text/scalc/01/04060111.xhp#addintext"/> + <section id="relatedtopics"> + <paragraph xml-lang="en-US" id="par_id3150715" role="paragraph"><link href="text/scalc/01/04060199.xhp" name="Operators">Operators</link></paragraph> + </section> + </body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/04060101.xhp b/helpcontent2/source/text/scalc/01/04060101.xhp new file mode 100644 index 000000000..543c76bed --- /dev/null +++ b/helpcontent2/source/text/scalc/01/04060101.xhp @@ -0,0 +1,1022 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> + +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . + --> + + + <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> + + <h1 id="hd_id3148946">Database Functions</h1> + <h3 id="hd_id721616440441374">Overview</h3> + <paragraph xml-lang="en-US" id="par_id3145173" role="paragraph"><variable id="datenbanktext">The twelve functions in the Database category help you to analyze a simple database that occupies a rectangular spreadsheet area comprising columns and rows, with the data organized as one row for each record.</variable> The header cell of each column displays the name of the column and that name usually reflects the contents of each cell in that column.</paragraph> + <paragraph role="paragraph" id="par_id631615842419413">The functions in the Database category take three arguments as follows:</paragraph> + <list type="ordered"> + <listitem> + <paragraph id="par_id761615842549780" role="listitem"><emph>Database</emph>. The cell range of the database.</paragraph> + </listitem> + <listitem> + <paragraph id="par_id601615842657372" role="listitem"><emph>DatabaseField</emph>. The column containing the data to be used in the function’s calculations.</paragraph> + </listitem> + <listitem> + <paragraph id="par_id471615842721059" role="listitem"><emph>SearchCriteria</emph>. The cell range of a separate area of the spreadsheet containing search criteria.</paragraph> + </listitem> + </list> + <paragraph role="paragraph" id="par_id101615842794525">These arguments are described more fully below.</paragraph> + <paragraph role="paragraph" id="par_id241615842810077">All functions have the same outline concept of operation. The first logical step is to use the specified <emph>SearchCriteria</emph> to identify the subset of records in the <emph>Database</emph> that are to be used during subsequent calculations. The second step is to extract the data values and perform the calculations associated with the specific function (average, sum, product, and so on). The values processed are those in the <emph>DatabaseField</emph> column of the selected records.</paragraph> + <note id="par_id981615978852310">Calc treats dates and logical values (TRUE and FALSE) as numeric when calculating with these functions.</note> + + <h3 id="hd_id911615888814785">Database Function Arguments</h3> + <paragraph role="paragraph" id="par_id911615888833104">The following argument definitions apply for all functions in the Database category:</paragraph> + <list type="ordered"> + <listitem> + <paragraph id="par_id21615889071992" role="listitem"><emph>Database argument</emph></paragraph> + <paragraph role="paragraph" id="par_id31615889105463"><emph>Database</emph> specifies the range of cells occupied by the database table. The first row of the range contains the field names, and subsequent rows are records with corresponding field values.</paragraph> + <paragraph role="paragraph" id="par_id521615889152497">One way of defining the range of cells is to enter the cell reference for the upper left-hand cell, followed by a colon (:), and then the lower right-hand cell reference. An example might be A1:E10.</paragraph> + <paragraph role="paragraph" id="par_id761615889163416">The <emph>Database</emph> argument may also be specified by passing the name of a named range or database range. Using a meaningful name to define the cell range can enhance formula readability and document maintenance. If the name does not match the name of a defined range, Calc reports a #NAME? error.</paragraph> + <paragraph role="paragraph" id="par_id601615889176137">Other errors that might be reported as a result of an invalid <emph>Database</emph> argument are #VALUE! and Err:504 (error in parameter list).</paragraph> + </listitem> + <listitem> + <paragraph id="par_id201615889390777" role="listitem"><emph>DatabaseField argument</emph></paragraph> + <paragraph role="paragraph" id="par_id431615889426480"><emph>DatabaseField</emph> specifies the column which the function will use for its calculations after the search criteria have been applied and the data rows have been selected. It is not related to the search criteria.</paragraph> + <paragraph role="paragraph" id="par_id661615889458032">Specify the <emph>DatabaseField</emph> argument in any of the following ways:</paragraph> + <section id="par_id191615890762881"><comment>Dummy section inserted to nest unordered list within ordered list.</comment> + <list type="unordered"> + <listitem> + <paragraph id="par_id981615889517841" role="listitem">By entering a reference to a header cell within the <emph>Database</emph> area. Alternatively, if the cell has been given a meaningful name as a named range or database range, enter that name. If the name does not match the name of a defined range, Calc reports a #NAME? error. If the name is valid but does not correspond to one cell only, Calc reports Err:504 (error in parameter list).</paragraph> + </listitem> + <listitem> + <paragraph id="par_id551615889661457" role="listitem">By entering a number to specify the column within the <emph>Database</emph> area, starting with 1. For example, if a <emph>Database</emph> occupied the cell range D6:H123, then enter 3 to indicate the header cell at F6. Calc expects an integer value that lies between 1 and the number of columns defined within <emph>Database</emph> and ignores any digits after a decimal point. If the value is less than 1, Calc reports Err:504 (error in parameter list). If the value is greater than the number of columns in <emph>Database</emph>, Calc reports a #VALUE! error.</paragraph> + </listitem> + <listitem> + <paragraph id="par_id561615889738472" role="listitem">By entering the literal column header name from the first row of the <emph>Database</emph> range, placing quotation marks around the header name. For example, “Distance to School”. If the string does not match one of the <emph>Database</emph> area’s column headings, Calc reports Err:504 (error in parameter list). You can also provide a reference to an arbitrary cell (not within the <emph>Database</emph> and <emph>SearchCriteria</emph> areas) that contains the required string.</paragraph> + </listitem> + </list> + </section> + <paragraph role="paragraph" id="par_id181615889841279">The <emph>DatabaseField</emph> argument is optional for the DCOUNT and DCOUNTA functions but it is required for the other ten Database functions.</paragraph> + </listitem> + <listitem> + <paragraph id="par_id841615891322513" role="listitem"><emph>SearchCriteria argument</emph></paragraph> + <paragraph role="paragraph" id="par_id351615891337585"><emph>SearchCriteria</emph> specifies the range of cells containing search criteria. Like <emph>Database</emph>, its first row is also field names, and subsequent rows are conditions for related fields. The <emph>Database</emph> and <emph>SearchCriteria</emph> areas need not be adjacent, or even on the same sheet.</paragraph> + <paragraph role="paragraph" id="par_id401615891342289">One way of defining the range of cells is to enter the cell reference for the upper left-hand cell, followed by a colon (:), and then the lower right-hand cell reference. For example, A13:B14. The cell range may also be specified by passing the name of a defined named range or database range. If the name does not match the name of a defined range, Calc reports a #NAME? error.</paragraph> + <paragraph role="paragraph" id="par_id861615891345281">Err:504 (error in parameter list) may also be reported as a result of an invalid <emph>SearchCriteria</emph> argument.</paragraph> + <paragraph role="paragraph" id="par_id901615891349688">The contents of the <emph>SearchCriteria</emph> area are described in more detail in the next section.</paragraph> + </listitem> + + </list> + + <h3 id="hd_id481615892281210">Defining Search Criteria</h3> + <paragraph role="paragraph" id="par_id691615892329680">The number of columns occupied by the <emph>SearchCriteria</emph> area need not be the same as the width of the <emph>Database</emph> area. All headings that appear in the first row of <emph>SearchCriteria</emph> must be identical to headings in the first row of <emph>Database</emph>. However, not all headings in <emph>Database</emph> need appear in the first row of <emph>SearchCriteria</emph>, while a heading in <emph>Database</emph> can appear multiple times in the first row of <emph>SearchCriteria</emph>.</paragraph> + <paragraph role="paragraph" id="par_id541615892358897">Search criteria are entered into the cells of the second and subsequent rows of the <emph>SearchCriteria</emph> area, below the row containing headings. Blank cells within the <emph>SearchCriteria</emph> area are ignored.</paragraph> + <paragraph role="paragraph" id="par_id151615892882441">Create criteria in the cells of the <emph>SearchCriteria</emph> area using the comparison operators <, <=, =, <>, >=, and >. = is assumed if a cell is not empty but does not start with a comparison operator.</paragraph> + <paragraph role="paragraph" id="par_id561615893059337">If you write several criteria in one row, they are connected by AND. If you write several criteria in different rows, they are connected by OR.</paragraph> + <paragraph role="paragraph" id="par_id401615893095178">Criteria can be created using wildcards, providing that wildcards have been enabled via the <menuitem>Enable wildcards in formulas</menuitem> option on the <link href="text/shared/optionen/01060500.xhp" name="Spreadsheet - Calculate"><switchinline select="sys"><caseinline select="MAC"><menuitem>%PRODUCTNAME - Preferences</menuitem></caseinline><defaultinline><menuitem>Tools - Options</menuitem></defaultinline></switchinline><menuitem> - %PRODUCTNAME Calc - Calculate</menuitem></link> dialog. When interoperability with Microsoft Excel is important for your spreadsheet, this option should be enabled.</paragraph> + <paragraph role="paragraph" id="par_id921615893158111">Even more powerful criteria can be created using regular expressions, providing that regular expressions have been enabled via the <menuitem>Enable regular expressions in formulas</menuitem> option on the <link href="text/shared/optionen/01060500.xhp" name="Spreadsheet - Calculate"><switchinline select="sys"><caseinline select="MAC"><menuitem>%PRODUCTNAME - Preferences</menuitem></caseinline><defaultinline><menuitem>Tools - Options</menuitem></defaultinline></switchinline><menuitem> - %PRODUCTNAME Calc - Calculate</menuitem></link> dialog.</paragraph> + + <embed href="text/shared/00/00000001.xhp#regexnumex"/> + + <paragraph role="paragraph" id="par_id881615893236930">Another setting that affects how the search criteria are handled is the <menuitem>Search criteria = and <> must apply to whole cells</menuitem> option on the <link href="text/shared/optionen/01060500.xhp" name="Spreadsheet - Calculate"><switchinline select="sys"><caseinline select="MAC"><menuitem>%PRODUCTNAME - Preferences</menuitem></caseinline><defaultinline><menuitem>Tools - Options</menuitem></defaultinline></switchinline><menuitem> - %PRODUCTNAME Calc - Calculate</menuitem></link> dialog. This option controls whether the search criteria you set for the Database functions must match the whole cell exactly. When interoperability with Microsoft Excel is important for your spreadsheet, this option should be enabled.</paragraph> + + <h3 id="hd_id3150329">Examples of Database Function Use</h3> + <paragraph xml-lang="en-US" id="par_id3153713" role="paragraph">The following table provides an example database table that is utilized to demonstrate how to use the functions in the Database category. The cell range A1:E10 contains fictitious information about the guests invited to Joe's birthday party. The following information is given for each guest - name, school grade, 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" localize="false" role="tablehead">A</paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3146316" localize="false" role="tablehead">B</paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3150297" localize="false" role="tablehead">C</paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3150344" localize="false" role="tablehead">D</paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3150785" localize="false" role="tablehead">E</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3150090" localize="false" role="tablehead">1</paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3152992" role="tablecontent"><emph>Name</emph></paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3155532" role="tablecontent"><emph>Grade</emph></paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3156448" role="tablecontent"><emph>Age</emph></paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3154486" role="tablecontent"><emph>Distance</emph></paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3152899" role="tablecontent"><emph>Weight</emph></paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3153816" localize="false" role="tablehead">2</paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3151240" role="tablecontent">Andy</paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3156016" localize="false" role="tablecontent">3</paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3145073" localize="false" role="tablecontent">9</paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3154956" localize="false" role="tablecontent">150</paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3153976" localize="false" role="tablecontent">40</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3150894" localize="false" role="tablehead">3</paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3152870" role="tablecontent">Betty</paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3149692" localize="false" role="tablecontent">4</paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3154652" localize="false" role="tablecontent">10</paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3149381" localize="false" role="tablecontent">1000</paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3153812" localize="false" role="tablecontent">42</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3146965" localize="false" role="tablehead">4</paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3155596" role="tablecontent">Charles</paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3147244" localize="false" role="tablecontent">3</paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3149871" localize="false" role="tablecontent">10</paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3155752" localize="false" role="tablecontent">300</paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3149052" localize="false" role="tablecontent">51</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3146097" localize="false" role="tablehead">5</paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3147296" role="tablecontent">Daniel</paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3150393" localize="false" role="tablecontent">5</paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3145236" localize="false" role="tablecontent">11</paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3150534" localize="false" role="tablecontent">1200</paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3150375" localize="false" role="tablecontent">48</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3159121" localize="false" role="tablehead">6</paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3150456" role="tablecontent">Eva</paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3146886" localize="false" role="tablecontent">2</paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3149945" localize="false" role="tablecontent">8</paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3157904" localize="false" role="tablecontent">650</paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3149352" localize="false" role="tablecontent">33</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3150028" localize="false" role="tablehead">7</paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3145826" role="tablecontent">Frank</paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3150743" localize="false" role="tablecontent">2</paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3154844" localize="false" role="tablecontent">7</paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3148435" localize="false" role="tablecontent">300</paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3148882" localize="false" role="tablecontent">42</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3150140" localize="false" role="tablehead">8</paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3146137" role="tablecontent">Greta</paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3148739" localize="false" role="tablecontent">1</paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3148583" localize="false" role="tablecontent">7</paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3154556" localize="false" role="tablecontent">200</paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3155255" localize="false" role="tablecontent">36</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3145141" localize="false" role="tablehead">9</paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3153078" role="tablecontent">Harry</paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3149955" localize="false" role="tablecontent">3</paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3150005" localize="false" role="tablecontent">9</paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3155951" localize="false" role="tablecontent">1200</paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3145169" localize="false" role="tablecontent">44</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3153571" localize="false" role="tablehead">10</paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3148761" role="tablecontent">Irene</paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3149877" localize="false" role="tablecontent">2</paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3154327" localize="false" role="tablecontent">8</paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3155435" localize="false" role="tablecontent">1000</paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3145353" localize="false" role="tablecontent">42</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3150662" localize="false" role="tablehead">11</paragraph> + </tablecell> + <tablecell> + </tablecell> + <tablecell> + </tablecell> + <tablecell> + </tablecell> + <tablecell> + </tablecell> + <tablecell> + </tablecell> + </tablerow> + </table> + + <paragraph role="paragraph" id="par_id221616245476190">The following six examples use the database table above, combined with different search criteria areas.</paragraph> + + <h4 id="hd_id861616245631924">Example 1</h4> + <table id="tab_id191616245640932"> + <tablerow> + <tablecell> + </tablecell> + <tablecell> + <paragraph id="par_id441616245640933" localize="false" role="tablehead">A</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id291616245640933" localize="false" role="tablehead">B</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id881616245705884" localize="false" role="tablehead">C</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id301616245711996" localize="false" role="tablehead">D</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id191616245715444" localize="false" role="tablehead">E</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id841616245640933" localize="false" role="tablehead">12</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id891616245640933" role="tablecontent"><emph>Name</emph></paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id451616245640933" role="tablecontent"><emph>Grade</emph></paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id151616245818988" role="tablecontent"><emph>Age</emph></paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id481616245878460" role="tablecontent"><emph>Distance</emph></paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id741616245891772" role="tablecontent"><emph>Weight</emph></paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id641616245660252" localize="false" role="tablehead">13</paragraph> + </tablecell> + <tablecell> + </tablecell> + <tablecell> + </tablecell> + <tablecell> + </tablecell> + <tablecell> + <paragraph id="par_id41616246075884" localize="false" role="tablecontent">>600</paragraph> + </tablecell> + <tablecell> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id321616245665844" localize="false" role="tablehead">14</paragraph> + </tablecell> + <tablecell> + </tablecell> + <tablecell> + </tablecell> + <tablecell> + </tablecell> + <tablecell> + </tablecell> + <tablecell> + </tablecell> + </tablerow> + </table> + + <paragraph role="paragraph" id="par_id451616246535763">As in this simple example, it is sometimes desirable (but not essential) to place the search criteria area directly under the database table, with the columns of the two areas vertically aligned. Blank entries in the search criteria area are ignored. With the above example database table and this search criteria area, insert the formula <item type="input">=DCOUNT(A1:E10;;A12:E14)</item> into an empty cell elsewhere in the sheet to count how many of Joe’s guests travel further than 600 meters to school. The value 5 is returned (counting Betty, Daniel, Eva, Harry, and Irene).</paragraph> + <paragraph role="paragraph" id="par_id731616246561901">Note also that the formula <item type="input">=DCOUNT(A1:E10;;D12:D13)</item> returns exactly the same value, demonstrating that it is only necessary for the search criteria area to contain relevant column headings. </paragraph> + <h4 id="hd_id191616246773750">Example 2</h4> + + <table id="tab_id861616246804093"> + <tablerow> + <tablecell> + </tablecell> + <tablecell> + <paragraph id="par_id951616246804093" localize="false" role="tablehead">   A   </paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id411616246804093" localize="false" role="tablehead">   B   </paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id581616246838019" localize="false" role="tablehead">   C   </paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id421616246860604" localize="false" role="tablehead">   D   </paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id371616246868876" localize="false" role="tablehead">   E   </paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id401616246804093" localize="false" role="tablehead">12</paragraph> + </tablecell> + <tablecell> + </tablecell> + <tablecell> + <paragraph id="par_id71616246804093" role="tablecontent"><emph>Age</emph></paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id41616250394431" role="tablecontent"><emph>Grade</emph></paragraph> + </tablecell> + <tablecell> + </tablecell> + <tablecell> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id991616250406886" localize="false" role="tablehead">13</paragraph> + </tablecell> + <tablecell> + </tablecell> + <tablecell> + <paragraph id="par_id71616250414319" localize="false" role="tablecontent">>7</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id531616250419463" localize="false" role="tablecontent">2</paragraph> + </tablecell> + <tablecell> + </tablecell> + <tablecell> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id831616251223575" localize="false" role="tablehead">14</paragraph> + </tablecell> + <tablecell> + </tablecell> + <tablecell> + </tablecell> + <tablecell> + </tablecell> + <tablecell> + </tablecell> + <tablecell> + </tablecell> + </tablerow> + </table> + + <paragraph role="paragraph" id="par_id361616251794063">In this example the search criteria area contains only two headings and these are not vertically aligned with the corresponding headings in the example database table. Since there are two conditions in the same row, these are connected by AND. With the above example database table and this search criteria area, insert the formula <item type="input">=DCOUNT(A1:E10;;B12:C13)</item> into an empty cell elsewhere in the sheet to count how many of Joe’s guests are in grade 2 and greater than 7 years old. The value 2 is returned (counting Eva and Irene).</paragraph> + + <h4 id="hd_id221616251986854">Example 3</h4> + + <table id="tab_id851616251871487"> + <tablerow> + <tablecell> + </tablecell> + <tablecell> + <paragraph id="par_id21616251871487" localize="false" role="tablehead">   A   </paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id311616251871487" localize="false" role="tablehead">   B   </paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id191616251892502" localize="false" role="tablehead">   C   </paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id761616251895935" localize="false" role="tablehead">   D   </paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id711616251899470" localize="false" role="tablehead">   E   </paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id431616251871487" localize="false" role="tablehead">12</paragraph> + </tablecell> + <tablecell> + </tablecell> + <tablecell> + <paragraph id="par_id141616251871487" role="tablecontent"><emph>Age</emph></paragraph> + </tablecell> + <tablecell> + </tablecell> + <tablecell> + </tablecell> + <tablecell> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id471616251933256" localize="false" role="tablehead">13</paragraph> + </tablecell> + <tablecell> + </tablecell> + <tablecell> + <paragraph id="par_id211616251944567" localize="false" role="tablecontent">9</paragraph> + </tablecell> + <tablecell> + </tablecell> + <tablecell> + </tablecell> + <tablecell> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id31616252165976" localize="false" role="tablehead">14</paragraph> + </tablecell> + <tablecell> + </tablecell> + <tablecell> + <paragraph id="par_id921616252172663" localize="false" role="tablecontent">10</paragraph> + </tablecell> + <tablecell> + </tablecell> + <tablecell> + </tablecell> + <tablecell> + </tablecell> + </tablerow> + </table> + + <paragraph role="paragraph" id="par_id351616252313215">In this example the search criteria area contains only one heading. Since there are two conditions in consecutive rows, these are connected by OR. With the above example database table and this search criteria area, insert the formula <item type="input">=DCOUNT(A1:E10;;B12:B14)</item> into an empty cell elsewhere in the sheet to count how many of Joe’s guests are either 9 or 10 years old. The value 4 is returned (counting Andy, Betty, Charles, and Harry).</paragraph> + + <h4 id="hd_id71616252395407">Example 4 </h4> + <table id="tab_id741616252413665"> + <tablerow> + <tablecell> + </tablecell> + <tablecell> + <paragraph id="par_id361616252413665" localize="false" role="tablehead">   A   </paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id991616252413665" localize="false" role="tablehead">   B   </paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id111616252426590" localize="false" role="tablehead">   C   </paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id771616252429942" localize="false" role="tablehead">   D   </paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id651616252434463" localize="false" role="tablehead">   E   </paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id131616252413665" localize="false" role="tablehead">12</paragraph> + </tablecell> + <tablecell> + </tablecell> + <tablecell> + <paragraph id="par_id451616252413665" role="tablecontent"><emph>Age</emph></paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id431616252540783" role="tablecontent"><emph>Age</emph></paragraph> + </tablecell> + <tablecell> + </tablecell> + <tablecell> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id591616252561087" localize="false" role="tablehead">13</paragraph> + </tablecell> + <tablecell> + </tablecell> + <tablecell> + <paragraph id="par_id411616252568693" localize="false" role="tablecontent">>=8</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id441616252573495" localize="false" role="tablecontent"><=10</paragraph> + </tablecell> + <tablecell> + </tablecell> + <tablecell> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id841616252597982" localize="false" role="tablehead">14</paragraph> + </tablecell> + <tablecell> + </tablecell> + <tablecell> + </tablecell> + <tablecell> + </tablecell> + <tablecell> + </tablecell> + <tablecell> + </tablecell> + </tablerow> + </table> + + <paragraph role="paragraph" id="par_id991616252981928">In this example the search criteria area contains two occurrences of the same heading. Since there are two conditions in the same row, these are connected by AND. With the above example database table and this search criteria area, insert the formula <item type="input">=DCOUNT(A1:E10;;B12:C13)</item> into an empty cell elsewhere in the sheet to count how many of Joe’s guests are aged between 8 and 10 (inclusive). The value 6 is returned (counting Andy, Betty, Charles, Eva, Harry, and Irene). </paragraph> + + <h4 id="hd_id561616253067881">Example 5</h4> + <table id="tab_id601616253073598"> + <tablerow> + <tablecell> + </tablecell> + <tablecell> + <paragraph id="par_id981616253073598" localize="false" role="tablehead">   A   </paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id851616253073598" localize="false" role="tablehead">   B   </paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id681616253083615" localize="false" role="tablehead">   C   </paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id711616253086822" localize="false" role="tablehead">   D   </paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id231616253091555" localize="false" role="tablehead">   E   </paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id681616253073598" localize="false" role="tablehead">12</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id301616253073598" role="tablecontent"><emph>Name</emph></paragraph> + </tablecell> + <tablecell> + </tablecell> + <tablecell> + </tablecell> + <tablecell> + </tablecell> + <tablecell> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id231616253246590" localize="false" role="tablehead">13</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id251616253264022" localize="false" role="tablecontent">F*</paragraph> + </tablecell> + <tablecell> + </tablecell> + <tablecell> + </tablecell> + <tablecell> + </tablecell> + <tablecell> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id501616253322927" localize="false" role="tablehead">14</paragraph> + </tablecell> + <tablecell> + </tablecell> + <tablecell> + </tablecell> + <tablecell> + </tablecell> + <tablecell> + </tablecell> + <tablecell> + </tablecell> + </tablerow> + </table> + + <paragraph role="paragraph" id="par_id91616253394127">This simple example shows the use of wildcards. For this example to work as intended, select to enable wildcards at <link href="text/shared/optionen/01060500.xhp" name="Spreadsheet - Calculate"><switchinline select="sys"><caseinline select="MAC"><menuitem>%PRODUCTNAME - Preferences</menuitem></caseinline><defaultinline><menuitem>Tools - Options</menuitem></defaultinline></switchinline><menuitem> - %PRODUCTNAME Calc - Calculate</menuitem></link>. With the above example database table and this search criteria area, insert the formula <item type="input">=DCOUNT(A1:E10;;A12:A13)</item> into an empty cell elsewhere in the sheet to count how many of Joe’s guests have names that begin with the letter “F”. The value 1 is returned (counting Frank).</paragraph> + + + <h4 id="hd_id121616253593255">Example 6</h4> + <table id="tab_id441616253599063"> + <tablerow> + <tablecell> + </tablecell> + <tablecell> + <paragraph id="par_id691616253599063" localize="false" role="tablehead">   A   </paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id231616253599063" localize="false" role="tablehead">   B   </paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id401616253606239" localize="false" role="tablehead">   C   </paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id661616253609823" localize="false" role="tablehead">   D   </paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id581616253613127" localize="false" role="tablehead">   E   </paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id191616253599063" localize="false" role="tablehead">12</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id731616253599063" role="tablecontent"><emph>Name</emph></paragraph> + </tablecell> + <tablecell> + </tablecell> + <tablecell> + </tablecell> + <tablecell> + </tablecell> + <tablecell> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id391616253645567" localize="false" role="tablehead">13</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id761616253649791" localize="false" role="tablecontent">[ABC].*</paragraph> + </tablecell> + <tablecell> + </tablecell> + <tablecell> + </tablecell> + <tablecell> + </tablecell> + <tablecell> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id301616253665959" localize="false" role="tablehead">14</paragraph> + </tablecell> + <tablecell> + </tablecell> + <tablecell> + </tablecell> + <tablecell> + </tablecell> + <tablecell> + </tablecell> + <tablecell> + </tablecell> + </tablerow> + </table> + + <paragraph role="paragraph" id="par_id631616253692350">This simple example shows the use of regular expressions. For this example to work as intended, select to enable regular expressions at <link href="text/shared/optionen/01060500.xhp" name="Spreadsheet - Calculate"><switchinline select="sys"><caseinline select="MAC"><menuitem>%PRODUCTNAME - Preferences</menuitem></caseinline><defaultinline><menuitem>Tools - Options</menuitem></defaultinline></switchinline><menuitem> - %PRODUCTNAME Calc - Calculate</menuitem></link>. With the above example database table and this search criteria area, insert the formula <item type="input">=DCOUNT(A1:E10;;A12:A13)</item> into an empty cell elsewhere in the sheet to count how many of Joe’s guests have names that begin with the letters “A”, “B”, or “C”. The value 3 is returned (counting Andy, Betty, and Charles).</paragraph> + + <sort order="asc" descendant="h2"> + <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"/> + <h2 id="hd_id3150882">DCOUNT</h2> + <paragraph xml-lang="en-US" id="par_id3156133" role="paragraph"><ahelp hid="HID_FUNC_DBANZAHL">DCOUNT counts the number of cells (fields) of the specified column that contain numeric values, for all rows (database records) that match the specified search criteria.</ahelp> However, if no column is specified, DCOUNT returns the count of all records that match the specified search criteria irrespective of their contents.</paragraph> + + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph xml-lang="en-US" id="par_id3153218" role="code">DCOUNT(Database; [DatabaseField]; SearchCriteria)</paragraph> + + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph xml-lang="en-US" id="par_id3153623" role="paragraph">The example database table giving information about the guests invited to Joe’s birthday party (described above) should occupy cells A1:E10. The content of cells A12:E12 should be identical to the header labels for the database table in cells A1:E1. Make sure that cells A13:E13 are blank, except for cell D13 which should contain ">600" (this search criterion will match records in the database table that have a value greater than 600 in the Distance column).</paragraph> + <paragraph role="paragraph" id="par_id441616368480646">Insert the formula <input>=DCOUNT(A1:E10;; A12:E13)</input> into an empty cell elsewhere in the sheet to calculate how many of Joe’s party guests travel further than 600 meters to school. The value 5 is returned.</paragraph> + <paragraph role="paragraph" id="par_id361616368488119">The same result is obtained if you use the formula <input>=DCOUNT(A1:E10; "Distance"; A12:E13)</input>, because all entries in the Distance column are numeric. However, if you use the formula <input>=DCOUNT(A1:E10; "Name"; A12:E13)</input>, the value 0 is returned because all entries in the Name column are non-numeric.</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"/> + <h2 id="hd_id3156123">DCOUNTA</h2> + <paragraph xml-lang="en-US" id="par_id3156110" role="paragraph"><ahelp hid="HID_FUNC_DBANZAHL2">DCOUNTA counts the number of cells (fields) of the specified column that are not blank, for all rows (database records) that match the specified search criteria.</ahelp> Blank cells of the specified column are not counted. However, if no column is specified, DCOUNTA returns the count of all records that match the specified search criteria irrespective of their contents.</paragraph> + + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph xml-lang="en-US" id="par_id3146893" role="code">DCOUNTA(Database; [DatabaseField]; SearchCriteria)</paragraph> + + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph xml-lang="en-US" id="par_id3153982" role="paragraph">The example database table giving information about the guests invited to Joe’s birthday party (described above) should occupy cells A1:E10. The content of cells A12:E12 should be identical to the header labels for the database table in cells A1:E1. Make sure that cells A13:E13 are blank, except for cell D13 which should contain ">600" (this search criterion will match records in the database table that have a value greater than 600 in the Distance column).</paragraph> + <paragraph role="paragraph" id="par_id61616368616093">Insert the formula <input>=DCOUNTA(A1:E10;; A12:E13)</input> into an empty cell elsewhere in the sheet to calculate how many of Joe’s party guests travel further than 600 meters to school. The value 5 is returned.</paragraph> + <paragraph role="paragraph" id="par_id841616368623207">The same result is obtained if you use the formula <input>=DCOUNTA(A1:E10; "Distance"; A12:E13)</input> or the formula <input>=DCOUNTA(A1:E10; "Name"; A12:E13)</input>. The latter case reflects that in contrast to DCOUNT, DCOUNTA counts both numeric and alphanumeric values in the column indicated by the <emph>DatabaseField</emph> argument.</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"/> + <h2 id="hd_id3147256">DGET</h2> + <paragraph xml-lang="en-US" id="par_id3152801" role="paragraph"><ahelp hid="HID_FUNC_DBAUSZUG">DGET returns the contents of the cell (field) of the specified column, for the single row (database record) that matches the specified search criteria.</ahelp></paragraph> + <paragraph role="paragraph" id="par_id171616180137385">Calc reports Err:502 (invalid argument) if multiple matches are found, or a #VALUE! error (wrong data type) if no matches are found. A #VALUE! error is also reported if a single match is found but the relevant cell is empty.</paragraph> + + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph xml-lang="en-US" id="par_id3154696" role="code">DGET(Database; DatabaseField; SearchCriteria)</paragraph> + + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph xml-lang="en-US" id="par_id3155388" role="paragraph">The example database table giving information about the guests invited to Joe’s birthday party (described above) should occupy cells A1:E10. The content of cells A12:E12 should be identical to the header labels for the database table in cells A1:E1. Make sure that cells A13:E13 are blank, except for cell C13 which should contain "11" (this search criterion will match records in the database table that have a value of 11 in the Age column).</paragraph> + <paragraph xml-lang="en-US" id="par_id3153096" role="paragraph">Insert the formula <input>=DGET(A1:E10; "Name"; A12:E13)</input> into an empty cell elsewhere in the sheet to find the name of Joe’s party guest who is age 11. The name Daniel is returned.</paragraph> + <paragraph xml-lang="en-US" id="par_id3150524" role="paragraph">If you change the value in cell C13 to “10”, then the formula <input>=DGET(A1:E10; "Name"; A12:E13)</input> returns an invalid argument error (Err:502). The reflects that multiple records match the specified criterion (both Betty and Charles are age 10).</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"/> + <h2 id="hd_id3149766">DMAX</h2> + <paragraph xml-lang="en-US" id="par_id3154903" role="paragraph"><ahelp hid="HID_FUNC_DBMAX">DMAX calculates the maximum value across the cells (fields) of the specified column that contain numeric values, for all rows (database records) that match the specified search criteria.</ahelp> Blank cells or cells containing non-numeric characters are not included.</paragraph> + <paragraph role="paragraph" id="par_id51616180409281">Returns 0 if no matches are found, or if there are no non-zero numeric values in the cells of the specified column for the matching records.</paragraph> + + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph xml-lang="en-US" id="par_id3159157" role="code">DMAX(Database; DatabaseField; SearchCriteria)</paragraph> + + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph xml-lang="en-US" id="par_id3148442" role="paragraph">The example database table giving information about the guests invited to Joe’s birthday party (described above) should occupy cells A1:E10. The content of cells A12:E12 should be identical to the header labels for the database table in cells A1:E1. Make sure that cells A13:E13 are blank, except for cell D13 which should contain ">0" (this search criterion is intended to match all records in the database table).</paragraph> + <paragraph xml-lang="en-US" id="par_id3148804" role="paragraph">Insert the formula <input>=DMAX(A1:E10; "Distance"; A12:E13)</input> into an empty cell elsewhere in the sheet to find the maximum distance in meters that any of Joe’s party guests travel to school. The value 1200 is returned.</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"/> + <h2 id="hd_id3159141">DMIN</h2> + <paragraph xml-lang="en-US" id="par_id3154261" role="paragraph"><ahelp hid="HID_FUNC_DBMIN">DMIN calculates the minimum value across the cells (fields) of the specified column that contain numeric values, for all rows (database records) that match the specified search criteria.</ahelp> Blank cells or cells containing non-numeric characters are not included.</paragraph> + <paragraph role="paragraph" id="par_id901616180605426">Returns 0 if no matches are found, or if there are no non-zero numeric values in the cells of the specified column for the matching records.</paragraph> + + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph xml-lang="en-US" id="par_id3148479" role="code">DMIN(Database; DatabaseField; SearchCriteria)</paragraph> + + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph xml-lang="en-US" id="par_id3148925" role="paragraph">The example database table giving information about the guests invited to Joe’s birthday party (described above) should occupy cells A1:E10. The content of cells A12:E12 should be identical to the header labels for the database table in cells A1:E1. Make sure that cells A13:E13 are blank, except for cell D13 which should contain ">0" (this search criterion is intended to match all records in the database table).</paragraph> + <paragraph xml-lang="en-US" id="par_id3149161" role="paragraph">Insert the formula <input>=DMIN(A1:E10; "Distance"; A12:E13)</input> into an empty cell elsewhere in the sheet to find the minimum distance in meters that any of Joe’s party guests travel to school. The value 150 is returned.</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"/> + <h2 id="hd_id3154274">DAVERAGE</h2> + <paragraph xml-lang="en-US" id="par_id3166453" role="paragraph"><ahelp hid="HID_FUNC_DBMITTELWERT">DAVERAGE calculates the average of the numeric values in the cells (fields) of the specified column, for all rows (database records) that match the specified search criteria.</ahelp> Non-numeric values in those cells are ignored.</paragraph> + <paragraph role="paragraph" id="par_id31615978739452">Returns a #DIV/0! error if no records match the specified search criteria, or if there are no numeric values in the cells of the specified column for the matching records.</paragraph> + + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph xml-lang="en-US" id="par_id3150710" role="code">DAVERAGE(Database; DatabaseField; SearchCriteria)</paragraph> + + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph xml-lang="en-US" id="par_id3149104" role="paragraph">The example database table giving information about the guests invited to Joe’s birthday party (described above) should occupy cells A1:E10. The content of cells A12:E12 should be identical to the header labels for the database table in cells A1:E1. Make sure that cells A13:E13 are blank, except for cell D13 which should contain ">0" (this search criterion is intended to match all records in the database table).</paragraph> + <paragraph role="paragraph" id="par_id201616368312277">Insert the formula <input>=DAVERAGE(A1:E10; "Distance"; A12:E13)</input> into an empty cell elsewhere in the sheet to calculate the average distance in meters travelled to school by Joe’s party guests. The value 666.67 is returned.</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"/> + <h2 id="hd_id3159269">DPRODUCT</h2> + <paragraph xml-lang="en-US" id="par_id3152879" role="paragraph"><ahelp hid="HID_FUNC_DBPRODUKT">DPRODUCT calculates the product of all numeric values in the cells (fields) of the specified column, for all rows (database records) that match the specified search criteria.</ahelp> Blank cells or cells containing non-numeric characters are not included.</paragraph> + <paragraph role="paragraph" id="par_id741616180868336">Returns 0 if no matches are found, or if there are no numeric values in the cells of the specified column for the matching records.</paragraph> + + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph xml-lang="en-US" id="par_id3154854" role="code">DPRODUCT(Database; DatabaseField; SearchCriteria)</paragraph> + + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph xml-lang="en-US" id="par_id3148986" role="paragraph">The example database table giving information about the guests invited to Joe’s birthday party (described above) should occupy cells A1:E10. The content of cells A12:E12 should be identical to the header labels for the database table in cells A1:E1. Make sure that cells A13:E13 are blank, except for cell C13 which should contain ">0" (this search criterion is intended to match all records in the database table).</paragraph> + <paragraph role="paragraph" id="par_id91616368981807">Insert the formula <input>=DPRODUCT(A1:E10; "Age"; A12:E13)</input> into an empty cell elsewhere in the sheet to calculate the product of the ages in years of Joe’s party guests. The value 279417600 is returned.</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"/> + <h2 id="hd_id3148462">DSTDEV</h2> + <paragraph xml-lang="en-US" id="par_id3154605" role="paragraph"><ahelp hid="HID_FUNC_DBSTDABW">DSTDEV calculates the sample standard deviation based on the numeric values in the cells (fields) of the specified column, for all rows (database records) that match the specified search criteria.</ahelp> Non-numeric values are ignored.</paragraph> + <paragraph role="paragraph" id="par_id121616181037440">Returns a #NUM! error if exactly one record matches the specified search criteria, or if there is only one numeric value in the cells of the specified column for the matching records.</paragraph> + <paragraph role="paragraph" id="par_id931616181041535">Returns 0 if no matches are found, or if there are no numeric values in the cells of the specified column for the matching records.</paragraph> + + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph xml-lang="en-US" id="par_id3148661" role="code">DSTDEV(Database; DatabaseField; SearchCriteria)</paragraph> + + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph xml-lang="en-US" id="par_id3149934" role="paragraph">The example database table giving information about the guests invited to Joe’s birthday party (described above) should occupy cells A1:E10. The content of cells A12:E12 should be identical to the header labels for the database table in cells A1:E1. Make sure that cells A13:D13 are blank and that cell E13 contains ">0" (this search criterion is intended to match all records in the database table).</paragraph> + <paragraph xml-lang="en-US" id="par_id3150630" role="paragraph">Insert the formula <input>=DSTDEV(A1:E10; "Weight"; A12:E13)</input> into an empty cell elsewhere in the sheet to calculate the sample standard deviation of the weights in kg of Joe’s party guests. The value 5.5 is returned.</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"/> + <h2 id="hd_id3150429">DSTDEVP</h2> + <paragraph xml-lang="en-US" id="par_id3145598" role="paragraph"><ahelp hid="HID_FUNC_DBSTDABWN">DSTDEVP calculates the population standard deviation based on the numeric values in the cells (fields) of the specified column, for all rows (database records) that match the specified search criteria.</ahelp> Non-numeric values are ignored.</paragraph> + <paragraph role="paragraph" id="par_id541616181205698">Returns a #NUM! error if no records match the specified search criteria, or if there are no numeric values in the cells of the specified column for the matching records.</paragraph> + + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph xml-lang="en-US" id="par_id3149484" role="code">DSTDEVP(Database; DatabaseField; SearchCriteria)</paragraph> + + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph xml-lang="en-US" id="par_id3155431" role="paragraph">The example database table giving information about the guests invited to Joe’s birthday party (described above) should occupy cells A1:E10. The content of cells A12:E12 should be identical to the header labels for the database table in cells A1:E1. Make sure that cells A13:D13 are blank and that cell E13 contains ">0" (this search criterion is intended to match all records in the database table).</paragraph> + <paragraph xml-lang="en-US" id="par_id3148411" role="paragraph">Insert the formula <input>=DSTDEVP(A1:E10; "Weight"; A12:E13)</input> into an empty cell elsewhere in the sheet to calculate the population standard deviation of the weights in kg of Joe’s party guests. The value 5.18545 is returned.</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"/> + <h2 id="hd_id3154794">DSUM</h2> + <paragraph xml-lang="en-US" id="par_id3149591" role="paragraph"><ahelp hid="HID_FUNC_DBSUMME">DSUM calculates the sum of all numeric values in the cells (fields) of the specified column, for all rows (database records) that match the specified search criteria.</ahelp> Blank cells or cells containing non-numeric characters are not included.</paragraph> + <paragraph role="paragraph" id="par_id691616181332088">Returns 0 if no matches are found, or if there are no numeric values in the cells of the specified column for the matching records.</paragraph> + + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph xml-lang="en-US" id="par_id3150989" role="code">DSUM(Database; DatabaseField; SearchCriteria)</paragraph> + + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph xml-lang="en-US" id="par_id3152766" role="paragraph">The example database table giving information about the guests invited to Joe’s birthday party (described above) should occupy cells A1:E10. The content of cells A12:E12 should be identical to the header labels for the database table in cells A1:E1. Make sure that cells A13:E13 are blank, except for cell D13 which should contain ">0" (this search criterion is intended to match all records in the database table).</paragraph> + <paragraph xml-lang="en-US" id="par_id3151312" role="paragraph">Insert the formula <input>=DSUM(A1:E10; "Distance"; A12:E13)</input> into an empty cell elsewhere in the sheet to find the total distance in meters that all of Joe’s party guests travel to school. The value 6000 is returned.</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"/> + <h2 id="hd_id3155614">DVAR</h2> + <paragraph xml-lang="en-US" id="par_id3154418" role="paragraph"><ahelp hid="HID_FUNC_DBVARIANZ">DVAR calculates the sample variance based on the numeric values in the cells (fields) of the specified column, for all rows (database records) that match the specified search criteria.</ahelp> Non-numeric values are ignored.</paragraph> + <paragraph role="paragraph" id="par_id301616181465164">Returns a #NUM! error if exactly one record matches the specified search criteria, or if there is only one numeric value in the cells of the specified column for the matching records.</paragraph> + <paragraph role="paragraph" id="par_id741616181469136">Returns 0 if no matches are found, or if there are no numeric values in the cells of the specified column for the matching records.</paragraph> + + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph xml-lang="en-US" id="par_id3156138" role="code">DVAR(Database; DatabaseField; SearchCriteria)</paragraph> + + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph xml-lang="en-US" id="par_id3153701" role="paragraph">The example database table giving information about the guests invited to Joe’s birthday party (described above) should occupy cells A1:E10. The content of cells A12:E12 should be identical to the header labels for the database table in cells A1:E1. Make sure that cells A13:E13 are blank, except for cell D13 which should contain ">0" (this search criterion is intended to match all records in the database table).</paragraph> + <paragraph xml-lang="en-US" id="par_id3153676" role="paragraph">Insert the formula <input>=DVAR(A1:E10; "Distance"; A12:E13)</input> into an empty cell elsewhere in the sheet to find the sample variance of the distances in meters that Joe’s party guests travel to school. The value 193125 is returned.</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"/> + <h2 id="hd_id3153880">DVARP</h2> + <paragraph xml-lang="en-US" id="par_id3155119" role="paragraph"><ahelp hid="HID_FUNC_DBVARIANZEN">DVARP calculates the population variation based on the numeric values in the cells (fields) of the specified column, for all rows (database records) that match the specified search criteria.</ahelp> Non-numeric values are ignored.</paragraph> + <paragraph role="paragraph" id="par_id301616181648263">Returns a #NUM! error if no records match the specified search criteria, or if there are no numeric values in the cells of the specified column for the matching records.</paragraph> + + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph xml-lang="en-US" id="par_id3153776" role="code">DVARP(Database; DatabaseField; SearchCriteria)</paragraph> + + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph xml-lang="en-US" id="par_id3147099" role="paragraph">The example database table giving information about the guests invited to Joe’s birthday party (described above) should occupy cells A1:E10. The content of cells A12:E12 should be identical to the header labels for the database table in cells A1:E1. Make sure that cells A13:E13 are blank, except for cell D13 which should contain ">0" (this search criterion is intended to match all records in the database table).</paragraph> + <paragraph xml-lang="en-US" id="par_id3147322" role="paragraph">Insert the formula <input>=DVARP(A1:E10; "Distance"; A12:E13)</input> into an empty cell elsewhere in the sheet to find the population variance of the distances in meters that Joe’s party guests travel to school. The value 171666.67 is returned.</paragraph> + </section> + </sort> + + <section id="relatedtopics"> + <embed href="text/scalc/01/04060100.xhp#drking"/> + </section> + </body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/04060102.xhp b/helpcontent2/source/text/scalc/01/04060102.xhp new file mode 100644 index 000000000..2e1fd1799 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/04060102.xhp @@ -0,0 +1,139 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . +--> + +<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> +<h1 id="hd_id3154536"><variable id="h1">Date & Time Functions</variable></h1> +<paragraph id="par_id3153973" role="paragraph" xml-lang="en-US"><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"> +<note id="par_idN10600">The functions whose names end with _ADD or _EXCEL2003 return the same results as the corresponding Microsoft Excel 2003 functions without the suffix. Use the functions without suffix to get results based on international standards.</note> +</section> +<paragraph id="par_id3150437" role="paragraph" xml-lang="en-US">$[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> + +<section id="datebase"> +<h2 id="hd_id2408825">Date base for day zero</h2> +<paragraph id="par_id9988402" role="paragraph" xml-lang="en-US">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 id="par_id6401257" role="tablehead" xml-lang="en-US">Date base</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id5841242" role="tablehead" xml-lang="en-US">Use</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id6794030" role="tablecontent" xml-lang="en-US">'12/30/1899'</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id7096774" role="tablecontent" xml-lang="en-US">(default)</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id5699942" role="tablecontent" xml-lang="en-US">'01/01/1900'</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id6420484" role="tablecontent" xml-lang="en-US">(used in former StarCalc 1.0)</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id6986602" role="tablecontent" xml-lang="en-US">'01/01/1904'</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id616779" role="tablecontent" xml-lang="en-US">(used in Apple software)</paragraph> + </tablecell> + </tablerow> +</table> +</section> +<paragraph id="par_id791039" role="paragraph" xml-lang="en-US">Choose <switchinline select="sys"><caseinline select="MAC"><emph>%PRODUCTNAME - Preferences</emph> +</caseinline><defaultinline><emph>Tools - Options</emph></defaultinline></switchinline><emph> - %PRODUCTNAME Calc - Calculate</emph> to select the date base.</paragraph> +<warning id="par_id1953489">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!</warning> + +<h2 id="hd_id757469">Two digits years</h2> +<paragraph id="par_id3149720" role="paragraph" xml-lang="en-US">In <switchinline select="sys"><caseinline select="MAC"><emph>%PRODUCTNAME - Preferences</emph> +</caseinline><defaultinline><emph>Tools - Options</emph></defaultinline></switchinline><emph> - $[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> +<section id="datenumberinfo"> +<note id="par_id3150654">When entering dates as part of formulas, slashes or dashes used as date separators are interpreted as arithmetic operators. Therefore, dates entered in this format are not recognized as dates and result in erroneous calculations. To keep dates from being interpreted as parts of formulas use the DATE function, for example, DATE(1954;7;20), or place the date in quotation marks and use the ISO 8601 notation, for example, "1954-07-20". Avoid using locale dependent date formats such as "07/20/54", the calculation may produce errors if the document is loaded under different locale settings.</note> +</section> +<section id="datenumberwarn"> + <tip id="par_id571535118151091">Unambiguous conversion is possible for ISO 8601 dates and times in their extended formats with separators. If a <emph>#VALUE!</emph> error occurs, then unselect <emph>Generate #VALUE! error</emph> in <switchinline select="sys"><caseinline select="MAC"><emph>%PRODUCTNAME - Preferences</emph></caseinline><defaultinline><emph>Tools - Options</emph></defaultinline></switchinline> <emph>- %PRODUCTNAME Calc - Formula</emph>, button <emph>Details...</emph> in section "Detailed Calculation Settings", <emph>Conversion from text to number</emph> list box.</tip> +</section> + +<note id="par_id651547654187646">Time zone information is not used in Date and Time functions and cells.</note> + +<h2 id="par_idN1067A">Functions</h2> +<section id="datetimefunctions"> + <paragraph role="paragraph" id="par_id31577531529079" localize="false"><embedvar href="text/scalc/01/04060102.xhp#h1" markup="ignore"/></paragraph> + +<paragraph id="par_id6854457" role="paragraph" localize="false" xml-lang="en-US"> <embedvar href="text/scalc/01/func_date.xhp#date"/> </paragraph> +<paragraph id="par_id6354457" role="paragraph" localize="false" xml-lang="en-US"> <embedvar href="text/scalc/01/func_datedif.xhp#datedif"/> </paragraph> +<paragraph id="par_id3372295" role="paragraph" localize="false" xml-lang="en-US"> <embedvar href="text/scalc/01/func_datevalue.xhp#datevalue"/> </paragraph> +<paragraph id="par_id5375835" role="paragraph" localize="false" xml-lang="en-US"> <embedvar href="text/scalc/01/func_day.xhp#day"/> </paragraph> +<paragraph id="par_id1208838" role="paragraph" localize="false" xml-lang="en-US"> <embedvar href="text/scalc/01/func_days.xhp#days"/> </paragraph> +<paragraph id="par_id7679982" role="paragraph" localize="false" xml-lang="en-US"> <embedvar href="text/scalc/01/func_days360.xhp#days360"/> </paragraph> +<paragraph id="par_id1074251" role="paragraph" localize="false" xml-lang="en-US"> <embedvar href="text/scalc/01/func_eastersunday.xhp#eastersunday"/> </paragraph> +<paragraph id="par_id5684377" role="paragraph" localize="false" xml-lang="en-US"> <embedvar href="text/scalc/01/func_edate.xhp#edate"/> </paragraph> +<paragraph id="par_id1346781" role="paragraph" localize="false" xml-lang="en-US"> <embedvar href="text/scalc/01/func_eomonth.xhp#eomonth"/> </paragraph> +<paragraph id="par_id224005" role="paragraph" localize="false" xml-lang="en-US"> <embedvar href="text/scalc/01/func_hour.xhp#hour"/> </paragraph> +<paragraph id="par_id3886533" role="paragraph" localize="false" xml-lang="en-US"> <embedvar href="text/scalc/01/func_isoweeknum.xhp#isoweeknum"/> </paragraph> +<paragraph id="par_id3953062" role="paragraph" localize="false" xml-lang="en-US"> <embedvar href="text/scalc/01/func_minute.xhp#minute"/> </paragraph> +<paragraph id="par_id2579729" role="paragraph" localize="false" xml-lang="en-US"> <embedvar href="text/scalc/01/func_month.xhp#month"/> </paragraph> +<paragraph id="par_id8951384" role="paragraph" localize="false" xml-lang="en-US"> <embedvar href="text/scalc/01/func_networkdays.xhp#networkdays"/> </paragraph> +<paragraph id="par_id231020162315043955" role="paragraph" localize="false" xml-lang="en-US"> <embedvar href="text/scalc/01/func_networkdays.intl.xhp#networkdaysintl"/> </paragraph> +<paragraph id="par_id6501968" role="paragraph" localize="false" xml-lang="en-US"> <embedvar href="text/scalc/01/func_now.xhp#now"/> </paragraph> +<paragraph id="par_id372325" role="paragraph" localize="false" xml-lang="en-US"> <embedvar href="text/scalc/01/func_second.xhp#second"/> </paragraph> +<paragraph id="par_id2354503" role="paragraph" localize="false" xml-lang="en-US"> <embedvar href="text/scalc/01/func_time.xhp#time"/> </paragraph> +<paragraph id="par_id7765434" role="paragraph" localize="false" xml-lang="en-US"> <embedvar href="text/scalc/01/func_timevalue.xhp#timevalue"/> </paragraph> +<paragraph id="par_id7576525" role="paragraph" localize="false" xml-lang="en-US"> <embedvar href="text/scalc/01/func_today.xhp#today"/> </paragraph> +<paragraph id="par_id9172643" role="paragraph" localize="false" xml-lang="en-US"> <embedvar href="text/scalc/01/func_weekday.xhp#weekday"/> </paragraph> +<paragraph id="par_id3886532" role="paragraph" localize="false" xml-lang="en-US"> <embedvar href="text/scalc/01/func_weeknum.xhp#weeknum"/> </paragraph> +<paragraph id="par_id614947" role="paragraph" localize="false" xml-lang="en-US"> <embedvar href="text/scalc/01/func_weeknumadd.xhp#weeknumadd"/> </paragraph> +<paragraph id="par_id3886534" role="paragraph" localize="false" xml-lang="en-US"> <embedvar href="text/scalc/01/func_weeknum_ooo.xhp#weeknum_ooo"/> </paragraph> +<paragraph id="par_idN10683" role="paragraph" localize="false" xml-lang="en-US"> <embedvar href="text/scalc/01/func_workday.xhp#workday"/> </paragraph> +<paragraph id="par_id231020163315043955" role="paragraph" localize="false" xml-lang="en-US"> <embedvar href="text/scalc/01/func_workday.intl.xhp#workdaysintl"/> </paragraph> +<paragraph id="par_id641193" role="paragraph" localize="false" xml-lang="en-US"> <embedvar href="text/scalc/01/func_year.xhp#year"/> </paragraph> +<paragraph id="par_id5189062" role="paragraph" localize="false" xml-lang="en-US"> <embedvar href="text/scalc/01/func_yearfrac.xhp#yearfrac"/> </paragraph> +</section> + +<section id="relatedtopics"> +<embed href="text/scalc/01/04060100.xhp#drking"/> +</section> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/04060103.xhp b/helpcontent2/source/text/scalc/01/04060103.xhp new file mode 100644 index 000000000..1b14bdc26 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/04060103.xhp @@ -0,0 +1,737 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . + --> + +<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> +<h1 id="hd_id3143284">Financial Functions Part One</h1> + <paragraph xml-lang="en-US" id="par_id3149095" role="paragraph"><variable id="finanztext">This category contains the mathematical finance functions of <item type="productname">%PRODUCTNAME</item> Calc. +</variable></paragraph> +<sort order="asc" descendant="h2"> +<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"/> +<h2 id="hd_id3153366">AMORDEGRC</h2> + <paragraph xml-lang="en-US" id="par_id3147434" role="paragraph"><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> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph xml-lang="en-US" id="par_id3147427" role="code">AMORDEGRC(Cost; DatePurchased; FirstPeriod; Salvage; Period; Rate [; Basis])</paragraph> + <paragraph xml-lang="en-US" id="par_id3147125" role="paragraph"> + <emph>Cost</emph> is the acquisition costs.</paragraph> + <paragraph xml-lang="en-US" id="par_id3151074" role="paragraph"> + <emph>DatePurchased</emph> is the date of acquisition.</paragraph> + <paragraph xml-lang="en-US" id="par_id3144765" role="paragraph"> + <emph>FirstPeriod </emph>is the end date of the first settlement period.</paragraph> + <paragraph xml-lang="en-US" id="par_id3156286" role="paragraph"> + <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"> + <emph>Period</emph> is the settlement period to be considered.</paragraph> + <paragraph xml-lang="en-US" id="par_id3155064" role="paragraph"> + <emph>Rate</emph> is the rate of depreciation.</paragraph> + <embed href="text/scalc/01/func_yearfrac.xhp#basis"/> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph xml-lang="en-US" id="par_id421612299085248" role="paragraph">An asset was acquired on 2020-02-01 at a cost of 2000 currency units. The end date of the first settlement period was 2020-12-31. The salvage value of the asset at the end of its depreciable life will be 10 currency units. The rate of depreciation is 0.1 (10%) and the year is calculated using the US method (Basis 0). Assuming degressive depreciation, what is the amount of depreciation in the fourth depreciation period?</paragraph> + <paragraph xml-lang="en-US" id="par_id901612299089478" role="paragraph"> + <input>=AMORDEGRC(2000; "2020-02-01"; "2020-12-31"; 10; 4; 0.1; 0)</input> returns a depreciation amount of 163 currency units.</paragraph> + <section id="Basis2Excel"> + <note id="par_id851616615176815">Beware that Basis 2 is not supported by Microsoft Excel. Hence, if you use Basis 2 and export your document to XLSX format, it will return an error when opened in Excel.</note> + </section> + </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"/> +<h2 id="hd_id3153765">AMORLINC</h2> + <paragraph xml-lang="en-US" id="par_id3159264" role="paragraph"><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> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph xml-lang="en-US" id="par_id3147363" role="code">AMORLINC(Cost; DatePurchased; FirstPeriod; Salvage; Period; Rate [; Basis])</paragraph> + <paragraph xml-lang="en-US" id="par_id3146920" role="paragraph"> + <emph>Cost</emph> means the acquisition costs.</paragraph> + <paragraph xml-lang="en-US" id="par_id3163807" role="paragraph"> + <emph>DatePurchased</emph> is the date of acquisition.</paragraph> + <paragraph xml-lang="en-US" id="par_id3148488" role="paragraph"> + <emph>FirstPeriod </emph>is the end date of the first settlement period.</paragraph> + <paragraph xml-lang="en-US" id="par_id3149530" role="paragraph"> + <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"> + <emph>Period</emph> is the settlement period to be considered.</paragraph> + <paragraph xml-lang="en-US" id="par_id3150982" role="paragraph"> + <emph>Rate</emph> is the rate of depreciation.</paragraph> + <embed href="text/scalc/01/func_yearfrac.xhp#basis"/> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph xml-lang="en-US" id="par_id641612299092454" role="paragraph">An asset was acquired on 2020-02-01 at a cost of 2000 currency units. The end date of the first settlement period was 2020-12-31. The salvage value of the asset at the end of its depreciable life will be 10 currency units. The rate of depreciation is 0.1 (10%) and the year is calculated using the US method (Basis 0). Assuming linear depreciation, what is the amount of depreciation in the fourth depreciation period?</paragraph> + <paragraph xml-lang="en-US" id="par_id391612299096511" role="paragraph"> + <input>=AMORLINC(2000; "2020-02-01"; "2020-12-31"; 10; 4; 0.1; 0)</input> returns a depreciation amount of 200 currency units.</paragraph> + <embed href="text/scalc/01/04060103.xhp#Basis2Excel"/> + </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"/> +<h2 id="hd_id3145257">ACCRINT</h2> +<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"><ahelp hid="HID_AAI_FUNC_ACCRINT">Calculates the accrued interest of a security in the case of periodic payments.</ahelp></paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph xml-lang="en-US" id="par_id3159092" role="code">ACCRINT(Issue; FirstInterest; Settlement; Rate; [Par]; Frequency [; Basis])</paragraph> + <paragraph xml-lang="en-US" id="par_id3150519" role="paragraph"> + <emph>Issue</emph> (required) is the issue date of the security.</paragraph> + <paragraph xml-lang="en-US" id="par_id3155376" role="paragraph"> + <emph>FirstInterest</emph> (required) is the first interest date of the security.</paragraph> + <paragraph xml-lang="en-US" id="par_id3166431" role="paragraph"> + <emph>Settlement</emph> (required) 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"> + <emph>Rate</emph> (required) is the annual nominal rate of interest (coupon interest rate)</paragraph> + <paragraph xml-lang="en-US" id="par_id3156445" role="paragraph"> + <emph>Par</emph> (optional) is the par value of the security. If omitted, a default value of 1000 is used.</paragraph> + <note id="par_id961591171682507">We recommend that you always specify the value that you require for ACCRINT’s <emph>Par</emph> argument, rather than allowing Calc to apply an arbitrary default. This will make your formula easier to understand and easier to maintain.</note> + <paragraph xml-lang="en-US" id="par_id3149406" role="paragraph"> + <emph>Frequency</emph> (required) is the number of interest payments per year (1, 2 or 4).</paragraph> + <embed href="text/scalc/01/func_yearfrac.xhp#basis"/> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph xml-lang="en-US" id="par_id3148599" role="paragraph">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"> + <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"/> +<h2 id="hd_id3151240">ACCRINTM</h2> + <paragraph xml-lang="en-US" id="par_id3157981" role="paragraph"><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> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph xml-lang="en-US" id="par_id3147074" role="code">ACCRINTM(Issue; Settlement; Rate [; Par [; Basis]])</paragraph> + <paragraph xml-lang="en-US" id="par_id3144773" role="paragraph"> + <emph>Issue</emph> (required) is the issue date of the security.</paragraph> + <paragraph xml-lang="en-US" id="par_id3154956" role="paragraph"> + <emph>Settlement</emph> (required) 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"> + <emph>Rate</emph> (required) is the annual nominal rate of interest (coupon interest rate).</paragraph> + <paragraph xml-lang="en-US" id="par_id3159204" role="paragraph"> + <emph>Par</emph> (optional) is the par value of the security. If omitted, a default value of 1000 is used.</paragraph> + <note id="par_id481612296978513">We recommend that you always specify the value that you require for ACCRINTM’s <emph>Par</emph> argument, rather than allowing Calc to apply an arbitrary default. This will make your formula easier to understand and easier to maintain.</note> + <embed href="text/scalc/01/func_yearfrac.xhp#basis"/> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph xml-lang="en-US" id="par_id3154541" role="paragraph">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"> + <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"/> +<h2 id="hd_id3145753">RECEIVED</h2> + <paragraph xml-lang="en-US" id="par_id3150051" role="paragraph"><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> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph xml-lang="en-US" id="par_id3145362" role="code">RECEIVED(Settlement; Maturity; Investment; Discount [; Basis])</paragraph> + <paragraph xml-lang="en-US" id="par_id3154654" role="paragraph"> + <emph>Settlement</emph> is the date of purchase of the security.</paragraph> + <paragraph xml-lang="en-US" id="par_id3153011" role="paragraph"> + <emph>Maturity</emph> is the date on which the security matures (expires).</paragraph> + <paragraph xml-lang="en-US" id="par_id3155525" role="paragraph"> + <emph>Investment</emph> is the purchase sum.</paragraph> + <paragraph xml-lang="en-US" id="par_id3155760" role="paragraph"> + <emph>Discount</emph> is the percentage discount on acquisition of the security.</paragraph> + <embed href="text/scalc/01/func_yearfrac.xhp#basis"/> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph xml-lang="en-US" id="par_id3154735" role="paragraph">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">The amount received on the maturity date is calculated as follows:</paragraph> + <paragraph xml-lang="en-US" id="par_id3147246" role="paragraph"> + <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"/> +<h2 id="hd_id3147556">PV</h2> + <paragraph xml-lang="en-US" id="par_id3153301" role="paragraph"><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">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">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> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph xml-lang="en-US" id="par_id3150395" role="code">PV(Rate; NPer; Pmt [; FV [; Type]])</paragraph> + <paragraph xml-lang="en-US" id="par_id3151341" role="paragraph"> + <emph>Rate</emph> defines the interest rate per period.</paragraph> + <paragraph xml-lang="en-US" id="par_id3153023" role="paragraph"> + <emph>NPer</emph> is the total number of periods (payment period).</paragraph> + <paragraph xml-lang="en-US" id="par_id3146323" role="paragraph"> + <emph>Pmt</emph> is the regular payment made per period.</paragraph> + <paragraph xml-lang="en-US" id="par_id3150536" role="paragraph"> + <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"> + <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" localize="false"> + <embedvar href="text/scalc/00/00000004.xhp#optional"/> + </paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph xml-lang="en-US" id="par_id3145225" role="paragraph">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"> + <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">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"/> +<h2 id="hd_id3152978">SYD</h2> + <paragraph xml-lang="en-US" id="par_id3148732" role="paragraph"><ahelp hid="HID_FUNC_DIA">Returns the arithmetic-declining depreciation rate.</ahelp></paragraph> + <paragraph xml-lang="en-US" id="par_id3149886" role="paragraph">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> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph xml-lang="en-US" id="par_id3150483" role="code">SYD(Cost; Salvage; Life; Period)</paragraph> + <paragraph xml-lang="en-US" id="par_id3146879" role="paragraph"> + <emph>Cost</emph> is the initial cost of an asset.</paragraph> + <paragraph xml-lang="en-US" id="par_id3147423" role="paragraph"> + <emph>Salvage</emph> is the value of an asset after depreciation.</paragraph> + <paragraph xml-lang="en-US" id="par_id3151229" role="paragraph"> + <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"> + <emph>Period</emph> defines the period for which the depreciation is to be calculated.</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph xml-lang="en-US" id="par_id3149688" role="paragraph">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"> + <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">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"> + <emph>A</emph> + </paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3154558" role="tablehead"> + <emph>B</emph> + </paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3152372" role="tablehead"> + <emph>C</emph> + </paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3149949" role="tablehead"> + <emph>D</emph> + </paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3145123" role="tablehead"> + <emph>E</emph> + </paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3149504" role="tablecontent">1</paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3153778" role="tablecontent"> + <item type="input">Initial Cost</item> + </paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3159083" role="tablecontent"> + <item type="input">Salvage Value</item> + </paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3150002" role="tablecontent"> + <item type="input">Useful Life</item> + </paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3153006" role="tablecontent"> + <item type="input">Time Period</item> + </paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3154505" role="tablecontent"> + <item type="input">Deprec. SYD</item> + </paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3150336" role="tablecontent">2</paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3155926" role="tablecontent"> + <item type="input">50,000 currency units</item> + </paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3153736" role="tablecontent"> + <item type="input">10,000 currency units</item> + </paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3150131" role="tablecontent"> + <item type="input">5</item> + </paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3148766" role="tablecontent"> + <item type="input">1</item> + </paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3159136" role="tablecontent"> + <item type="input">13,333.33 currency units</item> + </paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3151018" role="tablecontent">3</paragraph> + </tablecell> + <tablecell> +</tablecell> + <tablecell> +</tablecell> + <tablecell> +</tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3148397" role="tablecontent"> + <item type="input">2</item> + </paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3146907" role="tablecontent"> + <item type="input">10,666.67 currency units</item> + </paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3147356" role="tablecontent">4</paragraph> + </tablecell> + <tablecell> +</tablecell> + <tablecell> +</tablecell> + <tablecell> +</tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3150267" role="tablecontent"> + <item type="input">3</item> + </paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3145628" role="tablecontent"> + <item type="input">8,000.00 currency units</item> + </paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3149004" role="tablecontent">5</paragraph> + </tablecell> + <tablecell> +</tablecell> + <tablecell> +</tablecell> + <tablecell> +</tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3153545" role="tablecontent"> + <item type="input">4</item> + </paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3154634" role="tablecontent"> + <item type="input">5,333.33 currency units</item> + </paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3147537" role="tablecontent">6</paragraph> + </tablecell> + <tablecell> +</tablecell> + <tablecell> +</tablecell> + <tablecell> +</tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3155085" role="tablecontent"> + <item type="input">5</item> + </paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3158413" role="tablecontent"> + <item type="input">2,666.67 currency units</item> + </paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3154866" role="tablecontent">7</paragraph> + </tablecell> + <tablecell> +</tablecell> + <tablecell> +</tablecell> + <tablecell> +</tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3155404" role="tablecontent"> + <item type="input">6</item> + </paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3148431" role="tablecontent"> + <item type="input">0.00 currency units</item> + </paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3156261" role="tablecontent">8</paragraph> + </tablecell> + <tablecell> +</tablecell> + <tablecell> +</tablecell> + <tablecell> +</tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3083286" role="tablecontent"> + <item type="input">7</item> + </paragraph> + </tablecell> + <tablecell> +</tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3083443" role="tablecontent">9</paragraph> + </tablecell> + <tablecell> +</tablecell> + <tablecell> +</tablecell> + <tablecell> +</tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3154815" role="tablecontent"> + <item type="input">8</item> + </paragraph> + </tablecell> + <tablecell> +</tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3145082" role="tablecontent">10</paragraph> + </tablecell> + <tablecell> +</tablecell> + <tablecell> +</tablecell> + <tablecell> +</tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3156307" role="tablecontent"> + <item type="input">9</item> + </paragraph> + </tablecell> + <tablecell> +</tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3147564" role="tablecontent">11</paragraph> + </tablecell> + <tablecell> +</tablecell> + <tablecell> +</tablecell> + <tablecell> +</tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3146856" role="tablecontent"> + <item type="input">10</item> + </paragraph> + </tablecell> + <tablecell> +</tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3150880" role="tablecontent">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">13</paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3156113" role="tablecontent"> + <item type="input">>0</item> + </paragraph> + </tablecell> + <tablecell> +</tablecell> + <tablecell> +</tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3153625" role="tablecontent"> + <item type="input">Total</item> + </paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3151297" role="tablecontent"> + <item type="input">40,000.00 currency units</item> + </paragraph> + </tablecell> + </tablerow> + </table> + + <paragraph xml-lang="en-US" id="par_id3149979" role="paragraph">The formula in E2 is as follows:</paragraph> + <paragraph xml-lang="en-US" id="par_id3155849" role="paragraph"> + <item type="input">=SYD($A$2;$B$2;$C$2;D2)</item> + </paragraph> + <paragraph xml-lang="en-US" id="par_id3156124" role="paragraph">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">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"> + <item type="input">=SUMIF(E2:E11;A13)</item> + </paragraph> + <paragraph xml-lang="en-US" id="par_id3155998" role="paragraph">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"/> +<h2 id="hd_id3155104">DISC</h2> + <paragraph xml-lang="en-US" id="par_id3153891" role="paragraph"><ahelp hid="HID_AAI_FUNC_DISC">Calculates the allowance (discount) of a security as a percentage.</ahelp></paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph xml-lang="en-US" id="par_id3149756" role="code">DISC(Settlement; Maturity; Price; Redemption [; Basis])</paragraph> + <paragraph xml-lang="en-US" id="par_id3156014" role="paragraph"> + <emph>Settlement</emph> is the date of purchase of the security.</paragraph> + <paragraph xml-lang="en-US" id="par_id3154304" role="paragraph"> + <emph>Maturity</emph> is the date on which the security matures (expires).</paragraph> + <paragraph xml-lang="en-US" id="par_id3159180" role="paragraph"> + <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"> + <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"/> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph xml-lang="en-US" id="par_id3155902" role="paragraph">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"> + <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"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3154695"><bookmark_value>DURATION function</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"/> +<h2 id="hd_id3154695">DURATION</h2> + <paragraph xml-lang="en-US" id="par_id3145768" role="paragraph"><ahelp hid="HID_AAI_FUNC_DURATION">Calculates the duration of a fixed interest security in years.</ahelp></paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph xml-lang="en-US" id="par_id3153373" role="code">DURATION(Settlement; Maturity; Coupon; Yield; Frequency [; Basis])</paragraph> + <paragraph xml-lang="en-US" id="par_id3155397" role="paragraph"> + <emph>Settlement</emph> is the date of purchase of the security.</paragraph> + <paragraph xml-lang="en-US" id="par_id3148558" role="paragraph"> + <emph>Maturity</emph> is the date on which the security matures (expires).</paragraph> + <paragraph xml-lang="en-US" id="par_id3153096" role="paragraph"> + <emph>Coupon</emph> is the annual coupon interest rate (nominal rate of interest)</paragraph> + <paragraph xml-lang="en-US" id="par_id3154594" role="paragraph"> + <emph>Yield</emph> is the annual yield of the security.</paragraph> + <paragraph xml-lang="en-US" id="par_id3149906" role="paragraph"> + <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"/> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph xml-lang="en-US" id="par_id3148834" role="paragraph">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"><input>=DURATION("2001-01-01";"2006-01-01";0.08;0.09;2;3)</input> returns 4.2 years.</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>EFFECT 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"/> +<h2 id="hd_id3159147">EFFECT</h2> + <paragraph xml-lang="en-US" id="par_id3154204" role="paragraph"><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">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> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph xml-lang="en-US" id="par_id3148805" role="code">EFFECT(Nom; P)</paragraph> + <paragraph xml-lang="en-US" id="par_id3149768" role="paragraph"> + <emph>Nom</emph> is the nominal interest.</paragraph> + <paragraph xml-lang="en-US" id="par_id3149334" role="paragraph"> + <emph>P</emph> is the number of interest payment periods per year.</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph xml-lang="en-US" id="par_id3144499" role="paragraph">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"> + <item type="input">=EFFECT(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"/> +<h2 id="hd_id3147241">EFFECT_ADD</h2> + <paragraph xml-lang="en-US" id="par_id3147524" role="paragraph"><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"/> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph xml-lang="en-US" id="par_id3155118" role="code">EFFECT_ADD(NominalRate; NPerY)</paragraph> + <paragraph xml-lang="en-US" id="par_id3148907" role="paragraph"> + <emph>NominalRate</emph> is the annual nominal rate of interest.</paragraph> + <paragraph xml-lang="en-US" id="par_id3154274" role="paragraph"> + <emph>NPerY </emph>is the number of interest payments per year.</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph xml-lang="en-US" id="par_id3158426" role="paragraph">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"> + <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"/> +<h2 id="hd_id3149998">DDB</h2> + <paragraph xml-lang="en-US" id="par_id3159190" role="paragraph"><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">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> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph xml-lang="en-US" id="par_id3166452" role="code">DDB(Cost; Salvage; Life; Period [; Factor])</paragraph> + <paragraph xml-lang="en-US" id="par_id3153237" role="paragraph"> + <emph>Cost</emph> fixes the initial cost of an asset.</paragraph> + <paragraph xml-lang="en-US" id="par_id3149787" role="paragraph"> + <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"> + <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"> + <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"> + <emph>Factor</emph> (optional) is the factor by which depreciation decreases. If a value is not entered, the default is factor 2.</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph xml-lang="en-US" id="par_id3152882" role="paragraph">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"> + <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"/> +<h2 id="hd_id3149962">DB</h2> + <paragraph xml-lang="en-US" id="par_id3148989" role="paragraph"><ahelp hid="HID_FUNC_GDA2">Returns the depreciation of an asset for a specified period using the fixed-declining balance method.</ahelp></paragraph> + <paragraph xml-lang="en-US" id="par_id3156213" role="paragraph">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> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph xml-lang="en-US" id="par_id3153349" role="code">DB(Cost; Salvage; Life; Period [; Month])</paragraph> + <paragraph xml-lang="en-US" id="par_id3148462" role="paragraph"> + <emph>Cost</emph> is the initial cost of an asset.</paragraph> + <paragraph xml-lang="en-US" id="par_id3148658" role="paragraph"> + <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"> + <emph>Life</emph> defines the period over which an asset is depreciated.</paragraph> + <paragraph xml-lang="en-US" id="par_id3154608" role="paragraph"> + <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"> + <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> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph xml-lang="en-US" id="par_id3156147" role="paragraph">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. The first period of depreciation comprises 6 months. What is the fixed-declining balance depreciation of the computer system in the second period, which is a full year starting from the end of the first six-month period?</paragraph> + <paragraph xml-lang="en-US" id="par_id3149513" role="paragraph"> + <input>=DB(25000; 1000; 3; 2; 6)</input> returns 11,037.95 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> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_IKV" id="bm_id3148419" localize="false"/> +<h2 id="hd_id3153948">IRR</h2> + <paragraph xml-lang="en-US" id="par_id3143282" role="paragraph"><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 id="par_idN10E621" role="paragraph" xml-lang="en-US">If the payments take place at irregular intervals, use the <link href="text/scalc/01/04060118.xhp#xirr" name="XIRR">XIRR</link> function.</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph xml-lang="en-US" id="par_id3155427" role="code">IRR(Values [; Guess])</paragraph> + <paragraph xml-lang="en-US" id="par_id3144758" role="paragraph"> + <emph>Values</emph> represents an array containing the values.</paragraph> + <paragraph xml-lang="en-US" id="par_id3149233" role="paragraph"> + <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> + <embed href="text/scalc/01/common_func.xhp#datenumbersequencenote"/> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph xml-lang="en-US" id="par_id3150630" role="paragraph">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> + <warning id="par_id461513468030965">Because of the iterative method used, it is possible for IRR to fail and return <link href="text/scalc/05/02140000.xhp" name="Error 523">Error 523</link>, with "Error: Calculation does not converge" in the status bar. In that case, try another value for Guess.</warning> + </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"/> +<h2 id="hd_id3151012">ISPMT</h2> + <paragraph xml-lang="en-US" id="par_id3148693" role="paragraph"><ahelp hid="HID_FUNC_ISPMT">Calculates the level of interest for unchanged amortization installments.</ahelp></paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph xml-lang="en-US" id="par_id3146070" role="code">ISPMT(Rate; Period; TotalPeriods; Invest)</paragraph> + <paragraph xml-lang="en-US" id="par_id3148672" role="paragraph"> + <emph>Rate</emph> sets the periodic interest rate.</paragraph> + <paragraph xml-lang="en-US" id="par_id3145777" role="paragraph"> + <emph>Period</emph> is the number of installments for calculation of interest.</paragraph> + <paragraph xml-lang="en-US" id="par_id3153678" role="paragraph"> + <emph>TotalPeriods</emph> is the total number of installment periods.</paragraph> + <paragraph xml-lang="en-US" id="par_id3159390" role="paragraph"> + <emph>Invest</emph> is the amount of the investment.</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph xml-lang="en-US" id="par_id3149558" role="paragraph">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"> + <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"><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"><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> diff --git a/helpcontent2/source/text/scalc/01/04060104.xhp b/helpcontent2/source/text/scalc/01/04060104.xhp new file mode 100644 index 000000000..d2b2f0101 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/04060104.xhp @@ -0,0 +1,742 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . +--> +<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> +<h1 id="hd_id3147247" xml-lang="en-US">Information Functions</h1> +<paragraph id="par_id3147499" role="paragraph" xml-lang="en-US"><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 id="par_id3159128" role="paragraph" xml-lang="en-US">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 id="par_id3146885" role="tablehead" xml-lang="en-US" localize="false">C</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3149944" role="tablehead" xml-lang="en-US" localize="false">D</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id3150457" role="tablehead" xml-lang="en-US" localize="false"><emph>2</emph></paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3150024" role="tablecontent" xml-lang="en-US"><item type="input">x value</item></paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3148725" role="tablecontent" xml-lang="en-US"><item type="input">y value</item></paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id3150480" role="tablehead" xml-lang="en-US" localize="false"><emph>3</emph></paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3148440" role="tablecontent" xml-lang="en-US" localize="false"><item type="input">-5</item></paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3148888" role="tablecontent" xml-lang="en-US" localize="false"><item type="input">-3</item></paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id3153034" role="tablehead" xml-lang="en-US" localize="false"><emph>4</emph></paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3150139" role="tablecontent" xml-lang="en-US" localize="false"><item type="input">-2</item></paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3149542" role="tablecontent" xml-lang="en-US" localize="false"><item type="input">0</item></paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id3149188" role="tablehead" xml-lang="en-US" localize="false"><emph>5</emph></paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3153329" role="tablecontent" xml-lang="en-US" localize="false"><item type="input">-1</item></paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3155257" role="tablecontent" xml-lang="en-US" localize="false"><item type="input">1</item></paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id3145142" role="tablehead" xml-lang="en-US" localize="false"><emph>6</emph></paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3149956" role="tablecontent" xml-lang="en-US" localize="false"><item type="input">0</item></paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3145594" role="tablecontent" xml-lang="en-US" localize="false"><item type="input">3</item></paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id3153113" role="tablehead" xml-lang="en-US" localize="false"><emph>7</emph></paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3148573" role="tablecontent" xml-lang="en-US" localize="false"><item type="input">2</item></paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3145166" role="tablecontent" xml-lang="en-US" localize="false"><item type="input">4</item></paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id3157998" role="tablehead" xml-lang="en-US" localize="false"><emph>8</emph></paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3150018" role="tablecontent" xml-lang="en-US" localize="false"><item type="input">4</item></paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3150129" role="tablecontent" xml-lang="en-US" localize="false"><item type="input">6</item></paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id3145245" role="tablehead" xml-lang="en-US" localize="false"><emph>9</emph></paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3148389" role="tablecontent" xml-lang="en-US" localize="false"><item type="input">6</item></paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3156068" role="tablecontent" xml-lang="en-US" localize="false"><item type="input">8</item></paragraph> + </tablecell> + </tablerow> +</table> +<sort order="asc" descendant="h2"> +<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"/> +<h2 id="hd_id5787224" xml-lang="en-US">INFO</h2> +<paragraph id="par_id1507309" role="paragraph" xml-lang="en-US">Returns specific information about the current working environment. The function receives a single text argument and returns data depending on that parameter.</paragraph> +<embed href="text/scalc/01/ful_func.xhp#func_volatile"/> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3928952" role="code" xml-lang="en-US">INFO("Type")</paragraph> +<paragraph id="par_id5206762" role="paragraph" xml-lang="en-US">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 id="par_id5735953" role="tablehead" xml-lang="en-US">Value for "Type"<comment>Do not translate the text values in this column below</comment></paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id8360850" role="tablehead" xml-lang="en-US">Return value</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id9648731" role="tablecontent" xml-lang="en-US" localize="false">"osversion"</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id908841" role="tablecontent" xml-lang="en-US">Always "Windows (32-bit) NT 5.01", for compatibility reasons</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id8193914" role="tablecontent" xml-lang="en-US" localize="false">"system"</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id9841608" role="tablecontent" xml-lang="en-US">The type of the operating system: <br/>"AIX" for Advanced Interactive Executive IBM computer operating systems<br/>"ANDROID" for Google mobile operating system<br/>"DRAGONFLY" for DragonFly operating system forked from FreeBSD<br/>"EMSCRIPTEN" for browser WebAssembly system<br/>"FREEBSD", "OPENBSD" or "NETBSD" for operating systems based on the Berkeley Software Distribution (BSD)<br/>"HAIKU" for BeOS compatible operating system<br/>"iOS" for Apple mobile operating system <br/>"LINUX" for GNU/Linux based operating systems<br/>"MACOSX" for Apple Mac OS X<br/>"SOLARIS" for Oracle Solaris operating system<br/>"WNT" for Microsoft Windows</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id2701803" role="tablecontent" xml-lang="en-US" localize="false">"release"</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id2136295" role="tablecontent" xml-lang="en-US">The product release identifier, for example "300m25(Build:9876)"</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id9200109" role="tablecontent" xml-lang="en-US" localize="false">"numfile"</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id4186223" role="tablecontent" xml-lang="en-US">Always 1, for compatibility reasons</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id5766472" role="tablecontent" xml-lang="en-US" localize="false">"recalc"</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id1491134" role="tablecontent" xml-lang="en-US">Current formula recalculation mode, either "Automatic" or "Manual" (localized into %PRODUCTNAME language)</paragraph> + </tablecell> + </tablerow> +</table> +<note id="par_id1161534">Other spreadsheet applications may accept localized values for the <item type="literal">Type</item> parameter, but %PRODUCTNAME Calc will only accept the English values.</note> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3994567" role="paragraph" xml-lang="en-US"><item type="input">=INFO("release")</item> returns the product release number of the %PRODUCTNAME in use.<comment>Do not translate "release"</comment></paragraph> +<paragraph id="par_id2873622" role="paragraph" xml-lang="en-US"><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"/> +<h2 id="hd_id3155625" xml-lang="en-US">CURRENT</h2> +<paragraph id="par_id3157975" role="paragraph" xml-lang="en-US"><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> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3150930" role="code" xml-lang="en-US">CURRENT()</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id5919064" role="paragraph" xml-lang="en-US"><item type="input">=1+2+CURRENT()</item></paragraph> +<paragraph id="par_id8751792" role="paragraph" xml-lang="en-US">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 id="par_id5863826" role="paragraph" xml-lang="en-US"><input>=A2+B2+STYLE(IF(CURRENT()>10;"Red";"Default"))</input></paragraph> +<paragraph id="par_id7463911" role="paragraph" xml-lang="en-US">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 id="par_id7318643" role="paragraph" xml-lang="en-US"><item type="input">="choo"&CURRENT()</item></paragraph> +<paragraph id="par_id6019165" role="paragraph" xml-lang="en-US">The example returns choochoo.</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectiontechinfo"/> +<embed href="text/scalc/01/common_func.xhp#notODFF"/> +<paragraph role="paragraph" id="par_id311640873986703" localize="false"><literal>ORG.OPENOFFICE.CURRENT</literal></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"/> +<h2 id="hd_id3150688" xml-lang="en-US">FORMULA</h2> +<paragraph id="par_id3158417" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_FORMEL">Displays the formula of a formula cell as a text string.</ahelp></paragraph> +<embed href="text/scalc/01/ful_func.xhp#func_volatile"/> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3147535" role="code" xml-lang="en-US">FORMULA(Reference)</paragraph> +<paragraph id="par_id3014313" role="paragraph" xml-lang="en-US"><emph>Reference</emph> is a reference to a cell containing a formula.</paragraph> +<paragraph id="par_id8857081" role="paragraph" xml-lang="en-US">An invalid reference or a reference to a cell with no formula results in the error value #N/A.</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3153179" role="paragraph" xml-lang="en-US">If cell A8 contains the formula <item type="input">=SUM(1;2;3)</item> then</paragraph> +<paragraph id="par_id3153923" role="paragraph" xml-lang="en-US"><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"/> +<h2 id="hd_id3155409" xml-lang="en-US">ISREF</h2> +<paragraph id="par_id3153723" role="paragraph" xml-lang="en-US"><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"/> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3149821" role="code" xml-lang="en-US">ISREF(Value)</paragraph> +<paragraph id="par_id3146152" role="paragraph" xml-lang="en-US"><emph>Value</emph> is the value to be tested, to determine whether it is a reference.</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3154317" role="paragraph" xml-lang="en-US"><item type="input">=ISREF(C5)</item> returns the result TRUE because C5 is a valid reference.</paragraph> +<paragraph id="par_id9728072" role="paragraph" xml-lang="en-US"><item type="input">=ISREF("abcdef")</item> returns always FALSE because a text can never be a reference.</paragraph> +<paragraph id="par_id2131544" role="paragraph" xml-lang="en-US"><item type="input">=ISREF(4)</item> returns FALSE.</paragraph> +<paragraph id="par_id4295480" role="paragraph" xml-lang="en-US"><item type="input">=ISREF(INDIRECT("A6"))</item> returns TRUE, because INDIRECT is a function that returns a reference.</paragraph> +<paragraph id="par_id3626819" role="paragraph" xml-lang="en-US"><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"/> +<h2 id="hd_id3154812" xml-lang="en-US">ISERR</h2> +<paragraph id="par_id3149282" role="paragraph" xml-lang="en-US"><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"/> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3156312" role="code" xml-lang="en-US">ISERR(Value)</paragraph> +<paragraph id="par_id3146857" role="paragraph" xml-lang="en-US"><emph>Value</emph> is any value or expression which is tested to see whether an error value other than #N/A is present.</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3153276" role="paragraph" xml-lang="en-US"><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 id="par_id8456984" role="paragraph" xml-lang="en-US"><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"/> +<h2 id="hd_id3147081" xml-lang="en-US">ISERROR</h2> +<paragraph id="par_id3156316" role="paragraph" xml-lang="en-US"><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"/> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3153155" role="code" xml-lang="en-US">ISERROR(Value)</paragraph> +<paragraph id="par_id3154047" role="paragraph" xml-lang="en-US"><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> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3150256" role="paragraph" xml-lang="en-US"><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 id="par_id1889095" role="paragraph" xml-lang="en-US"><item type="input">=ISERROR(C9)</item> where cell C9 contains <item type="input">=NA()</item> returns TRUE.</paragraph> +</section> +<section id="iferror"> +<bookmark xml-lang="en-US" branch="index" id="bm_id31470811"> + <bookmark_value>IFERROR function</bookmark_value> + <bookmark_value>testing;general errors</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_IFERROR" id="bm_id31452061" localize="false"/> +<h2 id="hd_id31470811" xml-lang="en-US">IFERROR</h2> +<paragraph id="par_id31563161" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_IFERROR">Returns the value if the cell does not contains an error value, or the alternative value if it does.</ahelp></paragraph> +<embed href="text/scalc/00/avail_release.xhp#4.0"/> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id31531551" role="code" xml-lang="en-US">IFERROR(Value; Alternate_value)</paragraph> +<paragraph id="par_id31540471" role="paragraph" xml-lang="en-US"><emph>Value</emph> is the value or expression to be returned if it is not equal or results in an error.</paragraph> +<paragraph id="par_id31540472" role="paragraph" xml-lang="en-US"><emph>Alternate_value</emph> is the value or expression to be returned if the expression or value of <emph>Value</emph> is equal or results in an error.</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id31502561" role="paragraph" xml-lang="en-US"><item type="input">=IFERROR(C8;C9)</item> where cell C8 contains <item type="input">=1/0</item> returns the value of C9, because 1/0 is an error.</paragraph> +<paragraph id="par_id18890951" role="paragraph" xml-lang="en-US"><item type="input">=IFERROR(C8;C9)</item> where cell C8 contains <item type="input">13</item> returns 13, the value of C8, which is not an error.</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"/> +<h2 id="hd_id3153618">ISFORMULA</h2> +<paragraph id="par_id3149138" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_ISTFORMEL">Returns TRUE if a cell is a formula cell.</ahelp></paragraph> +<embed href="text/shared/00/00000001.xhp#wahr"/> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3143230" role="code" xml-lang="en-US">ISFORMULA(Reference)</paragraph> +<paragraph id="par_id3150150" role="paragraph" xml-lang="en-US"><emph>Reference</emph> indicates the reference to a cell in which a test will be performed to determine if it contains a formula.</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3159182" role="paragraph" xml-lang="en-US"><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"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3156048"> + <bookmark_value>ISEVEN function</bookmark_value> + <bookmark_value>even integers</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_ISTGERADE" id="bm_id3149430" localize="false"/> +<h2 id="hd_id3156048">ISEVEN</h2> +<paragraph id="par_id3149170" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_ISTGERADE">Returns TRUE if the value is an even integer, or FALSE if the value is odd.</ahelp></paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3151203" role="code" xml-lang="en-US">ISEVEN(Value)</paragraph> +<paragraph id="par_id3150491" role="paragraph" xml-lang="en-US"><emph>Value</emph> is the value to be checked.</paragraph> +<paragraph id="par_id3445844" role="paragraph" xml-lang="en-US">If Value is not an integer any digits after the decimal point are ignored. The sign of Value is also ignored.</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3163813" role="paragraph" xml-lang="en-US"><item type="input">=ISEVEN(48)</item> returns TRUE</paragraph> +<paragraph id="par_id8378856" role="paragraph" xml-lang="en-US"><item type="input">=ISEVEN(33)</item> returns FALSE</paragraph> +<paragraph id="par_id7154759" role="paragraph" xml-lang="en-US"><item type="input">=ISEVEN(0)</item> returns TRUE</paragraph> +<paragraph id="par_id1912289" role="paragraph" xml-lang="en-US"><item type="input">=ISEVEN(-2.1)</item> returns TRUE</paragraph> +<paragraph id="par_id5627307" role="paragraph" xml-lang="en-US"><item type="input">=ISEVEN(3.999)</item> returns FALSE</paragraph><comment>see also ISODD</comment> +</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"/> +<h2 id="hd_id3149760">ISEVEN_ADD</h2> +<paragraph id="par_id3147253" role="paragraph" xml-lang="en-US"><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"/> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3149202" role="code" xml-lang="en-US">ISEVEN_ADD(Number)</paragraph> +<paragraph id="par_id3151168" role="paragraph" xml-lang="en-US"><emph>Number</emph> is the number to be tested.</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3153904" role="paragraph" xml-lang="en-US"><item type="input">=ISEVEN_ADD(5)</item> returns 0.</paragraph> +<paragraph id="par_id6238308" role="paragraph" xml-lang="en-US"><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"/> +<h2 id="hd_id3154692">ISNONTEXT</h2> +<paragraph id="par_id3155330" role="paragraph" xml-lang="en-US"><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 id="par_id5719779" role="paragraph" xml-lang="en-US">If an error occurs, the function returns TRUE.</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3148829" role="code" xml-lang="en-US">ISNONTEXT(Value)</paragraph> +<paragraph id="par_id3146992" role="paragraph" xml-lang="en-US"><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> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3149906" role="paragraph" xml-lang="en-US"><item type="input">=ISNONTEXT(D2)</item> returns FALSE if cell D2 contains the text <item type="input">abcdef</item>.</paragraph> +<paragraph id="par_id3150777" role="paragraph" xml-lang="en-US"><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"/> +<h2 id="hd_id3159148">ISBLANK</h2> +<paragraph id="par_id3148800" role="paragraph" xml-lang="en-US"><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"/> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3158406" role="code" xml-lang="en-US">ISBLANK(Value)</paragraph> +<paragraph id="par_id3154212" role="paragraph" xml-lang="en-US"><emph>Value</emph> is the content to be tested.</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3147234" role="paragraph" xml-lang="en-US"><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"/> +<h2 id="hd_id3155356">ISLOGICAL</h2> +<paragraph id="par_id3148926" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_ISTLOG">Tests for a logical value (TRUE or FALSE).</ahelp></paragraph> +<paragraph id="par_id3541062" role="paragraph" xml-lang="en-US">If an error occurs, the function returns FALSE.</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3148918" role="code" xml-lang="en-US">ISLOGICAL(Value)</paragraph> +<paragraph id="par_id3146946" role="paragraph" xml-lang="en-US">Returns TRUE if <emph>Value</emph> is a logical value (TRUE or FALSE), and returns FALSE otherwise.</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3166442" role="paragraph" xml-lang="en-US"><item type="input">=ISLOGICAL(99)</item> returns FALSE, because 99 is a number, not a logical value.</paragraph> +<paragraph id="par_id3556016" role="paragraph" xml-lang="en-US"><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_id3159275" localize="false"/> +<h2 id="hd_id3153685">ISNA</h2> +<paragraph id="par_id3149105" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_ISTNV">Returns TRUE if a cell contains the #N/A (value not available) error value.</ahelp></paragraph> +<paragraph id="par_id6018860" role="paragraph" xml-lang="en-US">If an error occurs, the function returns FALSE.</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3153748" role="code" xml-lang="en-US">ISNA(Value)</paragraph> +<paragraph id="par_id3152884" role="paragraph" xml-lang="en-US"><emph>Value</emph> is the value or expression to be tested.</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3154852" role="paragraph" xml-lang="en-US"><item type="input">=ISNA(D3)</item> returns FALSE as a result.</paragraph> +</section> +<section id="ifna"> +<bookmark xml-lang="en-US" branch="index" id="bm_id31536851"> + <bookmark_value>IFNA function</bookmark_value> + <bookmark_value>#N/A error;testing</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_IFNA" id="bm_id3159273" localize="false"/> +<h2 id="hd_id31536851">IFNA</h2> +<paragraph id="par_id31491051" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_IFNA">Returns the value if the cell does not contains the #N/A (value not available) error value, or the alternative value if it does.</ahelp></paragraph> +<embed href="text/scalc/00/avail_release.xhp#4.0"/> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id31537481" role="code" xml-lang="en-US">IFNA(Value; Alternate_value)</paragraph> +<paragraph id="par_id31528841" role="paragraph" xml-lang="en-US"><emph>Value</emph> is the value or expression to be returned if it is not equal or results in an #N/A error.</paragraph> +<paragraph id="par_id31528842" role="paragraph" xml-lang="en-US"><emph>Alternate_value</emph> is the value or expression to be returned if the expression or value of <emph>Value</emph> is equal or results in an #N/A error.</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id31548521" role="paragraph" xml-lang="en-US"><item type="input">=IFNA(D3;D4)</item> returns the value of D3 if D3 does not result in an #N/A error, or D4 if it does.</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"/> +<h2 id="hd_id3149426">ISTEXT</h2> +<paragraph id="par_id3145368" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_ISTTEXT">Returns TRUE if the cell contents refer to text.</ahelp></paragraph> +<paragraph id="par_id6779686" role="paragraph" xml-lang="en-US">If an error occurs, the function returns FALSE.</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3148649" role="code" xml-lang="en-US">ISTEXT(Value)</paragraph> +<paragraph id="par_id3150417" role="paragraph" xml-lang="en-US"><emph>Value</emph> is a value, number, Boolean value, or an error value to be tested.</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3144756" role="paragraph" xml-lang="en-US"><item type="input">=ISTEXT(D9)</item> returns TRUE if cell D9 contains the text <item type="input">abcdef</item>.</paragraph> +<paragraph id="par_id3148416" role="paragraph" xml-lang="en-US"><item type="input">=ISTEXT(C3)</item> returns FALSE if cell C3 contains the number <item type="input">3</item>.</paragraph> +</section> +<section id="isodd"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3156034"> + <bookmark_value>ISODD function</bookmark_value> + <bookmark_value>odd integers</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_ISTUNGERADE" id="bm_id3149298" localize="false"/> +<h2 id="hd_id3156034">ISODD</h2> +<paragraph id="par_id3155920" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_ISTUNGERADE">Returns TRUE if the value is odd, or FALSE if the number is even.</ahelp></paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3151375" role="code" xml-lang="en-US">ISODD(value)</paragraph> +<paragraph id="par_id3155139" role="paragraph" xml-lang="en-US"><emph>Value</emph> is the value to be checked.</paragraph> +<paragraph id="par_id9027680" role="paragraph" xml-lang="en-US">If Value is not an integer any digits after the decimal point are ignored. The sign of Value is also ignored.</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3155345" role="paragraph" xml-lang="en-US"><item type="input">=ISODD(33)</item> returns TRUE</paragraph> +<paragraph id="par_id9392986" role="paragraph" xml-lang="en-US"><item type="input">=ISODD(48)</item> returns FALSE</paragraph> +<paragraph id="par_id5971251" role="paragraph" xml-lang="en-US"><item type="input">=ISODD(3.999)</item> returns TRUE</paragraph> +<paragraph id="par_id4136478" role="paragraph" xml-lang="en-US"><item type="input">=ISODD(-3.1)</item> returns TRUE</paragraph><comment>see also ISEVEN</comment> +</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"/> +<h2 id="hd_id3153939">ISODD_ADD</h2> +<paragraph id="par_id3153538" role="paragraph" xml-lang="en-US"><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"/> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3149485" role="code" xml-lang="en-US">ISODD_ADD(Number)</paragraph> +<paragraph id="par_id3153315" role="paragraph" xml-lang="en-US"><emph>Number</emph> is the number to be tested.</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3154793" role="paragraph" xml-lang="en-US"><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"/> +<h2 id="hd_id3148688">ISNUMBER</h2> +<paragraph id="par_id3154618" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_ISTZAHL">Returns TRUE if the value refers to a number.</ahelp></paragraph> +<embed href="text/shared/00/00000001.xhp#wahr"/> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3150595" role="code" xml-lang="en-US">ISNUMBER(Value)</paragraph> +<paragraph id="par_id3150351" role="paragraph" xml-lang="en-US"><emph>Value</emph> is any expression to be tested to determine whether it is a number or text.</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3155614" role="paragraph" xml-lang="en-US"><item type="input">=ISNUMBER(C3)</item> returns TRUE if the cell C3 contains the number <item type="input">4</item>.</paragraph> +<paragraph id="par_id3154417" role="paragraph" xml-lang="en-US"><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"/> +<h2 id="hd_id3153694">N</h2> +<paragraph id="par_id3150405" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_N">Returns the numeric value of the given parameter. Returns 0 if parameter is text or FALSE.</ahelp></paragraph> +<paragraph id="par_id9115573" role="paragraph" xml-lang="en-US">If an error occurs the function returns the error value.</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3153883" role="code" xml-lang="en-US">N(Value)</paragraph> +<paragraph id="par_id3151101" role="paragraph" xml-lang="en-US"><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> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3154117" role="paragraph" xml-lang="en-US"><item type="input">=N(123)</item> returns 123</paragraph> +<paragraph id="par_id2337717" role="paragraph" xml-lang="en-US"><item type="input">=N(TRUE())</item> returns 1</paragraph> +<paragraph id="par_id3153781" role="paragraph" xml-lang="en-US"><item type="input">=N(FALSE())</item> returns 0</paragraph> +<paragraph id="par_id3154670" role="paragraph" xml-lang="en-US"><item type="input">=N("abc")</item> returns 0</paragraph> +<paragraph id="par_id3519089" role="paragraph" xml-lang="en-US">=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"/> +<h2 id="hd_id3156275">NA</h2> +<paragraph id="par_id3156161" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_NV">Returns the error value #N/A.</ahelp></paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3149563" role="code" xml-lang="en-US">NA()</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3154481" role="paragraph" xml-lang="en-US"><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"/> +<h2 id="hd_id3151255" xml-lang="en-US">TYPE</h2> +<paragraph id="par_id3155900" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_TYP">Returns the type of value, where 1 = number, 2 = text, 4 = Boolean value, 8 = formula, 16 = error value, 64 = array.</ahelp></paragraph> +<embed href="text/shared/00/00000001.xhp#wahr"/> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3148400" role="code" xml-lang="en-US">TYPE(Value)</paragraph> +<paragraph id="par_id3150830" role="paragraph" xml-lang="en-US"><emph>Value</emph> is a specific value for which the data type is determined.</paragraph> +<h3 id="hd_id3154363" xml-lang="en-US">Example (see example table above)</h3> +<paragraph id="par_id3153357" role="paragraph" xml-lang="en-US"><item type="input">=TYPE(C2)</item> returns 2 as a result.</paragraph> +<paragraph id="par_id3148980" role="paragraph" xml-lang="en-US"><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"/> +<h2 id="hd_id3155509" xml-lang="en-US">CELL</h2> +<paragraph id="par_id3153196" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_ZELLE">Returns information on address, formatting or contents of a cell.</ahelp></paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3147355" role="code" xml-lang="en-US">CELL("InfoType" [; Reference])</paragraph> +<paragraph id="par_id3154716" role="paragraph" xml-lang="en-US"><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 id="par_id3150636" role="tablehead" xml-lang="en-US">InfoType</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3149344" role="tablehead" xml-lang="en-US">Meaning</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id3153266" role="code" xml-lang="en-US" localize="false">COL</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3156204" role="tablecontent" xml-lang="en-US">Returns the number of the referenced column.</paragraph> + <paragraph id="par_id3150094" role="tablecontent" xml-lang="en-US"><item type="input">=CELL("COL";D2)</item> returns 4.</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id3151276" role="code" xml-lang="en-US" localize="false">ROW</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3147583" role="tablecontent" xml-lang="en-US">Returns the number of the referenced row.</paragraph> + <paragraph id="par_id3151222" role="tablecontent" xml-lang="en-US"><item type="input">=CELL("ROW";D2)</item> returns 2.</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id3159217" role="code" xml-lang="en-US" localize="false">SHEET</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3151201" role="tablecontent" xml-lang="en-US">Returns the number of the referenced sheet.</paragraph> + <paragraph id="par_id3149169" role="tablecontent" xml-lang="en-US"><item type="input">=CELL("Sheet";Sheet3.D2)</item> returns 3.</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id3149431" role="code" xml-lang="en-US" localize="false">ADDRESS</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3156054" role="tablecontent" xml-lang="en-US">Returns the absolute address of the referenced cell.</paragraph> + <paragraph id="par_id3154136" role="tablecontent" xml-lang="en-US"><item type="input">=CELL("ADDRESS";D2)</item> returns $D$2.</paragraph> + <paragraph id="par_id3159198" role="tablecontent" xml-lang="en-US"><item type="input">=CELL("ADDRESS";Sheet3.D2)</item> returns $Sheet3.$D$2.</paragraph> + <paragraph id="par_id3150245" role="tablecontent" xml-lang="en-US"><item type="input">=CELL("ADDRESS";'X:\dr\test.ods'#$Sheet1.D2)</item> returns 'file:///X:/dr/test.ods'#$Sheet1.$D$2.</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id3146811" role="code" xml-lang="en-US" localize="false">FILENAME</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3151328" role="tablecontent" xml-lang="en-US">Returns the file name and the sheet number of the referenced cell.</paragraph> + <paragraph id="par_id3148896" role="tablecontent" xml-lang="en-US"><item type="input">=CELL("FILENAME";D2)</item> returns 'file:///X:/dr/own.ods'#$Sheet1, if the formula in the current document X:\dr\own.ods is located in Sheet1.</paragraph> + <paragraph id="par_id3155144" role="tablecontent" xml-lang="en-US"><item type="input">=CELL("FILENAME";'X:\dr\test.ods'#$Sheet1.D2)</item> returns 'file:///X:/dr/test.ods'#$Sheet1.</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id3151381" role="code" xml-lang="en-US" localize="false">COORD</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3151004" role="tablecontent" xml-lang="en-US">Returns the complete cell address in Lotus™ notation.</paragraph> + <paragraph id="par_id3159104" role="tablecontent" xml-lang="en-US"><item type="input">=CELL("COORD"; D2)</item> returns $A:$D$2.</paragraph> + <paragraph id="par_id3163720" role="tablecontent" xml-lang="en-US"><item type="input">=CELL("COORD"; Sheet3.D2)</item> returns $C:$D$2.</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id3155910" role="code" xml-lang="en-US" localize="false">CONTENTS</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3156041" role="tablecontent" xml-lang="en-US">Returns the contents of the referenced cell, without any formatting.</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id3151069" role="code" xml-lang="en-US" localize="false">TYPE</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3155344" role="tablecontent" xml-lang="en-US">Returns the type of cell contents.</paragraph> + <paragraph id="par_id3145217" role="tablecontent" xml-lang="en-US">b = blank. empty cell</paragraph> + <paragraph id="par_id3155176" role="tablecontent" xml-lang="en-US">l = label. Text, result of a formula as text</paragraph> + <paragraph id="par_id3147280" role="tablecontent" xml-lang="en-US">v = value. Value, result of a formula as a number</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id3156348" role="code" xml-lang="en-US" localize="false">WIDTH</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3154920" role="tablecontent" xml-lang="en-US">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 id="par_id3152355" role="code" xml-lang="en-US" localize="false">PREFIX</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3154230" role="tablecontent" xml-lang="en-US">Returns the alignment of the referenced cell.</paragraph> + <paragraph id="par_id3155946" role="tablecontent" xml-lang="en-US">' = align left or left-justified</paragraph> + <paragraph id="par_id3147220" role="tablecontent" xml-lang="en-US">" = align right</paragraph> + <paragraph id="par_id3149038" role="tablecontent" xml-lang="en-US">^ = centered</paragraph> + <paragraph id="par_id3153129" role="tablecontent" xml-lang="en-US">\ = repeating (currently inactive)</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id3154406" role="code" xml-lang="en-US" localize="false">PROTECT</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3145127" role="tablecontent" xml-lang="en-US">Returns the status of the cell protection for the cell.</paragraph> + <paragraph id="par_id3155794" role="tablecontent" xml-lang="en-US">1 = cell is protected</paragraph> + <paragraph id="par_id3155072" role="tablecontent" xml-lang="en-US">0 = cell is not protected</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id3156178" role="code" xml-lang="en-US" localize="false">FORMAT</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3150220" role="tablecontent" xml-lang="en-US">Returns a character string that indicates the number format.</paragraph> + <paragraph id="par_id3153824" role="tablecontent" xml-lang="en-US">, = number with thousands separator</paragraph> + <paragraph id="par_id3153837" role="tablecontent" xml-lang="en-US">F = number without thousands separator</paragraph> + <paragraph id="par_id3150318" role="tablecontent" xml-lang="en-US">C = currency format</paragraph> + <paragraph id="par_id3153168" role="tablecontent" xml-lang="en-US">S = exponential representation, for example, 1.234+E56</paragraph> + <paragraph id="par_id3153515" role="tablecontent" xml-lang="en-US">P = percentage</paragraph> + <paragraph id="par_id3154375" role="tablecontent" xml-lang="en-US">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 id="par_id3150575" role="tablecontent" xml-lang="en-US">D1 = MMM-D-YY, MM-D-YY and similar formats</paragraph> + <paragraph id="par_id3150589" role="tablecontent" xml-lang="en-US">D2 = DD-MM</paragraph> + <paragraph id="par_id3151034" role="tablecontent" xml-lang="en-US">D3 = MM-YY</paragraph> + <paragraph id="par_id3156371" role="tablecontent" xml-lang="en-US">D4 = DD-MM-YYYY HH:MM:SS</paragraph> + <paragraph id="par_id3157881" role="tablecontent" xml-lang="en-US">D5 = MM-DD</paragraph> + <paragraph id="par_id3157894" role="tablecontent" xml-lang="en-US">D6 = HH:MM:SS AM/PM</paragraph> + <paragraph id="par_id3154068" role="tablecontent" xml-lang="en-US">D7 = HH:MM AM/PM</paragraph> + <paragraph id="par_id3150286" role="tablecontent" xml-lang="en-US">D8 = HH:MM:SS</paragraph> + <paragraph id="par_id3145756" role="tablecontent" xml-lang="en-US">D9 = HH:MM</paragraph> + <paragraph id="par_id3145768" role="tablecontent" xml-lang="en-US">G = All other formats</paragraph> + <paragraph id="par_id3153375" role="tablecontent" xml-lang="en-US">- (Minus) at the end = negative numbers are formatted in color</paragraph> + <paragraph id="par_id3155545" role="tablecontent" xml-lang="en-US">() (brackets) at the end = there is an opening bracket in the format code</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id3154594" role="code" xml-lang="en-US" localize="false">COLOR</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3152922" role="tablecontent" xml-lang="en-US">Returns 1, if negative values have been formatted in color, otherwise 0.</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id3145563" role="code" xml-lang="en-US" localize="false">PARENTHESES</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3156072" role="tablecontent" xml-lang="en-US">Returns 1 if the format code contains an opening bracket (, otherwise 0.</paragraph> + </tablecell> + </tablerow> +</table> +<paragraph id="par_id3156090" role="paragraph" xml-lang="en-US"><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/helpcontent2/source/text/scalc/01/04060105.xhp b/helpcontent2/source/text/scalc/01/04060105.xhp new file mode 100644 index 000000000..24f8d9729 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/04060105.xhp @@ -0,0 +1,202 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . + --> +<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> +<h1 id="hd_id3153484">Logical Functions</h1> + <paragraph xml-lang="en-US" id="par_id3149312" role="paragraph"><variable id="logicaltext">This category contains the <emph>Logical</emph> functions. +</variable></paragraph> +<h3 id="hd_id631520887352751">Handling non-logical arguments in logical functions</h3> +<list type="unordered"> + <listitem> + <paragraph id="par_id431520887384579" role="listitem" xml-lang="en-US">Zero (0) is equivalent to FALSE and all other numbers are equivalent to TRUE.</paragraph> + </listitem> + <listitem> + <paragraph id="par_id881520887475288" role="listitem" xml-lang="en-US">Empty cells and text in cells are ignored.</paragraph> + </listitem> + <listitem> + <paragraph id="par_id461520887504085" role="listitem" xml-lang="en-US">A #VALUE error is raised if all arguments are ignored.</paragraph> + </listitem> + <listitem> + <paragraph id="par_id591520888006686" role="listitem" xml-lang="en-US">A #VALUE error is raised if one argument is direct text (not text in a cell).</paragraph> + </listitem> + <listitem> + <paragraph id="par_id321520889630477" role="listitem" xml-lang="en-US">Errors as argument lead to an error.</paragraph> + </listitem> +</list> + <section id="howtoget"> + <embed href="text/scalc/00/00000404.xhp#logical"/> + </section> +<sort order="asc" descendant="h2"> + +<section id="Section10"> +<embed href="text/scalc/01/04060104.xhp#isna"/> +</section> + +<section id="Section9"> +<embed href="text/scalc/01/04060104.xhp#iferror"/> +</section> + +<section id="Section8"> +<embed href="text/scalc/01/func_ifs.xhp#ifsfunction01"/> +</section> + +<section id="Section7"> +<embed href="text/scalc/01/func_switch.xhp#switch01"/> +</section> + +<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"/> +<h2 id="hd_id3147505">AND</h2> + <paragraph xml-lang="en-US" id="par_id3153959" role="paragraph"><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">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> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph xml-lang="en-US" id="par_id3159123" role="code">AND(<embedvar href="text/scalc/01/ful_func.xhp#logical255_1" markup="keep"/>)</paragraph> + <embed href="text/scalc/01/ful_func.xhp#logical255"/> + <embed href="text/scalc/01/common_func.xhp#datenumbersequencenote"/> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph xml-lang="en-US" id="par_id3153123" role="paragraph">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"> + <item type="input">=AND(12<13;14>12;7<6)</item> returns FALSE.</paragraph> + <paragraph xml-lang="en-US" id="par_id3149946" role="paragraph"> + <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"/> +<h2 id="hd_id3149015">FALSE</h2> + <paragraph xml-lang="en-US" id="par_id3149890" role="paragraph"><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> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph xml-lang="en-US" id="par_id3150030" role="code">FALSE()</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph xml-lang="en-US" id="par_id3154842" role="paragraph"> + <item type="input">=FALSE()</item> returns FALSE</paragraph> + <paragraph xml-lang="en-US" id="par_id3147468" role="paragraph"> + <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"/> +<h2 id="hd_id3150141">IF</h2> + <paragraph xml-lang="en-US" id="par_id3148740" role="paragraph"><ahelp hid="HID_FUNC_WENN">Specifies a logical test to be performed.</ahelp></paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph xml-lang="en-US" id="par_id3154558" role="code">IF(Test [; [ThenValue] [; [OtherwiseValue]]])</paragraph> + <paragraph xml-lang="en-US" id="par_id3149727" role="paragraph"> + <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"> + <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"> + <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" localize="false"> + <embedvar href="text/scalc/00/00000004.xhp#optional"/> + </paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph xml-lang="en-US" id="par_id3150867" role="paragraph"> + <input>=IF(A1>5;100;"too small")</input> If the value in <literal>A1</literal> is greater than <literal>5</literal>, the value <literal>100</literal> is returned; otherwise, the text <literal>too small</literal> is returned.</paragraph> + <paragraph role="paragraph" id="par_id71607569817532"> + <input>=IF(A1>5;;"too small")</input> If the value in <literal>A1</literal> is greater than <literal>5</literal>, the value <literal>0</literal> is returned because empty parameters are considered to be <literal>0</literal>; otherwise, the text <literal>too small</literal> is returned.</paragraph> + <paragraph role="paragraph" id="par_id11607570458867"><input>=IF(A1>5;100;)</input> If the value in <literal>A1</literal> is less than <literal>5</literal>, the value <literal>0</literal> is returned because the empty <emph>OtherwiseValue</emph> is interpreted as <literal>0</literal>; otherwise <literal>100</literal> is returned.</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"/> +<h2 id="hd_id3155954">NOT</h2> + <paragraph xml-lang="en-US" id="par_id3153570" role="paragraph"><ahelp hid="HID_FUNC_NICHT">Complements (inverts) a logical value.</ahelp></paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph xml-lang="en-US" id="par_id3157996" role="code">NOT(LogicalValue)</paragraph> + <paragraph xml-lang="en-US" id="par_id3148766" role="paragraph"> + <emph>LogicalValue</emph> is any value to be complemented.</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph xml-lang="en-US" id="par_id3150132" role="paragraph"> + <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"/> +<h2 id="hd_id3148394">OR</h2> + <paragraph xml-lang="en-US" id="par_id3156060" role="paragraph"><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">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> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph xml-lang="en-US" id="par_id3150468" role="code">OR(<embedvar href="text/scalc/01/ful_func.xhp#logical255_1" markup="keep"/>)</paragraph> + <embed href="text/scalc/01/ful_func.xhp#logical255"/> + <embed href="text/scalc/01/common_func.xhp#datenumbersequencenote"/> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph xml-lang="en-US" id="par_id3154870" role="paragraph">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"> + <item type="input">=OR(12<11;13>22;45=45)</item> returns TRUE.</paragraph> + <paragraph xml-lang="en-US" id="par_id3158412" role="paragraph"> + <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"/> +<h2 id="hd_id3156256">TRUE</h2> + <paragraph xml-lang="en-US" id="par_id3155985" role="paragraph"><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> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph xml-lang="en-US" id="par_id3152590" role="code">TRUE()</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph xml-lang="en-US" id="par_id3146148" role="paragraph">If A=TRUE and B=FALSE the following examples appear:</paragraph> + <paragraph xml-lang="en-US" id="par_id3083285" role="paragraph"> + <item type="input">=AND(A;B)</item> returns FALSE</paragraph> + <paragraph xml-lang="en-US" id="par_id3083444" role="paragraph"> + <item type="input">=OR(A;B)</item> returns TRUE</paragraph> + <paragraph xml-lang="en-US" id="par_id3154314" role="paragraph"> + <item type="input">=NOT(AND(A;B))</item> returns TRUE</paragraph> + </section> + <section id="Section0"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3156257"><bookmark_value>XOR function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_XOR" id="bm_id3148427" localize="false"/> +<h2 id="hd_id3156257">XOR</h2> + <paragraph xml-lang="en-US" id="par_id3155987" role="paragraph"><ahelp hid="HID_FUNC_XOR">Returns true if an odd number of arguments evaluates to TRUE.</ahelp></paragraph> + <paragraph xml-lang="en-US" id="par_id3148772" role="paragraph">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> + <embed href="text/scalc/00/avail_release.xhp#4.0"/> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph xml-lang="en-US" id="par_id3150469" role="code">XOR(<embedvar href="text/scalc/01/ful_func.xhp#logical255_1" markup="keep"/>)</paragraph> + <embed href="text/scalc/01/ful_func.xhp#logical255"/> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph xml-lang="en-US" id="par_id3083286" role="paragraph"> + <item type="input">=XOR(TRUE;TRUE)</item> returns FALSE</paragraph> + <paragraph xml-lang="en-US" id="par_id3083445" role="paragraph"> + <item type="input">=XOR(TRUE;TRUE;TRUE)</item> returns TRUE</paragraph> + <paragraph xml-lang="en-US" id="par_id3154315" role="paragraph"> + <item type="input">=XOR(FALSE;TRUE)</item> returns TRUE</paragraph> + </section> +</sort> +<section id="relatedtopics"> + <embed href="text/scalc/01/04060100.xhp#drking"/> + </section> + </body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/04060106.xhp b/helpcontent2/source/text/scalc/01/04060106.xhp new file mode 100644 index 000000000..753b9f131 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/04060106.xhp @@ -0,0 +1,1554 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . +--> + +<meta> + <topic id="textscalc0104060106xml" indexer="include"> + <title id="tit" xml-lang="en-US">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> + + +<h1 id="hd_id3147124"><variable id="math_functions_h1"><link href="text/scalc/01/04060106.xhp" name="math_link">Mathematical Functions</link></variable></h1> +<paragraph id="par_id3154943" role="paragraph" xml-lang="en-US"><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 order="asc" descendant="h2"> +<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"/> + +<h2 id="hd_id3146944">ABS</h2> +<paragraph id="par_id3154546" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_ABS">Returns the absolute value of a number.</ahelp></paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3147475" role="code" xml-lang="en-US">ABS(Number)</paragraph> +<paragraph id="par_id3148438" role="paragraph" xml-lang="en-US"><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> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3152787" role="paragraph" xml-lang="en-US"><item type="input">=ABS(-56)</item> returns 56.</paragraph> +<paragraph id="par_id3148752" role="paragraph" xml-lang="en-US"><item type="input">=ABS(12)</item> returns 12.</paragraph> +<paragraph id="par_id320139" role="paragraph" xml-lang="en-US"><item type="input">=ABS(0)</item> returns 0.<comment>see also SIGN</comment></paragraph> +</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"/> + +<h2 id="hd_id3153114">ACOS</h2> +<paragraph id="par_id3145163" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_ARCCOS">Returns the inverse trigonometric cosine of a number.</ahelp></paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3150020" role="code" xml-lang="en-US">ACOS(Number)</paragraph> +<paragraph id="par_id3159134" role="paragraph" xml-lang="en-US">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 id="par_id679647" role="paragraph" xml-lang="en-US">To return the angle in degrees, use the DEGREES function.</paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3150128" role="paragraph" xml-lang="en-US"><item type="input">=ACOS(-1)</item> returns 3.14159265358979 (PI radians)</paragraph> +<paragraph id="par_id8792382" role="paragraph" xml-lang="en-US"><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> +<embed href="text/scalc/06/calcsamplefiles.xhp#trigon"/> +</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"/> + +<h2 id="hd_id3145355">ACOSH</h2> +<paragraph id="par_id3157993" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_ARCOSHYP">Returns the inverse hyperbolic cosine of a number.</ahelp></paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3151017" role="code" xml-lang="en-US">ACOSH(Number)</paragraph> +<paragraph id="par_id3149000" role="paragraph" xml-lang="en-US">This function returns the inverse hyperbolic cosine of <emph>Number</emph>, that is the number whose hyperbolic cosine is Number.</paragraph> +<paragraph id="par_id6393932" role="paragraph" xml-lang="en-US">Number must be greater than or equal to 1.</paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3145629" role="paragraph" xml-lang="en-US"><item type="input">=ACOSH(1)</item> returns 0.</paragraph> +<paragraph id="par_id951567" role="paragraph" xml-lang="en-US"><item type="input">=ACOSH(COSH(4))</item> returns 4.</paragraph><comment>see also ASINH, ATANH, ACOTH, COSH, SINH, TANH, COTH</comment> +<embed href="text/scalc/06/calcsamplefiles.xhp#trigon"/> +</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"/> + +<h2 id="hd_id3149027">ACOT</h2> +<paragraph id="par_id3155818" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_ARCCOT">Returns the inverse cotangent (the arccotangent) of the given number.</ahelp></paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3158419" role="code" xml-lang="en-US">ACOT(Number)</paragraph> +<paragraph id="par_id3154948" role="paragraph" xml-lang="en-US">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 id="par_id5834528" role="paragraph" xml-lang="en-US">To return the angle in degrees, use the DEGREES function.</paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3155375" role="paragraph" xml-lang="en-US"><item type="input">=ACOT(1)</item> returns 0.785398163397448 (PI/4 radians).</paragraph> +<paragraph id="par_id8589434" role="paragraph" xml-lang="en-US"><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> +<embed href="text/scalc/06/calcsamplefiles.xhp#trigon"/> +</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"/> + +<h2 id="hd_id3148426">ACOTH</h2> +<paragraph id="par_id3147478" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_ARCOTHYP">Returns the inverse hyperbolic cotangent of the given number.</ahelp></paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3147172" role="code" xml-lang="en-US">ACOTH(Number)</paragraph> +<paragraph id="par_id3146155" role="paragraph" xml-lang="en-US">This function returns the inverse hyperbolic cotangent of <emph>Number</emph>, that is the number whose hyperbolic cotangent is Number.</paragraph> +<paragraph id="par_id5818659" role="paragraph" xml-lang="en-US">An error results if Number is between -1 and 1 inclusive.</paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3150608" role="paragraph" xml-lang="en-US"><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> +<embed href="text/scalc/06/calcsamplefiles.xhp#trigon"/> +</section> + +<section id="aggregate"> + +<h2 id="hd_id7145084" localize="false"><embedvar href="text/scalc/01/func_aggregate.xhp#aggregate_head"/></h2> +<paragraph id="par_id323373151810412" role="paragraph" localize="false" xml-lang="en-US"><embedvar href="text/scalc/01/func_aggregate.xhp#aggregate_des"/></paragraph> +</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"/> + +<h2 id="hd_id3145084">ASIN</h2> +<paragraph id="par_id3156296" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_ARCSIN">Returns the inverse trigonometric sine of a number.</ahelp></paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3156305" role="code" xml-lang="en-US">ASIN(Number)</paragraph> +<paragraph id="par_id3150964" role="paragraph" xml-lang="en-US">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 id="par_id203863" role="paragraph" xml-lang="en-US">To return the angle in degrees, use the DEGREES function.</paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3156100" role="paragraph" xml-lang="en-US"><item type="input">=ASIN(0)</item> returns 0.</paragraph> +<paragraph id="par_id6853846" role="paragraph" xml-lang="en-US"><item type="input">=ASIN(1)</item> returns 1.5707963267949 (PI/2 radians).</paragraph> +<paragraph id="par_id8772240" role="paragraph" xml-lang="en-US"><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> +<embed href="text/scalc/06/calcsamplefiles.xhp#trigon"/> +</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"/> + +<h2 id="hd_id3151266">ASINH</h2> +<paragraph id="par_id3147077" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_ARSINHYP">Returns the inverse hyperbolic sine of a number.</ahelp></paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3150882" role="code" xml-lang="en-US">ASINH(Number)</paragraph> +<paragraph id="par_id3147621" role="paragraph" xml-lang="en-US">This function returns the inverse hyperbolic sine of <emph>Number</emph>, that is the number whose hyperbolic sine is Number.</paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3156120" role="paragraph" xml-lang="en-US"><item type="input">=ASINH(-90)</item> returns approximately -5.1929877.</paragraph> +<paragraph id="par_id4808496" role="paragraph" xml-lang="en-US"><item type="input">=ASINH(SINH(4))</item> returns 4.</paragraph><comment>see also ACOSH, ATANH, ACOTH, COSH, SINH, TANH, COTH</comment> +<embed href="text/scalc/06/calcsamplefiles.xhp#trigon"/> +</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"/> + +<h2 id="hd_id3155996">ATAN</h2> +<paragraph id="par_id3149985" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_ARCTAN">Returns the inverse trigonometric tangent of a number.</ahelp></paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3150261" role="code" xml-lang="en-US">ATAN(Number)</paragraph> +<paragraph id="par_id3147267" role="paragraph" xml-lang="en-US">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 id="par_id6293527" role="paragraph" xml-lang="en-US">To return the angle in degrees, use the DEGREES function.</paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3143229" role="paragraph" xml-lang="en-US"><item type="input">=ATAN(1)</item> returns 0.785398163397448 (PI/4 radians).</paragraph> +<paragraph id="par_id8746299" role="paragraph" xml-lang="en-US"><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> +<embed href="text/scalc/06/calcsamplefiles.xhp#trigon"/> +</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"/> + +<h2 id="hd_id3153983">ATAN2</h2> +<paragraph id="par_id3154297" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_ARCTAN2">Returns the angle (in radians) between the x-axis and a line from the origin to the point (NumberX|NumberY).</ahelp></paragraph> +<embed href="text/scalc/01/ODFF.xhp#odff"/> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3156013" role="code" xml-lang="en-US">ATAN2(NumberX; NumberY)</paragraph> +<paragraph id="par_id3001800" role="paragraph" xml-lang="en-US"><emph>NumberX</emph> is the value of the x coordinate.</paragraph> +<paragraph id="par_id3152798" role="paragraph" xml-lang="en-US"><emph>NumberY</emph> is the value of the y coordinate.</paragraph> +<tip id="par_id5036168">Programming languages have usually the opposite order of arguments for their atan2() function.</tip> +<paragraph id="par_id5036165" role="paragraph" xml-lang="en-US">ATAN2 returns the angle (in radians) between the x-axis and a line from the origin to the point (NumberX|NumberY)</paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3154692" role="paragraph" xml-lang="en-US"><item type="input">=ATAN2(-5;9)</item> returns 2.07789 radians.</paragraph> + +<paragraph id="par_id5036166" role="paragraph" xml-lang="en-US">To get the angle in degrees apply the DEGREES function to the result.</paragraph> +<paragraph id="par_id1477095" role="paragraph" xml-lang="en-US"><input>=DEGREES(ATAN2(12.3;12.3))</input> returns 45. The tangent of 45 degrees is 1.</paragraph><comment>see also COS, SIN, TAN, COT, ACOS, ASIN, ATAN, ACOT</comment> +<note id="par_id5036167">%PRODUCTNAME results 0 for ATAN2(0;0).</note> + +<paragraph id="par_id5036169" role="paragraph" xml-lang="en-US">The function can be used in converting cartesian coordinates to polar coordinates.</paragraph> +<paragraph id="par_id5036170" role="paragraph" xml-lang="en-US">=DEGREES(ATAN2(-8;5)) returns φ = 147.9 degrees</paragraph> +<paragraph role="paragraph" id="par_id5036171" xml-lang="en-US"> +<image id="img_id3150758" src="media/helpimg/scalc/coordinates-to-polar-01.svg" width="2.5inch" height="1.5inch"><alt id="alt_id3150758" xml-lang="en-US">Cartesian coordinates to polar coordinates example</alt></image> +</paragraph> +<embed href="text/scalc/06/calcsamplefiles.xhp#trigon"/> +</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"/> + +<h2 id="hd_id3155398">ATANH</h2> +<paragraph id="par_id3148829" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_ARTANHYP">Returns the inverse hyperbolic tangent of a number.</ahelp></paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3149912" role="code" xml-lang="en-US">ATANH(Number)</paragraph> +<paragraph id="par_id3150521" role="paragraph" xml-lang="en-US">This function returns the inverse hyperbolic tangent of <emph>Number</emph>, that is the number whose hyperbolic tangent is Number.</paragraph> +<paragraph id="par_id9357280" role="paragraph" xml-lang="en-US">Number must obey the condition -1 < number < 1.</paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3145419" role="paragraph" xml-lang="en-US"><item type="input">=ATANH(0)</item> returns 0.</paragraph><comment>see also ACOSH, ASINH, ACOTH, COSH, SINH, TANH, COTH</comment> +<embed href="text/scalc/06/calcsamplefiles.xhp#trigon"/> +</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"/> + +<h2 id="hd_id3153062">COS</h2> +<paragraph id="par_id3148803" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_COS">Returns the cosine of the given angle (in radians).</ahelp></paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3154213" role="code" xml-lang="en-US">COS(Number)</paragraph> +<paragraph id="par_id3154285" role="paragraph" xml-lang="en-US">Returns the (trigonometric) cosine of <emph>Number</emph>, the angle in radians.</paragraph> +<paragraph id="par_id831019" role="paragraph" xml-lang="en-US">To return the cosine of an angle in degrees, use the RADIANS function.</paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3147241" role="paragraph" xml-lang="en-US"><item type="input">=COS(PI()*2)</item> returns 1, the cosine of 2*PI radians.</paragraph> +<paragraph id="par_id3147516" role="paragraph" xml-lang="en-US"><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> +<embed href="text/scalc/06/calcsamplefiles.xhp#trigon"/> +</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"/> + +<h2 id="hd_id3154277">COSH</h2> +<paragraph id="par_id3146946" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_COSHYP">Returns the hyperbolic cosine of a number.</ahelp></paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3166440" role="code" xml-lang="en-US">COSH(Number)</paragraph> +<paragraph id="par_id3150710" role="paragraph" xml-lang="en-US">Returns the hyperbolic cosine of <emph>Number</emph>.</paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3154099" role="paragraph" xml-lang="en-US"><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> +<embed href="text/scalc/06/calcsamplefiles.xhp#trigon"/> +</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"/> + +<h2 id="hd_id3152888">COT</h2> +<paragraph id="par_id3153679" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_COT">Returns the cotangent of the given angle (in radians).</ahelp></paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3154856" role="code" xml-lang="en-US">COT(Number)</paragraph> +<paragraph id="par_id3149969" role="paragraph" xml-lang="en-US">Returns the (trigonometric) cotangent of <emph>Number</emph>, the angle in radians.</paragraph> +<paragraph id="par_id3444624" role="paragraph" xml-lang="en-US">To return the cotangent of an angle in degrees, use the RADIANS function.</paragraph> +<paragraph id="par_id6814477" role="paragraph" xml-lang="en-US">The cotangent of an angle is equivalent to 1 divided by the tangent of that angle.</paragraph> + +<h3 id="hd_id3149800">Examples:</h3> +<paragraph id="par_id3148616" role="paragraph" xml-lang="en-US"><item type="input">=COT(PI()/4)</item> returns 1, the cotangent of PI/4 radians.</paragraph> +<paragraph id="par_id3148986" role="paragraph" xml-lang="en-US"><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> +<embed href="text/scalc/06/calcsamplefiles.xhp#trigon"/> +</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"/> + +<h2 id="hd_id3154337">COTH</h2> +<paragraph id="par_id3149419" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_COTHYP">Returns the hyperbolic cotangent of a given number (angle).</ahelp></paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3143280" role="code" xml-lang="en-US">COTH(Number)</paragraph> +<paragraph id="par_id3154799" role="paragraph" xml-lang="en-US">Returns the hyperbolic cotangent of <emph>Number</emph>.</paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3144754" role="paragraph" xml-lang="en-US"><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> +<embed href="text/scalc/06/calcsamplefiles.xhp#trigon"/> +</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"/> + +<h2 id="hd_id9523234">CSC</h2> +<paragraph id="par_id4896433" role="paragraph" xml-lang="en-US"><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> +<embed href="text/scalc/00/avail_release.xhp#3.5"/> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id4571344" role="code" xml-lang="en-US">CSC(Number)</paragraph> +<paragraph id="par_id9859164" role="paragraph" xml-lang="en-US">Returns the (trigonometric) cosecant of <emph>Number</emph>, the angle in radians.</paragraph> +<paragraph id="par_id3428494" role="paragraph" xml-lang="en-US">To return the cosecant of an angle in degrees, use the RADIANS function.</paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3736803" role="paragraph" xml-lang="en-US"><item type="input">=CSC(PI()/4)</item> returns approximately 1.4142135624, the inverse of the sine of PI/4 radians.</paragraph> +<paragraph id="par_id6016818" role="paragraph" xml-lang="en-US"><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> +<embed href="text/scalc/06/calcsamplefiles.xhp#trigon"/> +</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"/> + +<h2 id="hd_id4325650">CSCH</h2> +<paragraph id="par_id579916" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_COSECANTHYP">Returns the hyperbolic cosecant of a number.</ahelp></paragraph> +<embed href="text/scalc/00/avail_release.xhp#3.5"/> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3108851" role="code" xml-lang="en-US">CSCH(Number)</paragraph> +<paragraph id="par_id1394188" role="paragraph" xml-lang="en-US">Returns the hyperbolic cosecant of <emph>Number</emph>.</paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id5426085" role="paragraph" xml-lang="en-US"><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> +<embed href="text/scalc/06/calcsamplefiles.xhp#trigon"/> +</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"/> + +<h2 id="hd_id3145314">DEGREES</h2> +<paragraph id="par_id3149939" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_DEG">Converts radians into degrees.</ahelp></paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3145600" role="code" xml-lang="en-US">DEGREES(Number)</paragraph> +<paragraph id="par_id3149484" role="paragraph" xml-lang="en-US"><emph>Number</emph> is the angle in radians to be converted to degrees.</paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3459578" role="paragraph" xml-lang="en-US"><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"/> + +<h2 id="hd_id3148698">EXP</h2> +<paragraph id="par_id3150592" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_EXP">Returns <literal>e</literal> raised to the power of a number.</ahelp> The constant <literal>e</literal> has a value of approximately 2.71828182845904.</paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3146786" role="code" xml-lang="en-US">EXP(Number)</paragraph> +<paragraph id="par_id3155608" role="paragraph" xml-lang="en-US"><emph>Number</emph> is the power to which e is to be raised.</paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3156340" role="paragraph" xml-lang="en-US"><item type="input">=EXP(1)</item> returns 2.71828182845904, the mathematical constant <literal>e</literal> 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"/> + +<h2 id="hd_id3145781">FACT</h2> +<paragraph id="par_id3151109" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_FAKULTAET">Returns the factorial of a number.</ahelp></paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3154661" role="code" xml-lang="en-US">FACT(Number)</paragraph> +<paragraph id="par_id3152952" role="paragraph" xml-lang="en-US">Returns Number!, the factorial of <emph>Number</emph>, calculated as 1*2*3*4* ... * Number.</paragraph> +<paragraph id="par_id3834650" role="paragraph" xml-lang="en-US">=FACT(0) returns 1 by definition.</paragraph> +<paragraph id="par_id8429517" role="paragraph" xml-lang="en-US">The factorial of a negative number returns the "invalid argument" error.</paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3154476" role="paragraph" xml-lang="en-US"><item type="input">=FACT(3)</item> returns 6.</paragraph> +<paragraph id="par_id3147525" role="paragraph" xml-lang="en-US"><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"/> + +<h2 id="hd_id3159084">INT</h2> +<paragraph id="par_id3158441" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_GANZZAHL">Rounds a number down to the nearest integer.</ahelp></paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3156146" role="code" xml-lang="en-US">INT(Number)</paragraph> +<paragraph id="par_id3154117" role="paragraph" xml-lang="en-US">Returns <emph>Number</emph> rounded down to the nearest integer.</paragraph> +<paragraph id="par_id153508" role="paragraph" xml-lang="en-US">Negative numbers round down to the integer below.</paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3156267" role="paragraph" xml-lang="en-US"><item type="input">=INT(5.7)</item> returns 5.</paragraph> +<paragraph id="par_id3147323" role="paragraph" xml-lang="en-US"><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"/> + +<h2 id="hd_id3150938">EVEN</h2> +<paragraph id="par_id3149988" role="paragraph" xml-lang="en-US"><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> + +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3150830" role="code" xml-lang="en-US">EVEN(Number)</paragraph> +<paragraph id="par_id3153350" role="paragraph" xml-lang="en-US">Returns <emph>Number</emph> rounded to the next even integer up, away from zero.</paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3154361" role="paragraph" xml-lang="en-US"><item type="input">=EVEN(2.3)</item> returns 4.</paragraph> +<paragraph id="par_id8477736" role="paragraph" xml-lang="en-US"><item type="input">=EVEN(2)</item> returns 2.</paragraph> +<paragraph id="par_id159611" role="paragraph" xml-lang="en-US"><item type="input">=EVEN(0)</item> returns 0.</paragraph> +<paragraph id="par_id6097598" role="paragraph" xml-lang="en-US"><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"/> + +<h2 id="hd_id3147356">GCD</h2> +<paragraph id="par_id3152465" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_GGT">Returns the greatest common divisor of two or more integers.</ahelp></paragraph> +<paragraph id="par_id2769249" role="paragraph" xml-lang="en-US">The greatest common divisor is the positive largest integer which will divide, without remainder, each of the given integers.</paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3154524" role="code" xml-lang="en-US">GCD(<embedvar href="text/scalc/01/ful_func.xhp#integer255_1" markup="keep"/>)</paragraph> +<embed href="text/scalc/01/ful_func.xhp#integer255"/> +<embed href="text/scalc/01/common_func.xhp#datenumbersequencenote"/> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3151285" role="paragraph" xml-lang="en-US"><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 id="par_id1604663" role="paragraph" xml-lang="en-US"><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_EXCEL2003 function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_GCD" id="bm_id3147578" localize="false"/> +<h2 id="hd_id3151221">GCD_EXCEL2003</h2> +<paragraph id="par_id3153257" role="paragraph" xml-lang="en-US"><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"/> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3156205" role="code" xml-lang="en-US">GCD_EXCEL2003(<embedvar href="text/scalc/01/ful_func.xhp#number255_1" markup="keep"/>)</paragraph> +<embed href="text/scalc/01/ful_func.xhp#number255"/> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3159192" role="paragraph" xml-lang="en-US"><item type="input">=GCD_EXCEL2003(5;15;25)</item> returns 5.</paragraph> +</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"/> + +<h2 id="hd_id3145213">LCM</h2> +<paragraph id="par_id3146814" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_KGV">Returns the least common multiple of one or more integers.</ahelp></paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3147279" role="code" xml-lang="en-US">LCM(<embedvar href="text/scalc/01/ful_func.xhp#integer255_1" markup="keep"/>)</paragraph> +<embed href="text/scalc/01/ful_func.xhp#integer255"/> +<embed href="text/scalc/01/common_func.xhp#datenumbersequencenote"/> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3154914" role="paragraph" xml-lang="en-US">If you enter the numbers 512; 1024 and 2000 as Integer 1;2 and 3, then 128000 will be returned.</paragraph> +</section> + +<section id="Section38"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3154230"> + <bookmark_value>LCM_EXCEL2003 function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_LCM" id="bm_id3147222" localize="false"/> +<h2 id="hd_id3154230">LCM_EXCEL2003</h2> +<paragraph id="par_id3149036" role="paragraph" xml-lang="en-US"><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"/> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3154395" role="code" xml-lang="en-US">LCM_EXCEL2003(<embedvar href="text/scalc/01/ful_func.xhp#number255_1" markup="keep"/>)</paragraph> +<embed href="text/scalc/01/ful_func.xhp#number255"/> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3145135" role="paragraph" xml-lang="en-US"><item type="input">=LCM_EXCEL2003(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"/><comment>should be statistical-->add a link there</comment> + +<h2 id="hd_id3155802">COMBIN</h2> +<paragraph id="par_id3156172" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_KOMBINATIONEN">Returns the number of combinations for elements without repetition.</ahelp></paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3150223" role="code" xml-lang="en-US">COMBIN(Count1; Count2)</paragraph> +<paragraph id="par_id3150313" role="paragraph" xml-lang="en-US"><emph>Count1</emph> is the number of items in the set.</paragraph> +<paragraph id="par_id3153830" role="paragraph" xml-lang="en-US"><emph>Count2</emph> is the number of items to choose from the set.</paragraph> +<paragraph id="par_id6807458" role="paragraph" xml-lang="en-US">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 id="par_id7414471" role="paragraph" xml-lang="en-US">COMBIN implements the formula: Count1!/(Count2!*(Count1-Count2)!)</paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3153517" role="paragraph" xml-lang="en-US"><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"/><comment>should be statistical-->add a link there</comment> + +<h2 id="hd_id3150284">COMBINA</h2> +<paragraph id="par_id3157894" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_KOMBINATIONEN2">Returns the number of combinations of a subset of items including repetitions.</ahelp></paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3145765" role="code" xml-lang="en-US">COMBINA(Count1; Count2)</paragraph> +<paragraph id="par_id3153372" role="paragraph" xml-lang="en-US"><emph>Count1</emph> is the number of items in the set.</paragraph> +<paragraph id="par_id3155544" role="paragraph" xml-lang="en-US"><emph>Count2</emph> is the number of items to choose from the set.</paragraph> +<paragraph id="par_id1997131" role="paragraph" xml-lang="en-US">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 id="par_id2052064" role="paragraph" xml-lang="en-US">COMBINA implements the formula: (Count1+Count2-1)! / (Count2!(Count1-1)!)<comment>i88052</comment></paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3152904" role="paragraph" xml-lang="en-US"><item type="input">=COMBINA(3;2)</item> returns 6.</paragraph><comment>see also COMBIN</comment> +</section> + +<section id="trunc"> + <h2 id="hd_id561641930400206"><link href="text/scalc/01/func_trunc.xhp" name="trunc_link">TRUNC</link></h2> + <embed href="text/scalc/01/func_trunc.xhp#trunc_desc"/> +</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"/> + +<h2 id="hd_id3153601">LN</h2> +<paragraph id="par_id3154974" role="paragraph" xml-lang="en-US"><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> + +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3155284" role="code" xml-lang="en-US">LN(Number)</paragraph> +<paragraph id="par_id3155297" role="paragraph" xml-lang="en-US"><emph>Number</emph> is the value whose natural logarithm is to be calculated.</paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3153866" role="paragraph" xml-lang="en-US"><item type="input">=LN(3)</item> returns the natural logarithm of 3 (approximately 1.0986).</paragraph> +<paragraph id="par_id5747245" role="paragraph" xml-lang="en-US"><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"/> + +<h2 id="hd_id3109813">LOG</h2> +<paragraph id="par_id3109841" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_LOG">Returns the logarithm of a number to the specified base.</ahelp></paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3144732" role="code" xml-lang="en-US">LOG(Number [; Base])</paragraph> +<paragraph id="par_id3144746" role="paragraph" xml-lang="en-US"><emph>Number</emph> is the value whose logarithm is to be calculated.</paragraph> +<paragraph id="par_id3152840" role="paragraph" xml-lang="en-US"><emph>Base</emph> (optional) is the base for the logarithm calculation. If omitted, Base 10 is assumed.</paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3154429" role="paragraph" xml-lang="en-US"><item type="input">=LOG(10;3)</item> returns the logarithm to base 3 of 10 (approximately 2.0959).</paragraph> +<paragraph id="par_id5577562" role="paragraph" xml-lang="en-US"><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"/> + +<h2 id="hd_id3154187">LOG10</h2> +<paragraph id="par_id3155476" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_LOG10">Returns the base-10 logarithm of a number.</ahelp></paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3159294" role="code" xml-lang="en-US">LOG10(Number)</paragraph> +<paragraph id="par_id3159308" role="paragraph" xml-lang="en-US">Returns the logarithm to base 10 of <emph>Number</emph>.</paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3157916" role="paragraph" xml-lang="en-US"><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="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"/> + +<h2 id="hd_id3157762">PI</h2> +<paragraph id="par_id3157790" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_PI">Returns 3.14159265358979, the value of the mathematical constant PI to 14 decimal places.</ahelp></paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3157822" role="code" xml-lang="en-US">PI()</paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3152370" role="paragraph" xml-lang="en-US"><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"/> +<h2 id="hd_id3152418">MULTINOMIAL</h2> +<paragraph id="par_id3152454" role="paragraph" xml-lang="en-US"><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> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3155660" role="code" xml-lang="en-US">MULTINOMIAL(<embedvar href="text/scalc/01/ful_func.xhp#number255_1" markup="keep"/>)</paragraph> +<embed href="text/scalc/01/ful_func.xhp#number255"/> +<embed href="text/scalc/01/common_func.xhp#datenumbersequencenote"/> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3155701" role="paragraph" xml-lang="en-US"><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"/> + +<h2 id="hd_id3155717">POWER</h2> +<paragraph id="par_id3159495" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_POTENZ">Returns a number raised to another number.</ahelp></paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3159526" role="code" xml-lang="en-US">POWER(Base; Exponent)</paragraph> +<paragraph id="par_id3159540" role="paragraph" xml-lang="en-US">Returns <emph>Base</emph> raised to the power of <emph>Exponent</emph>.</paragraph> +<paragraph id="par_id5081637" role="paragraph" xml-lang="en-US">The same result may be achieved by using the exponentiation operator ^:</paragraph> +<paragraph id="par_id9759514" role="code" xml-lang="en-US"><item type="literal">Base^Exponent</item></paragraph> +<note id="par_id241599040594931"><literal>=POWER(0,0)</literal> returns 1.</note> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3159594" role="paragraph" xml-lang="en-US"><item type="input">=POWER(4;3)</item> returns 64, which is 4 to the power of 3.</paragraph> +<paragraph id="par_id1614429" role="paragraph" xml-lang="en-US">=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"/> + +<h2 id="hd_id3152651">SERIESSUM</h2> +<paragraph id="par_id3152688" role="paragraph" xml-lang="en-US"><ahelp hid=".">Sums the first terms of a power series.</ahelp></paragraph> +<paragraph id="par_id3152708" role="paragraph" xml-lang="en-US">SERIESSUM(x;n;m;c) = c<sub>1</sub>x<sup>n</sup> + c<sub>2</sub>x<sup>n+m</sup> + c<sub>3</sub>x<sup>n+2m</sup> + ... + c<sub>i</sub>x<sup>n + (i-1)m</sup>.</paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_idN11BD9" role="code" xml-lang="en-US">SERIESSUM(X; N; M; Coefficients)</paragraph> +<paragraph id="par_id3152737" role="paragraph" xml-lang="en-US"><emph>X</emph> is the input value for the power series.</paragraph> +<paragraph id="par_id3144344" role="paragraph" xml-lang="en-US"><emph>N</emph> is the initial power</paragraph> +<paragraph id="par_id3144357" role="paragraph" xml-lang="en-US"><emph>M</emph> is the increment to increase N</paragraph> +<paragraph id="par_id3144370" role="paragraph" xml-lang="en-US"><emph>Coefficients</emph> is a series of coefficients. For each coefficient the series sum is extended by one section.</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph role="paragraph" id="par_id431635251540138"><input>=SERIESSUM(A1; 0; 1; {1; 2; 3})</input> calculates the value of 1+2x+3x<sup>2</sup>, where x is the value in cell A1. If A1 contains 1, the formula returns 6; if A1 contains 2, the formula returns 17; if A1 contains 3, the formula returns 34; and so on.</paragraph> +<tip id="par_id881635251427220">Refer to the <link href="https://wiki.documentfoundation.org/Documentation/Calc_Functions/SERIESSUM" name="SERIESSUM_Wiki">SERIESSUM</link> wiki page for more details about this function.</tip> +</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"/> + +<h2 id="hd_id3144386">PRODUCT</h2> +<paragraph id="par_id3144414" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_PRODUKT">Multiplies all the numbers given as arguments and returns the product.</ahelp></paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3144446" role="code" xml-lang="en-US">PRODUCT(<embedvar href="text/scalc/01/ful_func.xhp#number255_1" markup="keep"/>)</paragraph> +<embed href="text/scalc/01/ful_func.xhp#number255"/> +<embed href="text/scalc/01/common_func.xhp#datenumbersequencenote"/> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3144494" role="paragraph" xml-lang="en-US"><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"/> + +<h2 id="hd_id3160340">SUMSQ</h2> +<paragraph id="par_id3160368" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_QUADRATESUMME">Calculates the sum of the squares of a set of numbers.</ahelp></paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3160402" role="code" xml-lang="en-US">SUMSQ(<embedvar href="text/scalc/01/ful_func.xhp#number255_1" markup="keep"/>)</paragraph> +<embed href="text/scalc/01/ful_func.xhp#number255"/> +<embed href="text/scalc/01/common_func.xhp#datenumbersequencenote"/> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3160449" role="paragraph" xml-lang="en-US">If you enter the numbers 2; 3 and 4 in the Number 1; 2 and 3 arguments, 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> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_REST" id="bm_id3158259" localize="false"/> + +<h2 id="hd_id3158247">MOD</h2> +<paragraph id="par_id3158276" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_REST">Returns the remainder when one integer is divided by another.</ahelp></paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3158308" role="code" xml-lang="en-US">MOD(Dividend; Divisor)</paragraph> +<paragraph id="par_id3158321" role="paragraph" xml-lang="en-US">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 id="par_id3158341" role="paragraph" xml-lang="en-US">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> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3158374" role="paragraph" xml-lang="en-US"><item type="input">=MOD(22;3)</item> returns 1, the remainder when 22 is divided by 3.</paragraph> +<paragraph id="par_id1278420" role="paragraph" xml-lang="en-US"><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"/> + +<h2 id="hd_id3144592">QUOTIENT</h2> +<paragraph id="par_id3144627" role="paragraph" xml-lang="en-US"><ahelp hid="HID_AAI_FUNC_QUOTIENT">Returns the integer part of a division operation.</ahelp></paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3144659" role="code" xml-lang="en-US">QUOTIENT(Numerator; Denominator)</paragraph> +<paragraph id="par_id9038972" role="paragraph" xml-lang="en-US">Returns the integer part of <emph>Numerator</emph> divided by <emph>Denominator</emph>.</paragraph> +<paragraph id="par_id7985168" role="paragraph" xml-lang="en-US">QUOTIENT is equivalent to <item type="literal">INT(numerator/denominator)</item> for same-sign numerator and denominator, except that it may report errors with different error codes. More generally, it is equivalent to <item type="literal">INT(numerator/denominator/SIGN(numerator/denominator))*SIGN(numerator/denominator)</item>.</paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3144687" role="paragraph" xml-lang="en-US"><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"/> + +<h2 id="hd_id3144702">RADIANS</h2> +<paragraph id="par_id3158025" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_RAD">Converts degrees to radians.</ahelp></paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3158055" role="code" xml-lang="en-US">RADIANS(Number)</paragraph> +<paragraph id="par_id3158069" role="paragraph" xml-lang="en-US"><emph>Number</emph> is the angle in degrees to be converted to radians.</paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3939634" role="paragraph" xml-lang="en-US"><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="Section67"> +<embed href="text/scalc/01/func_rawsubtract.xhp#func_rawsubtract"/> +</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"/> + +<h2 id="hd_id3158121">ROUND</h2> +<paragraph id="par_id3158150" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_RUNDEN">Rounds a number to a certain number of decimal places.</ahelp></paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3158182" role="code" xml-lang="en-US">ROUND(Number [; Count])</paragraph> +<paragraph id="par_id3158196" role="paragraph" xml-lang="en-US">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 id="par_id599688" role="paragraph" xml-lang="en-US">This function rounds to the nearest number. See ROUNDDOWN and ROUNDUP for alternatives.</paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3145876" role="paragraph" xml-lang="en-US"><item type="input">=ROUND(2.348;2)</item> returns 2.35</paragraph> +<paragraph id="par_id3145899" role="paragraph" xml-lang="en-US"><item type="input">=ROUND(-32.4834;3)</item> returns -32.483. Change the cell format to see all decimals.</paragraph> +<paragraph id="par_id1371501" role="paragraph" xml-lang="en-US"><item type="input">=ROUND(2.348;0)</item> returns 2.</paragraph> +<paragraph id="par_id4661702" role="paragraph" xml-lang="en-US"><item type="input">=ROUND(2.5)</item> returns 3.</paragraph> +<paragraph id="par_id7868892" role="paragraph" xml-lang="en-US"><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="rounddown"> + <h2 id="hd_id561641930400105"><link href="text/scalc/01/func_rounddown.xhp" name="rounddown_link">ROUNDDOWN</link></h2> + <embed href="text/scalc/01/func_trunc.xhp#trunc_desc"/> +</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"/> + +<h2 id="hd_id3163268">ROUNDUP</h2> +<paragraph id="par_id3163297" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_AUFRUNDEN">Rounds a number up, away from zero, to a certain precision.</ahelp></paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3163328" role="code" xml-lang="en-US">ROUNDUP(Number [; Count])</paragraph> +<paragraph id="par_id3163342" role="paragraph" xml-lang="en-US">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 id="par_id9573961" role="paragraph" xml-lang="en-US">This function rounds away from zero. See ROUNDDOWN and ROUND for alternatives.</paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3144786" role="paragraph" xml-lang="en-US"><item type="input">=ROUNDUP(1.1111;2)</item> returns 1.12.</paragraph> +<paragraph id="par_id7700430" role="paragraph" xml-lang="en-US"><item type="input">=ROUNDUP(1.2345;1)</item> returns 1.3.</paragraph> +<paragraph id="par_id1180455" role="paragraph" xml-lang="en-US"><item type="input">=ROUNDUP(45.67;0)</item> returns 46.</paragraph> +<paragraph id="par_id3405560" role="paragraph" xml-lang="en-US"><item type="input">=ROUNDUP(-45.67)</item> returns -46.</paragraph> +<paragraph id="par_id3409527" role="paragraph" xml-lang="en-US"><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"/> + +<h2 id="hd_id5187204">SEC</h2> +<paragraph id="par_id9954962" role="paragraph" xml-lang="en-US"><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> +<embed href="text/scalc/00/avail_release.xhp#3.5"/> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id2055913" role="code" xml-lang="en-US">SEC(Number)</paragraph> +<paragraph id="par_id9568170" role="paragraph" xml-lang="en-US">Returns the (trigonometric) secant of <emph>Number</emph>, the angle in radians.</paragraph> +<paragraph id="par_id9047465" role="paragraph" xml-lang="en-US">To return the secant of an angle in degrees, use the RADIANS function.</paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id6935513" role="paragraph" xml-lang="en-US"><item type="input">=SEC(PI()/4)</item> returns approximately 1.4142135624, the inverse of the cosine of PI/4 radians.</paragraph> +<paragraph id="par_id3954287" role="paragraph" xml-lang="en-US"><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> +<embed href="text/scalc/06/calcsamplefiles.xhp#trigon"/> +</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"/> + +<h2 id="hd_id8661934">SECH</h2> +<paragraph id="par_id408174" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_SECANTHYP">Returns the hyperbolic secant of a number.</ahelp></paragraph> +<embed href="text/scalc/00/avail_release.xhp#3.5"/> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id4985391" role="code" xml-lang="en-US">SECH(Number)</paragraph> +<paragraph id="par_id1952124" role="paragraph" xml-lang="en-US">Returns the hyperbolic secant of <emph>Number</emph>.</paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id1187764" role="paragraph" xml-lang="en-US"><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> +<embed href="text/scalc/06/calcsamplefiles.xhp#trigon"/> +</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"/> + +<h2 id="hd_id3144877">SIN</h2> +<paragraph id="par_id3144906" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_SIN">Returns the sine of the given angle (in radians).</ahelp></paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3144937" role="code" xml-lang="en-US">SIN(Number)</paragraph> +<paragraph id="par_id3144950" role="paragraph" xml-lang="en-US">Returns the (trigonometric) sine of <emph>Number</emph>, the angle in radians.</paragraph> +<paragraph id="par_id8079470" role="paragraph" xml-lang="en-US">To return the sine of an angle in degrees, use the RADIANS function.</paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3144983" role="paragraph" xml-lang="en-US"><item type="input">=SIN(PI()/2)</item> returns 1, the sine of PI/2 radians.</paragraph> +<paragraph id="par_id3916440" role="paragraph" xml-lang="en-US"><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> +<embed href="text/scalc/06/calcsamplefiles.xhp#trigon"/> +</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"/> + +<h2 id="hd_id3163397">SINH</h2> +<paragraph id="par_id3163426" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_SINHYP">Returns the hyperbolic sine of a number.</ahelp></paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3163457" role="code" xml-lang="en-US">SINH(Number)</paragraph> +<paragraph id="par_id3163471" role="paragraph" xml-lang="en-US">Returns the hyperbolic sine of <emph>Number</emph>.</paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3163504" role="paragraph" xml-lang="en-US"><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> +<embed href="text/scalc/06/calcsamplefiles.xhp#trigon"/> +</section> + +<section id="sum"> + <h2 localize="false" id="hd_id841636542200276"><embedvar href="text/scalc/01/func_sum.xhp#sum_head"/></h2> + <paragraph id="par_id301636542246396" role="paragraph" localize="false" xml-lang="en-US"><embedvar href="text/scalc/01/func_sum.xhp#func_sum_desc"/></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"/> + +<h2 id="hd_id3151957"><variable id="sumif_head"><link href="text/scalc/01/04060106.xhp#Section15">SUMIF</link></variable></h2> +<paragraph id="par_id3151986" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_SUMMEWENN">Adds the cells specified by a given criterion.</ahelp> This function is used to sum a range when you search for a certain value.</paragraph> +<embed href="text/shared/00/00000001.xhp#regex"/> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3152028" role="code" xml-lang="en-US">SUMIF(Range; Criterion [; SumRange])</paragraph> +<paragraph id="par_id3152043" role="paragraph" xml-lang="en-US"><emph>Range</emph> is the range to which the criterion is to be applied.</paragraph> +<embed href="text/scalc/01/ex_data_stat_func.xhp#criterion"/> +<paragraph id="par_id3152083" role="paragraph" xml-lang="en-US"><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> +<note id="par_id8347422">SUMIF supports the reference concatenation operator (~) only in the Criterion parameter, and only if the optional SumRange parameter is not given.</note> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3152148" role="paragraph" xml-lang="en-US">To sum up only negative numbers: <item type="input">=SUMIF(A1:A10;"<0")</item></paragraph> +<paragraph id="par_id6670125" role="paragraph" xml-lang="en-US"><item type="input">=SUMIF(A1:A10;">0";B1:B10)</item> - sums values from the range B1:B10 only if the corresponding values in the range A1:A10 are >0.</paragraph> +<paragraph id="par_id6062196" role="paragraph" xml-lang="en-US">See COUNTIF() for some more syntax examples that can be used with SUMIF().</paragraph> +</section> + +<section id="color"> +<embed href="text/scalc/01/func_color.xhp#func_color"/> +</section> + +<section id="sumifs"> + +<h2 localize="false" id="hd_id72921259523046"><embedvar href="text/scalc/01/func_sumifs.xhp#sumifs_head"/></h2> +<paragraph id="par_id131512822630259" role="paragraph" localize="false" xml-lang="en-US"><embedvar href="text/scalc/01/func_sumifs.xhp#sumifs_des"/></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"/> + +<h2 id="hd_id3152195">TAN</h2> +<paragraph id="par_id3152224" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_TAN">Returns the tangent of the given angle (in radians).</ahelp></paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3152255" role="code" xml-lang="en-US">TAN(Number)</paragraph> +<paragraph id="par_id3152269" role="paragraph" xml-lang="en-US">Returns the (trigonometric) tangent of <emph>Number</emph>, the angle in radians.</paragraph> +<paragraph id="par_id5752128" role="paragraph" xml-lang="en-US">To return the tangent of an angle in degrees, use the RADIANS function.</paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3152301" role="paragraph" xml-lang="en-US"><item type="input">=TAN(PI()/4) </item>returns 1, the tangent of PI/4 radians.</paragraph> +<paragraph id="par_id1804864" role="paragraph" xml-lang="en-US"><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> +<embed href="text/scalc/06/calcsamplefiles.xhp#trigon"/> +</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"/> + +<h2 id="hd_id3165434">TANH</h2> +<paragraph id="par_id3165462" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_TANHYP">Returns the hyperbolic tangent of a number.</ahelp></paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3165494" role="code" xml-lang="en-US">TANH(Number)</paragraph> +<paragraph id="par_id3165508" role="paragraph" xml-lang="en-US">Returns the hyperbolic tangent of <emph>Number</emph>.</paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3165541" role="paragraph" xml-lang="en-US"><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> +<embed href="text/scalc/06/calcsamplefiles.xhp#trigon"/> +</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> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_TEILERGEBNIS" id="bm_id3165644" localize="false"/> + +<h2 id="hd_id3165633">SUBTOTAL</h2> +<paragraph id="par_id3165682" role="paragraph" xml-lang="en-US"><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> + +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3165717" role="code" xml-lang="en-US">SUBTOTAL(Function; Range)</paragraph> +<paragraph id="par_id3165731" role="paragraph" xml-lang="en-US"><emph>Function</emph> is a number that stands for one of the following functions:</paragraph> + +<table id="tbl_id3165752"> + <tablerow> + <tablecell> + <paragraph id="par_id3165782" role="tablehead" xml-lang="en-US">Function index</paragraph> + <paragraph id="par_id20082017081856189" role="tablehead" xml-lang="en-US">(includes hidden values)</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id200820170716337755" role="tablehead" xml-lang="en-US">Function index</paragraph> + <paragraph id="par_id200820170818568679" role="tablehead" xml-lang="en-US">(ignores hidden values)</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3165806" role="tablehead" xml-lang="en-US">Function</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id3165833" role="paragraph" localize="false" xml-lang="en-US">1</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id20082017071634481" role="paragraph" localize="false" xml-lang="en-US">101</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3165856" role="paragraph" xml-lang="en-US">AVERAGE</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id3165883" role="paragraph" localize="false" xml-lang="en-US">2</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id200820170716349348" role="paragraph" localize="false" xml-lang="en-US">102</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3165906" role="paragraph" xml-lang="en-US">COUNT</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id3165933" role="paragraph" localize="false" xml-lang="en-US">3</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id200820170716342109" role="paragraph" localize="false" xml-lang="en-US">103</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3165956" role="paragraph" xml-lang="en-US">COUNTA</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id3165983" role="paragraph" localize="false" xml-lang="en-US">4</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id200820170716348854" role="paragraph" localize="false" xml-lang="en-US">104</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3166006" role="paragraph" xml-lang="en-US">MAX</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id3166033" role="paragraph" localize="false" xml-lang="en-US">5</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id20082017071634799" role="paragraph" localize="false" xml-lang="en-US">105</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3166056" role="paragraph" xml-lang="en-US">MIN</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id3143316" role="paragraph" localize="false" xml-lang="en-US">6</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id200820170716342762" role="paragraph" localize="false" xml-lang="en-US">106</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3143339" role="paragraph" xml-lang="en-US">PRODUCT</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id3143366" role="paragraph" localize="false" xml-lang="en-US">7</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id200820170716348779" role="paragraph" localize="false" xml-lang="en-US">107</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3143389" role="paragraph" xml-lang="en-US">STDEV</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id3143416" role="paragraph" localize="false" xml-lang="en-US">8</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id200820170716355943" role="paragraph" localize="false" xml-lang="en-US">108</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3143439" role="paragraph" xml-lang="en-US">STDEVP</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id3143466" role="paragraph" localize="false" xml-lang="en-US">9</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id200820170716355993" role="paragraph" localize="false" xml-lang="en-US">109</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3143489" role="paragraph" xml-lang="en-US">SUM</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id3143516" role="paragraph" localize="false" xml-lang="en-US">10</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id200820170716351843" role="paragraph" localize="false" xml-lang="en-US">110</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3143539" role="paragraph" xml-lang="en-US">VAR</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id3143566" role="paragraph" localize="false" xml-lang="en-US">11</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id200820170716353789" role="paragraph" localize="false" xml-lang="en-US">111</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3143589" role="paragraph" xml-lang="en-US">VARP</paragraph> + </tablecell> + </tablerow> +</table> + +<paragraph id="par_id20082017075115609" role="paragraph" xml-lang="en-US">Use numbers 1-11 to include manually hidden rows or 101-111 to exclude them; filtered-out cells are always excluded.</paragraph> +<paragraph id="par_id3143606" role="paragraph" xml-lang="en-US"><emph>Range</emph> is the range whose cells are included.</paragraph> +<embed href="text/scalc/01/common_func.xhp#datenumbersequencenote"/> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3143638" role="paragraph" xml-lang="en-US">You have a table in the cell range A1:B6 containing a bill of material for 10 students. Row 2 (Pen) is manually hidden. 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> + +<table id="tbl_200820170737188127"> + <tablerow> + <tablecell> + <paragraph id="par_id200820170806057438" role="tablehead" localize="false" xml-lang="en-US"/> + </tablecell> + <tablecell> + <paragraph id="par_id200820170751186827" role="tablehead" localize="false" xml-lang="en-US">A</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id200820170751186410" role="tablehead" localize="false" xml-lang="en-US">B</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id200820170751189874" role="tablehead" localize="false" xml-lang="en-US">1</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id200820170751186696" role="tablecontent" xml-lang="en-US"><emph>ITEM</emph></paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id20082017075118422" role="tablecontent" xml-lang="en-US"><emph>QUANTITY</emph></paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id200820170751187332" role="tablehead" localize="false" xml-lang="en-US">2</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id200820170751195726" role="tablecontent" xml-lang="en-US">Pen</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id200820170751199921" role="tablecontent" localize="false" xml-lang="en-US">10</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id200820170751197796" role="tablehead" localize="false" xml-lang="en-US">3</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id200820170751195912" role="tablecontent" xml-lang="en-US">Pencil</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id200820170751195191" role="tablecontent" localize="false" xml-lang="en-US">10</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id200820170751193908" role="tablehead" localize="false" xml-lang="en-US">4</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id200820170751199399" role="tablecontent" xml-lang="en-US">Notebook</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id200820170751204129" role="tablecontent" localize="false" xml-lang="en-US">10</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id200820170751201815" role="tablehead" localize="false" xml-lang="en-US">5</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id200820170751201323" role="tablecontent" xml-lang="en-US">Rubber</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id20082017075120380" role="tablecontent" localize="false" xml-lang="en-US">10</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id20082017075120914" role="tablehead" localize="false" xml-lang="en-US">6</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id200820170751204884" role="tablecontent" xml-lang="en-US">Sharpener</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id200820170751204938" role="tablecontent" localize="false" xml-lang="en-US">10</paragraph> + </tablecell> + </tablerow> +</table> + +<paragraph id="par_id3143658" role="paragraph" xml-lang="en-US"><item type="input">=SUBTOTAL(9;B2:B6) returns 50.</item></paragraph> +<paragraph id="par_id200820170751218092" role="paragraph" xml-lang="en-US"><item type="input">=SUBTOTAL(109;B2:B6) returns 40.</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"/> + +<h2 id="hd_id3143672">EUROCONVERT<comment>insert link in financial</comment></h2> +<paragraph id="par_id3143708" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_UMRECHNEN">Converts between old European national currency and to and from Euros.</ahelp></paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3143748" role="code" xml-lang="en-US">EUROCONVERT(Value; "From_currency"; "To_currency" [; full_precision [; triangulation_precision]])</paragraph> +<paragraph id="par_id3143763" role="paragraph" xml-lang="en-US"><emph>Value</emph> is the amount of the currency to be converted.</paragraph> +<paragraph id="par_id3143782" role="paragraph" xml-lang="en-US"><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 id="par_id0119200904301810" role="paragraph" xml-lang="en-US"><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 id="par_id0119200904301815" role="paragraph" xml-lang="en-US"><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> + +<h3 id="par_id3143819"><emph>Examples</emph></h3> +<paragraph id="par_id3143837" role="paragraph" xml-lang="en-US"><item type="input">=EUROCONVERT(100;"ATS";"EUR")</item> converts 100 Austrian Schillings into Euros.</paragraph> +<paragraph id="par_id3143853" role="paragraph" xml-lang="en-US"><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_OOO function</bookmark_value> +</bookmark> + +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_UMRECHNEN" id="bm_id0908200902093111" localize="false"/> + +<h2 id="hd_id0908200902074836">CONVERT_OOO</h2> +<paragraph id="par_id0908200902131122" role="paragraph" xml-lang="en-US"><ahelp hid=".">Converts to euros a currency value expressed in one of the legacy currencies of 19 member states of the Eurozone, and vice versa.</ahelp> The conversion uses the fixed exchange rates at which the legacy currencies entered the euro.</paragraph> + +<tip id="par_id581631900947319">We recommend using the more flexible EUROCONVERT function for converting between these currencies. CONVERT_OOO is not a standardized function and is not portable.</tip> + +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id0908200902131191" role="code" xml-lang="en-US">CONVERT_OOO(Value; "Text1"; "Text2")</paragraph> +<paragraph role="paragraph" id="par_id901631901062056"><emph>Value</emph> is the amount of the currency to be converted.</paragraph> +<paragraph role="paragraph" id="par_id461631901137229"><emph>Text1</emph> is a three-character string that specifies the currency to be converted from.</paragraph> +<paragraph role="paragraph" id="par_id351631901218862"><emph>Text2</emph> is a three-character string that specifies the currency to be converted to.</paragraph> +<paragraph role="paragraph" id="par_id1001631901312606"><emph>Text1</emph> and <emph>Text2</emph> must each take one of the following values: "ATS", "BEF", "CYP", "DEM", "EEK", "ESP", "EUR", "FIM", "FRF", "GRD", "IEP", "ITL", "LTL", "LUF", "LVL", "MTL", "NLG", "PTE", "SIT", and "SKK".</paragraph> +<paragraph role="paragraph" id="par_id111631901383901">One, and only one, of <emph>Text1</emph> or <emph>Text2</emph> must be equal to "EUR".</paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id090820090213112" role="paragraph" xml-lang="en-US"><item type="input">=CONVERT_OOO(100;"ATS";"EUR")</item> returns the euro value of 100 Austrian schillings.</paragraph> +<paragraph id="par_id0908200902475431" role="paragraph" xml-lang="en-US"><input>=CONVERT_OOO(100;"EUR";"DEM")</input> converts 100 euros into German marks.</paragraph> +<tip id="par_id251631901851101">Refer to the <link href="https://wiki.documentfoundation.org/Documentation/Calc_Functions/CONVERT_OOO" name="CONVERT_OOO Wiki">CONVERT_OOO</link> wiki page for more details about this function.</tip> +</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"/> + +<h2 id="hd_id3157177">ODD</h2> +<paragraph id="par_id3157205" role="paragraph" xml-lang="en-US"><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> + +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3157237" role="code" xml-lang="en-US">ODD(Number)</paragraph> +<paragraph id="par_id3157250" role="paragraph" xml-lang="en-US">Returns <emph>Number</emph> rounded to the next odd integer up, away from zero.</paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3157283" role="paragraph" xml-lang="en-US"><item type="input">=ODD(1.2)</item> returns 3.</paragraph> +<paragraph id="par_id8746910" role="paragraph" xml-lang="en-US"><item type="input">=ODD(1)</item> returns 1.</paragraph> +<paragraph id="par_id9636524" role="paragraph" xml-lang="en-US"><item type="input">=ODD(0)</item> returns 1.</paragraph> +<paragraph id="par_id5675527" role="paragraph" xml-lang="en-US"><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="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"/> + +<h2 id="hd_id3164086">SIGN</h2> +<paragraph id="par_id3164115" role="paragraph" xml-lang="en-US"><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> + +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3164150" role="code" xml-lang="en-US">SIGN(Number)</paragraph> +<paragraph id="par_id3164164" role="paragraph" xml-lang="en-US"><emph>Number</emph> is the number whose sign is to be determined.</paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3164197" role="paragraph" xml-lang="en-US"><item type="input">=SIGN(3.4)</item> returns 1.</paragraph> +<paragraph id="par_id3164212" role="paragraph" xml-lang="en-US"><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"/> + +<h2 id="hd_id3164252">MROUND</h2> +<paragraph id="par_id3164288" role="paragraph" xml-lang="en-US"><ahelp hid="HID_AAI_FUNC_MROUND">Returns a number rounded to the nearest multiple of another number.</ahelp></paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3164320" role="code" xml-lang="en-US">MROUND(Number; Multiple)</paragraph> +<paragraph id="par_id3486434" role="paragraph" xml-lang="en-US">Returns <emph>Number</emph> rounded to the nearest multiple of <emph>Multiple</emph>.</paragraph> +<paragraph id="par_id3068636" role="paragraph" xml-lang="en-US">An alternative implementation would be <item type="literal">Multiple * ROUND(Number/Multiple)</item>.</paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3164347" role="paragraph" xml-lang="en-US"><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 id="par_idN14DD6" role="paragraph" xml-lang="en-US"><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"/> + +<h2 id="hd_id3164375">SQRT</h2> +<paragraph id="par_id3164404" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_WURZEL">Returns the positive square root of a number.</ahelp></paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3164437" role="code" xml-lang="en-US">SQRT(Number)</paragraph> +<paragraph id="par_id3164451" role="paragraph" xml-lang="en-US">Returns the positive square root of <emph>Number</emph>.</paragraph> +<paragraph id="par_id6870021" role="paragraph" xml-lang="en-US">Number must be positive.</paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3164484" role="paragraph" xml-lang="en-US"><item type="input">=SQRT(16)</item> returns 4.</paragraph> +<paragraph id="par_id3591723" role="paragraph" xml-lang="en-US"><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"/> + +<h2 id="hd_id3164560">SQRTPI</h2> +<paragraph id="par_id3164596" role="paragraph" xml-lang="en-US"><ahelp hid="HID_AAI_FUNC_SQRTPI">Returns the square root of (PI times a number).</ahelp></paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3164627" role="code" xml-lang="en-US">SQRTPI(Number)</paragraph> +<paragraph id="par_id1501510" role="paragraph" xml-lang="en-US">Returns the positive square root of (PI multiplied by <emph>Number</emph>).</paragraph> +<paragraph id="par_id9929197" role="paragraph" xml-lang="en-US">This is equivalent to <item type="literal">SQRT(PI()*Number)</item>.</paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3164654" role="paragraph" xml-lang="en-US"><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"/> + +<h2 id="hd_id3164669">RANDBETWEEN</h2> +<paragraph id="par_id3164711" role="paragraph" xml-lang="en-US"><ahelp hid="HID_AAI_FUNC_RANDBETWEEN">Returns an integer random number in a specified range.</ahelp></paragraph> +<embed href="text/scalc/01/ful_func.xhp#func_volatile"/> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3164758" role="code" xml-lang="en-US">RANDBETWEEN(Bottom; Top)</paragraph> +<paragraph id="par_id7112338" role="paragraph" xml-lang="en-US">Returns an integer random number between integers <emph>Bottom</emph> and <emph>Top</emph> (both inclusive).</paragraph> +<paragraph id="par_id2855616" role="paragraph" xml-lang="en-US">This function produces a new random number each time Calc recalculates. To force Calc to recalculate manually press F9.</paragraph> +<paragraph id="par_id2091433" role="paragraph" xml-lang="en-US">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> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3164785" role="paragraph" xml-lang="en-US"><item type="input">=RANDBETWEEN(20;30)</item> returns an integer of between 20 and 30.</paragraph><comment>see also RAND</comment> +</section> +<section id="randbetween_nv"> +<bookmark xml-lang="en-US" branch="index" id="bm_id461590241346526"> +<bookmark_value>random numbers non-volatile; between limits</bookmark_value> +<bookmark_value>RANDBETWEEN.NV function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_RANDBETWEEN_NV" id="bm_id601590240409484" localize="false"/> +<h2 id="hd_id171590240366277">RANDBETWEEN.NV</h2> +<paragraph role="paragraph" id="par_id391590240473510"><ahelp hid="HID_FUNC_RANDBETWEEN_NV">Returns an non-volatile integer random number in a specified range.</ahelp></paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph role="code" id="par_id181590240522012">RANDBETWEEN.NV(Bottom; Top)</paragraph> +<paragraph role="paragraph" id="par_id91590242400917">Returns an non-volatile integer random number between integers <emph>Bottom</emph> and <emph>Top</emph> (both inclusive). A non-volatile function is not recalculated at new input events or pressing <keycode>F9</keycode>. However, the function is recalculated when pressing <keycode>F9</keycode> with the cursor on the cell containing the function, when opening the file, when using the <link href="text/scalc/01/recalculate_hard.xhp" name="recalculate hard"><menuitem>Recalculate Hard</menuitem></link> command (<keycode>Shift</keycode>+<switchinline select="sys"><caseinline select="MAC"><keycode>Command</keycode></caseinline><defaultinline><keycode>Ctrl</keycode></defaultinline></switchinline>+<keycode>F9</keycode>) and when <emph>Top</emph> or <emph>Bottom</emph> are recalculated.</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph role="paragraph" id="par_id151590240999839"><input>=RANDBETWEEN.NV(20;30)</input> returns a non-volatile integer between 20 and 30.</paragraph> +<paragraph role="paragraph" id="par_id1001590241005601"><input>=RANDBETWEEN.NV(A1;30)</input> returns a non-volatile integer between the value of cell A1 and 30. The function is recalculated when the contents of cell A1 change.</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectiontechinfo"/> +<embed href="text/scalc/00/avail_release.xhp#7.0"/> +<embed href="text/scalc/01/common_func.xhp#notODFF"/> +<paragraph role="paragraph" id="par_id311650873986703" localize="false"><literal>ORG.LIBREOFFICE.RANDBETWEEN.NV</literal></paragraph> +</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"/> + +<h2 id="hd_id3164800">RAND</h2> +<paragraph id="par_id3164829" role="paragraph" xml-lang="en-US"><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> +<embed href="text/scalc/01/ful_func.xhp#func_volatile"/> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3164884" role="code" xml-lang="en-US">RAND()</paragraph> +<paragraph id="par_id5092318" role="paragraph" xml-lang="en-US">This function produces a new random number each time Calc recalculates. To force Calc to recalculate manually press F9.</paragraph> +<paragraph id="par_id9312417" role="paragraph" xml-lang="en-US">To generate random numbers which never recalculate, either:</paragraph> +<list type="unordered"> +<listitem> + <paragraph id="par_id451590242105253" role="listitem">Copy cells each containing =RAND(), and use <menuitem>Edit - Paste Special</menuitem> (with <emph>Paste All</emph> and <emph>Formulas</emph> not marked and <emph>Numbers</emph> marked).</paragraph> +</listitem> +<listitem> + <paragraph id="par_id801590242114296" role="listitem">Use the Fill Cell command with random numbers (<menuitem>Sheet - Fill Cells - Fill Random Numbers</menuitem>).</paragraph> +</listitem> +<listitem> + <paragraph id="par_id41590242118383" role="listitem">Use the RAND.NV() function for non-volatile random numbers.</paragraph> + </listitem> +</list> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id9569078" role="paragraph" xml-lang="en-US"><item type="input">=RAND()</item> returns a random number between 0 and 1.</paragraph><comment>see also RANDBETWEEN</comment> +</section> +<section id="rand_nv"> +<bookmark xml-lang="en-US" branch="index" id="bm_id341590241488944"> +<bookmark_value>random numbers non-volatile;between 0 and 1</bookmark_value> +<bookmark_value>RAND.NV function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_RAND_NV" id="bm_id111590240232198" localize="false"/> +<h2 id="hd_id71590238179170">RAND.NV</h2> +<paragraph role="paragraph" id="par_id101590238875834"><ahelp hid="HID_FUNC_RAND_NV">Returns a non-volatile random number between 0 and 1.</ahelp></paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph role="code" id="par_id391590238945182">RAND.NV()</paragraph> +<paragraph role="paragraph" id="par_id271590239748534">This function produces a non-volatile random number on input. A non-volatile function is not recalculated at new input events. The function does not recalculate when pressing <keycode>F9</keycode>, except when the cursor is on the cell containing the function or using the <link href="text/scalc/01/recalculate_hard.xhp" name="recalculate hard"><menuitem>Recalculate Hard</menuitem></link> command (<keycode>Shift</keycode>+<switchinline select="sys"><caseinline select="MAC"><keycode>Command</keycode></caseinline><defaultinline><keycode>Ctrl</keycode></defaultinline></switchinline>+<keycode>F9</keycode>). The function is recalculated when opening the file.</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph role="paragraph" id="par_id191590241215013"><input>=RAND.NV()</input> returns a non-volatile random number between 0 and 1.</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectiontechinfo"/> +<embed href="text/scalc/00/avail_release.xhp#7.0"/> +<embed href="text/scalc/01/common_func.xhp#notODFF"/> +<paragraph role="paragraph" id="par_id311640873986703" localize="false"><literal>ORG.LIBREOFFICE.RAND.NV</literal></paragraph> +</section> +</sort> + +<section id="relatedtopics"> +<embed href="text/scalc/01/04060100.xhp#drking"/> +</section> +</body> + +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/04060107.xhp b/helpcontent2/source/text/scalc/01/04060107.xhp new file mode 100644 index 000000000..86514c411 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/04060107.xhp @@ -0,0 +1,1162 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . +--> + +<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>deleting; 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> +<h1 id="hd_id3147273"><variable id="arrayfunctit"><link href="text/scalc/01/04060107.xhp" name="array functions">Array Functions</link></variable></h1> + <paragraph id="par_id3154744" role="paragraph" xml-lang="en-US"><variable id="matrixtext">This category contains the array functions.</variable></paragraph> +<h2 id="hd_id3146084">What is an Array?</h2> + <paragraph id="par_id3154298" role="paragraph" xml-lang="en-US"><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 id="par_id3154692" role="tablehead" localize="false">A</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3150117" role="tablehead" localize="false">B</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3155325" role="tablehead" localize="false">C</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id3153104" role="tablehead" localize="false">1</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3146996" role="paragraph" localize="false"><item type="input">7</item></paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3150529" role="paragraph" localize="false"><item type="input">31</item></paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3148831" role="paragraph" localize="false"><item type="input">33</item></paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id3148943" role="tablehead" localize="false">2</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3149771" role="paragraph" localize="false"><item type="input">95</item></paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3158407" role="paragraph" localize="false"><item type="input">17</item></paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3148806" role="paragraph" localize="false"><item type="input">2</item></paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id3154904" role="tablehead" localize="false">3</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3150779" role="paragraph" localize="false"><item type="input">5</item></paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3148449" role="paragraph" localize="false"><item type="input">10</item></paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3147238" role="paragraph" localize="false"><item type="input">50</item></paragraph> + </tablecell> + </tablerow> +</table> + <paragraph id="par_id3153583" role="paragraph" xml-lang="en-US">The smallest possible array is a 1 x 2 or 2 x 1 array with two adjacent cells.</paragraph> +<h2 id="hd_id3148474">What is an array formula?</h2> + <paragraph id="par_id3155355" role="paragraph" xml-lang="en-US">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 id="par_id3151052" role="paragraph" xml-lang="en-US">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 id="par_id3158432" role="paragraph" xml-lang="en-US">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"><emph>Command</emph></caseinline><defaultinline><emph>Ctrl</emph></defaultinline></switchinline><emph> + Shift + Enter</emph>. 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 id="par_id3149156" role="paragraph" xml-lang="en-US">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 id="par_id3166456" role="paragraph" xml-lang="en-US">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> +<h3 id="hd_id3150713">When do you use array formulas?</h3> + <paragraph id="par_id3149787" role="paragraph" xml-lang="en-US">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 id="par_id3149798" role="paragraph" xml-lang="en-US">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> +<h2 id="hd_id3155588">Using Array Formulas in $[officename] Calc</h2> + <paragraph id="par_id3152876" role="paragraph" xml-lang="en-US">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> +<h3 id="hd_id3151271">Creating Array Formulas</h3> +<section id="creating_array_formulas"> + <paragraph id="par_id3149102" role="paragraph" xml-lang="en-US">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 id="par_id3153392" role="paragraph" xml-lang="en-US">If you enter the array formula directly into the cell, you must use the key combination <emph>Shift + </emph><switchinline select="sys"><caseinline select="MAC"><emph>Command</emph></caseinline><defaultinline><emph>Ctrl</emph></defaultinline></switchinline><emph> + Enter</emph> instead of the <emph>Enter</emph> key. Only then does the formula become an array formula.</paragraph> + <note id="par_id3151120">Array formulas appear in braces in $[officename] Calc. You cannot create array formulas by manually entering the braces.</note> +</section> + <warning id="par_id3154342">The cells in a results array are automatically protected against changes. However, you can edit, delete or copy the array formula by selecting the entire array cell range.</warning> +<h3 id="hd_id8834803">Using Inline Array Constants in Formulas</h3> + <paragraph id="par_id985747" role="paragraph" xml-lang="en-US">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 id="par_id936613" role="paragraph" xml-lang="en-US">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> + <tip id="par_id936615">You can view and change the row and column separator in <switchinline select="sys"><caseinline select="MAC"><emph>%PRODUCTNAME - Preferences</emph></caseinline><defaultinline><emph>Tools - Options</emph></defaultinline></switchinline><emph> - Calc - Formula - Separators</emph>.</tip> + <paragraph id="par_id1877498" role="paragraph" xml-lang="en-US">Arrays can not be nested.</paragraph> + <paragraph id="par_id4262520" role="paragraph" xml-lang="en-US"><emph>Examples:</emph></paragraph> + <paragraph id="par_id9387493" role="code" xml-lang="en-US">={1;2;3}</paragraph> + <paragraph id="par_id8207037" role="paragraph" xml-lang="en-US">An array with one row consisting of the three numbers 1, 2, and 3.</paragraph> + <paragraph id="par_id6757103" role="paragraph" xml-lang="en-US">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"><emph>Command</emph></caseinline><defaultinline><emph>Ctrl</emph></defaultinline></switchinline><emph> + Shift + Enter</emph>.</paragraph> + <paragraph id="par_id8868068" role="code" xml-lang="en-US">={1;2;3|4;5;6}</paragraph> + <paragraph id="par_id6626483" role="paragraph" xml-lang="en-US">An array with two rows and three values in each row.</paragraph> + <paragraph id="par_id5262916" role="code" xml-lang="en-US">={0;1;2|FALSE;TRUE;"two"}</paragraph> + <paragraph id="par_id1623889" role="paragraph" xml-lang="en-US">A mixed data array.</paragraph> + <paragraph id="par_id7781914" role="code" xml-lang="en-US">=SIN({1;2;3})</paragraph> + <paragraph id="par_id300912" role="paragraph" xml-lang="en-US">Entered as a matrix formula, delivers the result of three SIN calculations with the arguments 1, 2, and 3.</paragraph> +<h3 id="hd_id3148660">Editing Array Formulas</h3> +<list type="ordered"> + <listitem> + <paragraph id="par_id3149241" role="listitem" xml-lang="en-US">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"><keycode>Command</keycode></caseinline><defaultinline><keycode>Ctrl</keycode></defaultinline></switchinline> + <keycode>/</keycode>, where <keycode>/</keycode> is the division key on the numeric keypad.</paragraph> + </listitem> + <listitem> + <paragraph id="par_id3143274" role="listitem" xml-lang="en-US">Either press <emph>F2</emph> or position the cursor in the input line. Both of these actions let you edit the formula.</paragraph> + </listitem> + <listitem> + <paragraph id="par_id3154798" role="listitem" xml-lang="en-US">After you have made changes, press <switchinline select="sys"><caseinline select="MAC"><emph>Command</emph></caseinline><defaultinline><emph>Ctrl</emph></defaultinline></switchinline><emph> + Shift + Enter</emph>.</paragraph> + </listitem> +</list> + <tip id="par_id3150628">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.</tip> + +<h3 id="hd_id541633516074226">Deleting Array Formulae</h3> +<list type="ordered"> + <listitem> + <paragraph id="par_id681633516103267" role="listitem">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"><keycode>Command</keycode></caseinline><defaultinline><keycode>Ctrl</keycode></defaultinline></switchinline> + <keycode>/</keycode>, where <keycode>/</keycode> is the division key on the numeric keypad.</paragraph> + </listitem> + <listitem> + <paragraph id="par_id61633516164519" role="listitem">Press <keycode>Delete</keycode> to delete the array contents, including the array formula, or press <keycode>Backspace</keycode> and this brings up the <link href="text/scalc/01/02150000.xhp" name="delete contents">Delete Contents</link> dialog box. Select <emph>Formula</emph> or <emph>Delete All</emph> and click <emph>OK</emph>.</paragraph> + </listitem> +</list> + +<h3 id="hd_id3145608">Copying Array Formulas</h3> +<list type="ordered"> + <listitem> + <paragraph id="par_id3149585" role="listitem" xml-lang="en-US">Select the cell range or array containing the array formula.</paragraph> + </listitem> + <listitem> + <paragraph id="par_id3154619" role="listitem" xml-lang="en-US">Either press <emph>F2</emph> or position the cursor in the input line.</paragraph> + </listitem> + <listitem> + <paragraph id="par_id3150994" role="listitem" xml-lang="en-US">Copy the formula into the input line by pressing <switchinline select="sys"><caseinline select="MAC"><emph>Command</emph></caseinline><defaultinline><emph>Ctrl</emph></defaultinline></switchinline><emph> + C</emph>.</paragraph> + </listitem> + <listitem> + <paragraph id="par_id3146787" role="listitem" xml-lang="en-US">Select a range of cells where you want to insert the array formula and either press <emph>F2</emph> or position the cursor in the input line.</paragraph> + </listitem> + <listitem> + <paragraph id="par_id3154419" role="listitem" xml-lang="en-US">Paste the formula by pressing <switchinline select="sys"><caseinline select="MAC"><emph>Command</emph></caseinline><defaultinline><emph>Ctrl</emph></defaultinline></switchinline><emph> + V</emph> in the selected space and confirm it by pressing <switchinline select="sys"><caseinline select="MAC"><emph>Command</emph></caseinline><defaultinline><emph>Ctrl</emph></defaultinline></switchinline><emph> + Shift + Enter</emph>. The selected range now contains the array formula.</paragraph> + </listitem> +</list> +<h3 id="hd_id3154834">Adjusting an Array Range</h3> + <paragraph id="par_id3148679" role="paragraph" xml-lang="en-US">If you want to edit the output array, do the following:</paragraph> +<list type="ordered"> + <listitem> + <paragraph id="par_id3151102" role="listitem" xml-lang="en-US">Select the cell range or array containing the array formula.</paragraph> + </listitem> + <listitem> + <paragraph id="par_id3147096" role="listitem" xml-lang="en-US">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> + <note id="par_id3150974">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.</note> + <paragraph id="par_id3146080" role="paragraph" xml-lang="en-US">By holding down the <switchinline select="sys"><caseinline select="MAC"><emph>Command</emph></caseinline><defaultinline><emph>Ctrl</emph></defaultinline></switchinline> key, you can create a copy of the array formula in the given range.</paragraph> +<h3 id="par_idN10D47">Conditional Array Calculations</h3> + <paragraph id="par_idN10D4B" role="paragraph" xml-lang="en-US">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 id="par_idN10D4E" role="paragraph" xml-lang="en-US">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 id="par_idN10D65" role="tablehead" localize="false">A</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_idN10D6B" role="tablehead" xml-lang="en-US">B (formula)</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_idN10B75" role="tablehead" xml-lang="en-US">B (result)</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_idN10D79" role="tablehead" localize="false">1</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_idN10D80" role="paragraph" localize="false">1</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_idN10D86" role="paragraph" xml-lang="en-US">{=IF(A1:A3>0;"yes";"no")}</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_idN10D8C" role="tablecontent" xml-lang="en-US">yes</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_idN10D94" role="tablehead" localize="false">2</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_idN10D9B" role="paragraph" localize="false">0</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_idN10DA1" role="paragraph" xml-lang="en-US">{=IF(A1:A3>0;"yes";"no")}</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_idN10DA7" role="tablecontent" xml-lang="en-US">no</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_idN10DAF" role="tablehead" localize="false">3</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_idN10DB6" role="paragraph" localize="false">1</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_idN10DBC" role="paragraph" xml-lang="en-US">{=IF(A1:A3>0;"yes";"no")}</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_idN10DC2" role="tablecontent" xml-lang="en-US">yes</paragraph> + </tablecell> + </tablerow> +</table> + <paragraph id="par_idN10DD0" role="paragraph" xml-lang="en-US">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 id="par_idN10DE2" role="tablehead" localize="false">A</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_idN10DE8" role="tablehead" xml-lang="en-US">B (formula)</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_idN10DEE" role="tablehead" xml-lang="en-US">B (result)</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_idN10DF4" role="tablehead" xml-lang="en-US">C (forced array formula)</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_idN10DFA" role="tablehead" xml-lang="en-US">C (result)</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_idN10E02" role="tablehead" localize="false">1</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_idN10E09" role="tablecontent" localize="false">1</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_idN10E0F" role="tablecontent" localize="false">=A1:A2+1</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_idN10E17" role="tablecontent" localize="false">2</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_idN10E1D" role="tablecontent" xml-lang="en-US">=SUMPRODUCT(A1:A2+1)</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_idN10E25" role="tablecontent" localize="false">5</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_idN10E2D" role="tablehead" localize="false">2</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_idN10E34" role="tablecontent" localize="false">2</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_idN10E3A" role="tablecontent" localize="false">=A1:A2+1</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_idN10E42" role="tablecontent" localize="false">3</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_idN10E48" role="tablecontent" xml-lang="en-US">=SUMPRODUCT(A1:A2+1)</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_idN10E50" role="tablecontent" localize="false">5</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_idN10E58" role="tablehead" localize="false">3</paragraph> + </tablecell> + <tablecell> + </tablecell> + <tablecell> + <paragraph id="par_idN10E63" role="tablecontent" localize="false">=A1:A2+1</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_idN10E6A" role="tablecontent" xml-lang="en-US">#VALUE!</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_idN10E70" role="tablecontent" xml-lang="en-US">=SUMPRODUCT(A1:A2+1)</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_idN10E78" role="tablecontent" localize="false">5</paragraph> + </tablecell> + </tablerow> +</table> +<sort order="asc" descendant="h2"> +<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"/> +<h2 id="hd_id3158446">MUNIT</h2> + <paragraph id="par_id3154121" role="paragraph" xml-lang="en-US"><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> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph id="par_id3156271" role="code" xml-lang="en-US">MUNIT(Dimensions)</paragraph> + <paragraph id="par_id3159390" role="paragraph" xml-lang="en-US"><emph>Dimensions</emph> refers to the size of the array unit.</paragraph> + <note id="par_idN10C9B">You can find a general introduction to Array functions at the top of this page.</note> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph id="par_id3150949" role="paragraph" xml-lang="en-US">Select a square range within the spreadsheet, for example, from A1 to E5.</paragraph> + <paragraph id="par_id3151260" role="paragraph" xml-lang="en-US">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 id="par_id3150403" role="paragraph" xml-lang="en-US">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"><item type="keycode">Shift + Command + Enter</item></caseinline><defaultinline><item type="keycode">Shift + Ctrl + Enter</item></defaultinline></switchinline>.</paragraph> + <paragraph id="par_id3156143" role="paragraph" xml-lang="en-US">You now see a unit array with a range of A1:E5.</paragraph> + <paragraph id="par_idN10FA7" role="paragraph" localize="false" xml-lang="en-US"><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"/> +<h2 id="hd_id3159084">FREQUENCY</h2> + <paragraph id="par_id3145777" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_HAEUFIGKEIT">Indicates the frequency distribution in a one-column-array.</ahelp> The function counts the number of values in the <emph>Data</emph> array that are within the values given by the <emph>Classes</emph> array.</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph id="par_id3155498" role="code" xml-lang="en-US">FREQUENCY(Data; Classes)</paragraph> + <paragraph id="par_id3154352" role="paragraph" xml-lang="en-US"><emph>Data</emph> represents the reference to the values to be counted.</paragraph> + <paragraph id="par_id3148402" role="paragraph" xml-lang="en-US"><emph>Classes</emph> represents the array of the limit values.</paragraph> + <embed href="text/scalc/01/common_func.xhp#datenumbersequencenote"/> + <note id="par_idN10D71">You can find a general introduction to Array functions at the top of this page.</note> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph id="par_id3155904" role="paragraph" xml-lang="en-US">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 id="par_id3155869" role="tablehead" localize="false">A</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3149328" role="tablehead" localize="false">B</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3152467" role="tablehead" localize="false">C</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id3154528" role="tablehead" localize="false">1</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3149744" role="paragraph" localize="false">12</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3147309" role="paragraph" localize="false">5</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3154199" role="paragraph" localize="false">1</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id3159218" role="tablehead" localize="false">2</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3153263" role="paragraph" localize="false">8</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3156201" role="paragraph" localize="false">10</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3147552" role="paragraph" localize="false">3</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id3149174" role="tablehead" localize="false">3</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3151201" role="paragraph" localize="false">24</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3150245" role="paragraph" localize="false">15</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3159194" role="paragraph" localize="false">2</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id3146925" role="tablehead" localize="false">4</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3154128" role="paragraph" localize="false">11</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3151067" role="paragraph" localize="false">20</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3156033" role="paragraph" localize="false">3</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id3149298" role="tablehead" localize="false">5</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3151382" role="paragraph" localize="false">5</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3155141" role="paragraph" localize="false">25</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3145213" role="paragraph" localize="false">1</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id3145268" role="tablehead" localize="false">6</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3163724" role="paragraph" localize="false">20</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3147132" role="paragraph" localize="false">>25</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3148903" role="paragraph" localize="false">1</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id3151007" role="tablehead" localize="false">7</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3153294" role="paragraph" localize="false">16</paragraph> + </tablecell> + <tablecell> + </tablecell> + <tablecell> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id3147284" role="tablehead" localize="false">8</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3154914" role="paragraph" localize="false">9</paragraph> + </tablecell> + <tablecell> + </tablecell> + <tablecell> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id3154218" role="tablehead" localize="false">9</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3147226" role="paragraph" localize="false">7</paragraph> + </tablecell> + <tablecell> + </tablecell> + <tablecell> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id3149045" role="tablehead" localize="false">10</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3155799" role="paragraph" localize="false">16</paragraph> + </tablecell> + <tablecell> + </tablecell> + <tablecell> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id3155076" role="tablehead" localize="false">11</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3150217" role="paragraph" localize="false">33</paragraph> + </tablecell> + <tablecell> + </tablecell> + <tablecell> + </tablecell> + </tablerow> +</table> + <paragraph id="par_id3150312" role="paragraph" xml-lang="en-US">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 id="par_idN11269" role="paragraph" localize="false" xml-lang="en-US"><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"/> +<h2 id="hd_id3151030">MDETERM</h2> + <paragraph id="par_id3154073" role="paragraph" xml-lang="en-US"><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> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph id="par_id3156380" role="code" xml-lang="en-US">MDETERM(Array)</paragraph> + <paragraph id="par_id3150290" role="paragraph" xml-lang="en-US"><emph>Array</emph> represents a square array in which the determinants are defined.</paragraph> + <note id="par_idN11635">You can find a general introduction to using Array functions on top of this page.</note> + <paragraph id="par_idN11333" role="paragraph" localize="false" xml-lang="en-US"><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"/> +<h2 id="hd_id3151348">MINVERSE</h2> + <paragraph id="par_id3145569" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_MINV">Returns the inverse array.</ahelp></paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph id="par_id3156085" role="code" xml-lang="en-US">MINVERSE(Array)</paragraph> + <paragraph id="par_id3157849" role="paragraph" xml-lang="en-US"><emph>Array</emph> represents a square array that is to be inverted.</paragraph> + <paragraph id="par_idN113EE" role="paragraph" localize="false" xml-lang="en-US"><embedvar href="text/scalc/00/00000004.xhp#moreontop"/></paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph id="par_id3149638" role="paragraph" xml-lang="en-US">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"/> +<h2 id="hd_id3148546">MMULT</h2> + <paragraph id="par_id3148518" role="paragraph" xml-lang="en-US"><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> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph id="par_id3150798" role="code" xml-lang="en-US">MMULT(Array 1; Array 2)</paragraph> + <paragraph id="par_id3150812" role="paragraph" xml-lang="en-US"><emph>Array 1</emph> represents the first array used in the array product.</paragraph> + <paragraph id="par_id3152553" role="paragraph" xml-lang="en-US"><emph>Array 2</emph> represents the second array with the same number of rows.</paragraph> + <note id="par_idN114C3" localize="false"><embedvar href="text/scalc/00/00000004.xhp#moreontop"/></note> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph id="par_id3146826" role="paragraph" xml-lang="en-US">Select a square range. Choose the MMULT function. Select <emph>Array 1</emph>, then select <emph>Array 2</emph>. Using the <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"/> +<h2 id="hd_id3154970">TRANSPOSE</h2> + <paragraph id="par_id3155276" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_MTRANS">Transposes the rows and columns of an array.</ahelp></paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph id="par_id3153843" role="code" xml-lang="en-US">TRANSPOSE(Array)</paragraph> + <paragraph id="par_id3153857" role="paragraph" xml-lang="en-US"><emph>Array</emph> represents the array in the spreadsheet that is to be transposed.</paragraph> + <note id="par_idN11035">You can find a general introduction to using Array functions on top of this page.</note> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph id="par_id3159366" role="paragraph" xml-lang="en-US">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"><emph>Shift + Command + Enter</emph></caseinline><defaultinline><emph>Shift + Ctrl + Enter</emph></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> +<table id="tbl_id6215816"> + <tablerow> + <tablecell> + </tablecell> + <tablecell> + <paragraph id="par_idN11B3G" role="tablehead" localize="false" xml-lang="en-US">A</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_idN11B46" role="tablehead" localize="false" xml-lang="en-US">B</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_idN11B6C" role="tablehead" localize="false" xml-lang="en-US">C</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_idN11B52" role="tablehead" localize="false" xml-lang="en-US">D</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_idN11B69" role="tablehead" localize="false">1</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_idN11B8F" role="tableicontent" localize="false" xml-lang="en-US"><item type="input">2</item></paragraph> + </tablecell> + <tablecell> + <paragraph id="par_idN11B35" role="tablecontent" localize="false" xml-lang="en-US"><item type="input">3</item></paragraph> + </tablecell> + <tablecell> + <paragraph id="par_idN11B1B" role="tablecontent" localize="false" xml-lang="en-US"><item type="input">4</item></paragraph> + </tablecell> + <tablecell> + <paragraph id="par_idN11B21" role="tablecontent" localize="false" xml-lang="en-US"><item type="input">5</item></paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_idN11B38" role="tablehead" localize="false" xml-lang="en-US">2</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_idN11B6F" role="tablecontent" localize="false" xml-lang="en-US"><item type="input">6</item></paragraph> + </tablecell> + <tablecell> + <paragraph id="par_idN11B75" role="tablecontent" localize="false" xml-lang="en-US"><item type="input">7</item></paragraph> + </tablecell> + <tablecell> + <paragraph id="par_idN11B81" role="tablecontent" localize="false" xml-lang="en-US"><item type="input">8</item></paragraph> + </tablecell> + <tablecell> + <paragraph id="par_idN11B7H" role="tablecontent" localize="false" xml-lang="en-US"><item type="input">9</item></paragraph> + </tablecell> + </tablerow> +</table> + <paragraph id="par_id3168518" role="paragraph" xml-lang="en-US">The above table is 2 rows, 4 columns. In order to transpose it, you must select 4 rows, 2 columns. Assuming you want to transpose the above table to the range A7:B10 (4 rows, 2 columns) you must select the entire range and then enter the following:</paragraph> + <paragraph id="par_id3166145" role="code" xml-lang="en-US">TRANSPOSE(A1:D2)</paragraph> + <paragraph id="par_id3178518" role="paragraph" xml-lang="en-US">Then <emph>make sure to enter it as matrix formula with </emph><switchinline select="sys"><caseinline select="MAC"><emph>Shift + Command + Enter</emph></caseinline><defaultinline><emph>Shift + Ctrl + Enter</emph></defaultinline></switchinline>. The result will be as follows:</paragraph> +<table id="tbl_id6215816"> + <tablerow> + <tablecell> + </tablecell> + <tablecell> + <paragraph id="par_idN21B2H" role="tablehead" localize="false" xml-lang="en-US">A</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_idN21B38" role="tablehead" localize="false" xml-lang="en-US">B</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_idN21B50" role="tablehead" localize="false" xml-lang="en-US">7</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_idN21B4G" role="tablecontent" localize="false" xml-lang="en-US"><item type="input">2</item></paragraph> + </tablecell> + <tablecell> + <paragraph id="par_idN21B57" role="tablecontent" localize="false" xml-lang="en-US"><item type="input">6</item></paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_idN21B70" role="tablehead" localize="false" xml-lang="en-US">8</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_idN21B6F" role="tablecontent" localize="false" xml-lang="en-US"><item type="input">3</item></paragraph> + </tablecell> + <tablecell> + <paragraph id="par_idN21B77" role="tablecontent" localize="false" xml-lang="en-US"><item type="input">7</item></paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_idN21B70" role="tablehead" localize="false" xml-lang="en-US">9</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_idN31B6F" role="tablecontent" localize="false" xml-lang="en-US"><item type="input">4</item></paragraph> + </tablecell> + <tablecell> + <paragraph id="par_idN31B77" role="tablecontent" localize="false" xml-lang="en-US"><item type="input">8</item></paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_idN51B70" role="tablehead" localize="false" xml-lang="en-US">10</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_idN51B6F" role="tablecontent" localize="false" xml-lang="en-US"><item type="input">5</item></paragraph> + </tablecell> + <tablecell> + <paragraph id="par_idN61B77" role="tablecontent" localize="false" xml-lang="en-US"><item type="input">9</item></paragraph> + </tablecell> + </tablerow> +</table> +</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"/> +<h2 id="hd_id3109846">LINEST</h2> + <paragraph id="par_id3144733" role="paragraph" xml-lang="en-US"><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 https://wiki.documentfoundation.org/Documentation/How_Tos/Calc:_LINEST_function (issue 76142)</comment></paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph id="par_id3152839" role="code" xml-lang="en-US">LINEST(data_Y [; data_X [; linearType [; stats]]])</paragraph> + <paragraph id="par_id3152853" role="paragraph" xml-lang="en-US"><emph>data_Y</emph> is a single row or column range specifying the y coordinates in a set of data points.</paragraph> + <paragraph id="par_id3154428" role="paragraph" xml-lang="en-US"><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 id="par_id0811200804502119" role="paragraph" xml-lang="en-US">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 id="par_id3154448" role="paragraph" xml-lang="en-US">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 id="par_id3154142" role="paragraph" xml-lang="en-US">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 id="par_id0811200804502261" role="paragraph" xml-lang="en-US">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"><emph>Command</emph></caseinline><defaultinline><emph>Ctrl</emph></defaultinline></switchinline><emph> + Shift + Return</emph> rather than just <emph>Return</emph>).</paragraph> + <paragraph id="par_idN11416" role="paragraph" localize="false" xml-lang="en-US"><embedvar href="text/scalc/00/00000004.xhp#optional"/></paragraph> + <paragraph id="par_idN116C6" role="paragraph" localize="false" xml-lang="en-US"><embedvar href="text/scalc/00/00000004.xhp#moreontop"/></paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph id="par_id3154176" role="paragraph" xml-lang="en-US">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 id="par_id3155468" role="paragraph" xml-lang="en-US">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> +<h3 id="hd_id3155491">Other LINEST Results:</h3> + <paragraph id="par_id3159291" role="paragraph" xml-lang="en-US">Examine the following examples:</paragraph> +<table id="tbl_id3159305"> + <tablerow> + <tablecell> + </tablecell> + <tablecell> + <paragraph id="par_id3157922" role="tablehead" localize="false">A</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3157945" role="tablehead" localize="false">B</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3152486" role="tablehead" localize="false">C</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3152509" role="tablehead" localize="false">D</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3152532" role="tablehead" localize="false">E</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3153431" role="tablehead" localize="false">F</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3153454" role="tablehead" localize="false">G</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id3154995" role="tablehead" localize="false">1</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3155021" role="paragraph" xml-lang="en-US"><item type="input">x1</item></paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3155044" role="paragraph" xml-lang="en-US"><item type="input">x2</item></paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3163734" role="paragraph" xml-lang="en-US"><item type="input">y</item></paragraph> + </tablecell> + <tablecell> + </tablecell> + <tablecell> + <paragraph id="par_id3163766" role="paragraph" xml-lang="en-US"><item type="input">LINEST value</item></paragraph> + </tablecell> + <tablecell> + </tablecell> + <tablecell> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id3145686" role="tablehead" localize="false">2</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3145713" role="paragraph" localize="false"><item type="input">4</item></paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3145736" role="paragraph" localize="false"><item type="input">7</item></paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3159427" role="paragraph" localize="false"><item type="input">100</item></paragraph> + </tablecell> + <tablecell> + </tablecell> + <tablecell> + <paragraph id="par_id3159460" role="paragraph" xml-lang="en-US"><item type="input">4,17</item></paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3159483" role="paragraph" xml-lang="en-US">-<item type="input">3,48</item></paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3152381" role="paragraph" xml-lang="en-US"><item type="input">82,33</item></paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id3152408" role="tablehead" localize="false">3</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3152435" role="paragraph" localize="false"><item type="input">5</item></paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3152458" role="paragraph" localize="false"><item type="input">9</item></paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3155652" role="paragraph" localize="false"><item type="input">105</item></paragraph> + </tablecell> + <tablecell> + </tablecell> + <tablecell> + <paragraph id="par_id3155684" role="paragraph" xml-lang="en-US"><item type="input">5,46</item></paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3155707" role="paragraph" xml-lang="en-US"><item type="input">10,96</item></paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3155730" role="paragraph" xml-lang="en-US"><item type="input">9,35</item></paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id3159506" role="tablehead" localize="false">4</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3159533" role="paragraph" localize="false"><item type="input">6</item></paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3159556" role="paragraph" localize="false"><item type="input">11</item></paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3159579" role="paragraph" localize="false"><item type="input">104</item></paragraph> + </tablecell> + <tablecell> + </tablecell> + <tablecell> + <paragraph id="par_id3159611" role="paragraph" xml-lang="en-US"><item type="input">0,87</item></paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3152606" role="paragraph" xml-lang="en-US"><item type="input">5,06</item></paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3152629" role="paragraph" xml-lang="en-US"><item type="input">#NA</item></paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id3152655" role="tablehead" localize="false">5</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3152682" role="paragraph" localize="false"><item type="input">7</item></paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3152705" role="paragraph" localize="false"><item type="input">12</item></paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3152728" role="paragraph" localize="false"><item type="input">108</item></paragraph> + </tablecell> + <tablecell> + </tablecell> + <tablecell> + <paragraph id="par_id3144352" role="paragraph" xml-lang="en-US"><item type="input">13,21</item></paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3144375" role="paragraph" localize="false"><item type="input">4</item></paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3144398" role="paragraph" xml-lang="en-US"><item type="input">#NA</item></paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id3144425" role="tablehead" localize="false">6</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3144452" role="paragraph" localize="false"><item type="input">8</item></paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3144475" role="paragraph" localize="false"><item type="input">15</item></paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3144498" role="paragraph" localize="false"><item type="input">111</item></paragraph> + </tablecell> + <tablecell> + </tablecell> + <tablecell> + <paragraph id="par_id3158233" role="paragraph" xml-lang="en-US"><item type="input">675,45</item></paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3158256" role="paragraph" xml-lang="en-US"><item type="input">102,26</item></paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3158279" role="paragraph" xml-lang="en-US"><item type="input">#NA</item></paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id3158306" role="tablehead" localize="false">7</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3158333" role="paragraph" localize="false"><item type="input">9</item></paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3158356" role="paragraph" localize="false"><item type="input">17</item></paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3158379" role="paragraph" localize="false"><item type="input">120</item></paragraph> + </tablecell> + <tablecell> + </tablecell> + <tablecell> + </tablecell> + <tablecell> + </tablecell> + <tablecell> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id3144560" role="tablehead" localize="false">8</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3144586" role="paragraph" localize="false"><item type="input">10</item></paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3144609" role="paragraph" localize="false"><item type="input">19</item></paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3144632" role="paragraph" localize="false"><item type="input">133</item></paragraph> + </tablecell> + <tablecell> + </tablecell> + <tablecell> + </tablecell> + <tablecell> + </tablecell> + <tablecell> + </tablecell> + </tablerow> +</table> + <paragraph id="par_id3144687" role="paragraph" xml-lang="en-US">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 id="par_id3158020" role="paragraph" xml-lang="en-US"><emph>data_Y</emph> is C2:C8</paragraph> + <paragraph id="par_id3158039" role="paragraph" xml-lang="en-US"><emph>data_X</emph> is A2:B8</paragraph> + <paragraph id="par_id3158058" role="paragraph" xml-lang="en-US"><emph>linearType</emph> and <emph>stats</emph> are both set to 1.</paragraph> + <paragraph id="par_id3158084" role="paragraph" xml-lang="en-US">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 id="par_id3158106" role="paragraph" xml-lang="en-US">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 id="par_id3158128" role="paragraph" xml-lang="en-US"><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 id="par_id3158146" role="paragraph" xml-lang="en-US">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 id="par_id3158184" role="paragraph" xml-lang="en-US">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 id="par_id3158204" role="paragraph" xml-lang="en-US">E3 and F3: The standard error of the slope value.</paragraph> + <paragraph id="par_id3145845" role="paragraph" xml-lang="en-US">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 id="par_id3145859" role="paragraph" xml-lang="en-US">E4: RSQ</paragraph> + <paragraph id="par_id3145880" role="paragraph" xml-lang="en-US">F4: The standard error of the regression calculated for the Y value.</paragraph> + <paragraph id="par_id3145894" role="paragraph" xml-lang="en-US">E5: The F value from the variance analysis.</paragraph> + <paragraph id="par_id3145915" role="paragraph" xml-lang="en-US">F5: The degrees of freedom from the variance analysis.</paragraph> + <paragraph id="par_id3145937" role="paragraph" xml-lang="en-US">E6: The sum of the squared deviation of the estimated Y values from their linear mean.</paragraph> + <paragraph id="par_id3145952" role="paragraph" xml-lang="en-US">F6: The sum of the squared deviation of the estimated Y value from the given Y values.</paragraph> + <paragraph id="par_idN11B04" role="paragraph" localize="false" xml-lang="en-US"><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"/> +<h2 id="hd_id3146009">LOGEST</h2> + <paragraph id="par_id3146037" role="paragraph" xml-lang="en-US"><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> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph id="par_id3163123" role="code" xml-lang="en-US">LOGEST(DataY [; DataX [; FunctionType [; Stats]]])</paragraph> + <paragraph id="par_id3163137" role="paragraph" xml-lang="en-US"><emph>DataY</emph> represents the Y Data array.</paragraph> + <paragraph id="par_id3163155" role="paragraph" xml-lang="en-US"><emph>DataX</emph> (optional) represents the X Data array.</paragraph> + <paragraph id="par_id3163174" role="paragraph" xml-lang="en-US"><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 id="par_id3163196" role="paragraph" xml-lang="en-US"><emph>Stats</emph> (optional). If Stats=0, only the regression coefficient is calculated.</paragraph> + <paragraph id="par_idN118F7" role="paragraph" localize="false" xml-lang="en-US"><embedvar href="text/scalc/00/00000004.xhp#optional"/></paragraph> + <paragraph id="par_idN11BC3" role="paragraph" localize="false" xml-lang="en-US"><embedvar href="text/scalc/00/00000004.xhp#moreontop"/></paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph id="par_id3163230" role="paragraph" xml-lang="en-US">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"/> +<h2 id="hd_id3163286">SUMPRODUCT</h2> + <paragraph id="par_id3163314" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_SUMMENPRODUKT">Multiplies corresponding elements in the given arrays, and returns the sum of those products.</ahelp></paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph id="par_id3163347" role="code" xml-lang="en-US">SUMPRODUCT(Array 1[; Array 2;][...;[Array 255]])</paragraph> + <paragraph id="par_id3163362" role="paragraph" xml-lang="en-US"><emph>Array 1[; Array 2;][...;[Array 255]]</emph> represent arrays whose corresponding elements are to be multiplied.</paragraph> + <paragraph id="par_idN11B19" role="paragraph" xml-lang="en-US">At least one array must be part of the argument list. If only one array is given, all array elements are summed. If more than one array is given, they must all be the same size.</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<table id="tbl_id6215704"> + <tablerow> + <tablecell> + </tablecell> + <tablecell> + <paragraph id="par_idN11B2F" role="tablehead" localize="false">A</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_idN11B35" role="tablehead" localize="false">B</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_idN11B3B" role="tablehead" localize="false">C</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_idN11B41" role="tablehead" localize="false">D</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_idN11B48" role="tablehead" localize="false">1</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_idN11B4E" role="tablecontent" localize="false"><item type="input">2</item></paragraph> + </tablecell> + <tablecell> + <paragraph id="par_idN11B54" role="tablecontent" localize="false"><item type="input">3</item></paragraph> + </tablecell> + <tablecell> + <paragraph id="par_idN11B5A" role="tablecontent" localize="false"><item type="input">4</item></paragraph> + </tablecell> + <tablecell> + <paragraph id="par_idN11B60" role="tablecontent" xml-lang="en-US"><item type="input">5</item></paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_idN11B67" role="tablehead" localize="false">2</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_idN11B6D" role="tablecontent" localize="false"><item type="input">6</item></paragraph> + </tablecell> + <tablecell> + <paragraph id="par_idN11B73" role="tablecontent" localize="false"><item type="input">7</item></paragraph> + </tablecell> + <tablecell> + <paragraph id="par_idN11B79" role="tablecontent" localize="false"><item type="input">8</item></paragraph> + </tablecell> + <tablecell> + <paragraph id="par_idN11B7F" role="tablecontent" localize="false"><item type="input">9</item></paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_idN11B86" role="tablehead" localize="false">3</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_idN11B8C" role="tablecontent" localize="false"><item type="input">10</item></paragraph> + </tablecell> + <tablecell> + <paragraph id="par_idN11B92" role="tablecontent" localize="false"><item type="input">11</item></paragraph> + </tablecell> + <tablecell> + <paragraph id="par_idN11B98" role="tablecontent" localize="false"><item type="input">12</item></paragraph> + </tablecell> + <tablecell> + <paragraph id="par_idN11B9E" role="tablecontent" localize="false"><item type="input">13</item></paragraph> + </tablecell> + </tablerow> +</table> + <paragraph id="par_idN11BA1" role="paragraph" xml-lang="en-US"><item type="input">=SUMPRODUCT(A1:B3;C1:D3)</item> returns 397.</paragraph> + <paragraph id="par_idN11BA4" role="paragraph" xml-lang="en-US">Calculation: A1*C1 + B1*D1 + A2*C2 + B2*D2 + A3*C3 + B3*D3</paragraph> + <paragraph id="par_idN11BA7" role="paragraph" xml-lang="en-US">You can use SUMPRODUCT to calculate the scalar product of two vectors.</paragraph> + <note id="par_idN11BBC">SUMPRODUCT returns a single number, it is not necessary to enter the function as an array function.</note> + <paragraph id="par_idN11C91" role="paragraph" localize="false" xml-lang="en-US"><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"/> +<h2 id="hd_id3144842">SUMX2MY2</h2> + <paragraph id="par_id3144871" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_SUMMEX2MY2">Returns the sum of the difference of squares of corresponding values in two arrays.</ahelp></paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph id="par_id3144903" role="code" xml-lang="en-US">SUMX2MY2(ArrayX; ArrayY)</paragraph> + <paragraph id="par_id3144916" role="paragraph" xml-lang="en-US"><emph>ArrayX</emph> represents the first array whose elements are to be squared and added.</paragraph> + <paragraph id="par_id3144936" role="paragraph" xml-lang="en-US"><emph>ArrayY</emph> represents the second array whose elements are to be squared and subtracted.</paragraph> + <paragraph id="par_idN11D6B" role="paragraph" localize="false" xml-lang="en-US"><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"/> +<h2 id="hd_id3145026">SUMX2PY2</h2> + <paragraph id="par_id3145055" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_SUMMEX2PY2">Returns the sum of the sum of squares of corresponding values in two arrays.</ahelp></paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph id="par_id3163404" role="code" xml-lang="en-US">SUMX2PY2(ArrayX; ArrayY)</paragraph> + <paragraph id="par_id3163417" role="paragraph" xml-lang="en-US"><emph>ArrayX</emph> represents the first array whose elements are to be squared and added.</paragraph> + <paragraph id="par_id3163437" role="paragraph" xml-lang="en-US"><emph>ArrayY</emph> represents the second array, whose elements are to be squared and added.</paragraph> + <paragraph id="par_idN11E45" role="paragraph" localize="false" xml-lang="en-US"><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"/> +<h2 id="hd_id3163527">SUMXMY2</h2> + <paragraph id="par_id3163556" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_SUMMEXMY2">Adds the squares of the variance between corresponding values in two arrays.</ahelp></paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph id="par_id3163588" role="code" xml-lang="en-US">SUMXMY2(ArrayX; ArrayY)</paragraph> + <paragraph id="par_id3163601" role="paragraph" xml-lang="en-US"><emph>ArrayX</emph> represents the first array whose elements are to be subtracted and squared.</paragraph> + <paragraph id="par_id3163621" role="paragraph" xml-lang="en-US"><emph>ArrayY</emph> represents the second array, whose elements are to be subtracted and squared.</paragraph> + <paragraph id="par_idN11F1F" role="paragraph" localize="false" xml-lang="en-US"><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"/> +<h2 id="hd_id3166062">TREND</h2> + <paragraph id="par_id3166091" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_TREND">Returns values along a linear trend.</ahelp></paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph id="par_id3166122" role="code" xml-lang="en-US">TREND(DataY [; DataX [; NewDataX [; LinearType]]])</paragraph> + <paragraph id="par_id3166137" role="paragraph" xml-lang="en-US"><emph>DataY</emph> represents the Y Data array.</paragraph> + <paragraph id="par_id3166156" role="paragraph" xml-lang="en-US"><emph>DataX</emph> (optional) represents the X Data array.</paragraph> + <paragraph id="par_id3166176" role="paragraph" xml-lang="en-US"><emph>NewDataX</emph> (optional) represents the array of the X data, which are used for recalculating values.</paragraph> + <paragraph id="par_id3166196" role="paragraph" xml-lang="en-US"><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 id="par_idN11D2F" role="paragraph" localize="false" xml-lang="en-US"><embedvar href="text/scalc/00/00000004.xhp#optional"/></paragraph> + <paragraph id="par_idN12019" role="paragraph" localize="false" xml-lang="en-US"><embedvar href="text/scalc/00/00000004.xhp#moreontop"/></paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph id="par_id3166245" role="paragraph" xml-lang="en-US">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"/> +<h2 id="hd_id3166317">GROWTH</h2> + <paragraph id="par_id3166346" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_VARIATION">Calculates the points of an exponential trend in an array.</ahelp></paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph id="par_id3166377" role="code" xml-lang="en-US">GROWTH(DataY [; [ DataX ] [; [ NewDataX ] [; FunctionType ] ] ])</paragraph> + <paragraph id="par_id3166392" role="paragraph" xml-lang="en-US"><emph>DataY</emph> represents the Y Data array.</paragraph> + <paragraph id="par_id3166411" role="paragraph" xml-lang="en-US"><emph>DataX</emph> (optional) represents the X Data array.</paragraph> + <paragraph id="par_id3173797" role="paragraph" xml-lang="en-US"><emph>NewDataX</emph> (optional) represents the X data array, in which the values are recalculated.</paragraph> + <paragraph id="par_id3173817" role="paragraph" xml-lang="en-US"><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 id="par_idN11DFD" role="paragraph" localize="false" xml-lang="en-US"><embedvar href="text/scalc/00/00000004.xhp#optional"/></paragraph> + <paragraph id="par_idN12113" role="paragraph" localize="false" xml-lang="en-US"><embedvar href="text/scalc/00/00000004.xhp#moreontop"/></paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph id="par_id3173852" role="paragraph" xml-lang="en-US">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 <emph>DataY</emph>. 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/helpcontent2/source/text/scalc/01/04060108.xhp b/helpcontent2/source/text/scalc/01/04060108.xhp new file mode 100644 index 000000000..4246cc6be --- /dev/null +++ b/helpcontent2/source/text/scalc/01/04060108.xhp @@ -0,0 +1,153 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> + +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . + --> + + +<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> +<h1 id="hd_id3153018"><variable id="head_statistic"><link href="text/scalc/01/04060108.xhp" name="Statistics Functions">Statistics Functions</link></variable></h1> +<paragraph role="paragraph" id="par_id3157874" xml-lang="en-US"><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">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" localize="false">C</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablehead" id="par_id3145297" xml-lang="en-US" localize="false">D</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph role="tablehead" id="par_id3150661" xml-lang="en-US" localize="false">2</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablecontent" id="par_id3153551" xml-lang="en-US">x value</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablecontent" id="par_id3147536" xml-lang="en-US">y value</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph role="tablehead" id="par_id3153224" xml-lang="en-US" localize="false">3</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablecontent" id="par_id3150475" xml-lang="en-US" localize="false">-5</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablecontent" id="par_id3155367" xml-lang="en-US" localize="false">-3</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph role="tablehead" id="par_id3149783" xml-lang="en-US" localize="false">4</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablecontent" id="par_id3153181" xml-lang="en-US" localize="false">-2</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablecontent" id="par_id3148429" xml-lang="en-US" localize="false">0</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph role="tablehead" id="par_id3152588" xml-lang="en-US" localize="false">5</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablecontent" id="par_id3147483" xml-lang="en-US" localize="false">-1</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablecontent" id="par_id3083443" xml-lang="en-US" localize="false">1</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph role="tablehead" id="par_id3149826" xml-lang="en-US" localize="false">6</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablecontent" id="par_id3163820" xml-lang="en-US" localize="false">0</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablecontent" id="par_id3154816" xml-lang="en-US" localize="false">3</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph role="tablehead" id="par_id3149276" xml-lang="en-US" localize="false">7</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablecontent" id="par_id3149267" xml-lang="en-US" localize="false">2</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablecontent" id="par_id3156310" xml-lang="en-US" localize="false">4</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph role="tablehead" id="par_id3154639" xml-lang="en-US" localize="false">8</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablecontent" id="par_id3145205" xml-lang="en-US" localize="false">4</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablecontent" id="par_id3153276" xml-lang="en-US" localize="false">6</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph role="tablehead" id="par_id3150756" xml-lang="en-US" localize="false">9</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablecontent" id="par_id3156095" xml-lang="en-US" localize="false">6</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablecontent" id="par_id3152929" xml-lang="en-US" localize="false">8</paragraph> +</tablecell> +</tablerow> +</table> + +<paragraph role="paragraph" id="par_id3156324" xml-lang="en-US">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"/> +<section id="relatedtopics"> + <paragraph role="paragraph" id="par_id3150271" xml-lang="en-US" localize="false"><embedvar href="text/scalc/01/04060116.xhp#head_addin_analysis_two"/></paragraph> + <paragraph id="par_id260920162318025898" role="paragraph" localize="false" xml-lang="en-US"><embedvar href="text/scalc/01/04060100.xhp#drking"/></paragraph> +</section> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/04060109.xhp b/helpcontent2/source/text/scalc/01/04060109.xhp new file mode 100644 index 000000000..99e061ae0 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/04060109.xhp @@ -0,0 +1,700 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> + +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . + --> + + +<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> +<h1 id="hd_id3148522">Spreadsheet Functions</h1> + <paragraph xml-lang="en-US" id="par_id3144508" role="paragraph"><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" descendant="h2"> +<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"/> +<h2 id="hd_id3146968">ADDRESS</h2> + <paragraph xml-lang="en-US" id="par_id3155762" role="paragraph"><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">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">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">In INDIRECT, the parameter is appended as the second parameter.</paragraph> + <paragraph xml-lang="en-US" id="par_id102720080230151" role="paragraph">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">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">When opening documents from ODF 1.0/1.1 format, the ADDRESS functions that show a sheet name as the fourth parameter 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">When storing a document in ODF 1.0/1.1 format, if ADDRESS functions have a fourth parameter, that parameter will be removed.</paragraph> + <note id="par_id102720080230162">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.</note> + <note id="par_id1027200802301756">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.</note> + </section> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph xml-lang="en-US" id="par_id3154707" role="code">ADDRESS(Row; Column [; Abs [; A1 [; "Sheet"]]])</paragraph> + <paragraph xml-lang="en-US" id="par_id3147505" role="paragraph"> + <emph>Row</emph> represents the row number for the cell reference</paragraph> + <paragraph xml-lang="en-US" id="par_id3145323" role="paragraph"> + <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"> + <emph>Abs</emph> determines the type of reference:</paragraph> + <paragraph xml-lang="en-US" id="par_id3153298" role="paragraph">1: absolute ($A$1)</paragraph> + <paragraph xml-lang="en-US" id="par_id3150431" role="paragraph">2: row reference type is absolute; column reference is relative (A$1)</paragraph> + <paragraph xml-lang="en-US" id="par_id3146096" role="paragraph">3: row (relative); column (absolute) ($A1)</paragraph> + <paragraph xml-lang="en-US" id="par_id3153334" role="paragraph">4: relative (A1)</paragraph> + <paragraph xml-lang="en-US" id="par_id1027200802465915" role="paragraph"> + <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"> + <emph>Sheet</emph> represents the name of the sheet. It must be placed in double quotes.</paragraph> + <h3 id="hd_id3147299">Example:</h3> + <paragraph xml-lang="en-US" id="par_id3148744" role="paragraph"> + <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">If the formula above is in cell B2 of current sheet, and 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"/> +<h2 id="hd_id3150372">AREAS</h2> + <paragraph xml-lang="en-US" id="par_id3150036" role="paragraph"><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">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> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph xml-lang="en-US" id="par_id3155907" role="code">AREAS(Reference)</paragraph> + <paragraph xml-lang="en-US" id="par_id3153118" role="paragraph">Reference represents the reference to a cell or cell range.</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph xml-lang="en-US" id="par_id3149946" role="paragraph"> + <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"> + <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"/> +<h2 id="hd_id3148727">DDE</h2> + <paragraph xml-lang="en-US" id="par_id3149434" role="paragraph"><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> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph xml-lang="en-US" id="par_id3148886" role="code">DDE("Server"; "File"; "Range" [; Mode])</paragraph> + <paragraph xml-lang="en-US" id="par_id3154842" role="paragraph"> + <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"> + <emph>File</emph> is the complete file name, including path specification.</paragraph> + <paragraph xml-lang="en-US" id="par_id3147472" role="paragraph"> + <emph>Range</emph> is the area containing the data to be evaluated.</paragraph> + <paragraph xml-lang="en-US" id="par_id3152773" role="paragraph"> + <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"> + <emph>Mode</emph> + </paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3145146" role="paragraph"> + <emph>Effect</emph> + </paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3154558" role="paragraph">0 or missing</paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3145596" role="paragraph">Number format from the "Default" cell style</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3152785" role="paragraph">1</paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3154380" role="paragraph">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">2</paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3153775" role="paragraph">Data are retrieved as text; no conversion to numbers</paragraph> + </tablecell> + </tablerow> + </table> + + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph xml-lang="en-US" id="par_id3148734" role="paragraph"> + <item type="input">=DDE("soffice";"c:\office\document\data1.ods";"sheet1.A1")</item> reads the contents of cell A1 in sheet1 of the <item type="productname">%PRODUCTNAME</item> Calc spreadsheet data1.ods.</paragraph> + <paragraph xml-lang="en-US" id="par_id3153081" role="paragraph"> + <item type="input">=DDE("soffice";"c:\office\document\motto.odt";"Today's motto")</item> returns a motto in the cell containing this formula. First, you must enter a line in the motto.odt 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"/> +<h2 id="hd_id3153114">ERRORTYPE</h2> + <paragraph xml-lang="en-US" id="par_id3148568" role="paragraph"><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"/> + <note id="par_id3149877">The Status Bar displays the predefined error code from <item type="productname">%PRODUCTNAME</item> if you click the cell containing the error.</note> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph xml-lang="en-US" id="par_id3151322" role="code">ERRORTYPE(Reference)</paragraph> + <paragraph xml-lang="en-US" id="par_id3150132" role="paragraph"> + <emph>Reference</emph> contains the address of the cell in which the error occurs.</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph xml-lang="en-US" id="par_id3146904" role="paragraph">If cell A1 displays Err:518, the function <item type="input">=ERRORTYPE(A1)</item> returns the number 518.</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectiontechinfo"/> + <embed href="text/scalc/01/common_func.xhp#notODFF"/> + <paragraph role="paragraph" id="par_id311640873986703" localize="false"><literal>ORG.OPENOFFICE.ERRORTYPE</literal></paragraph> + </section> +<section id="error_type"> +<h2 id="hd_id275141466817507" localize="false"><embedvar href="text/scalc/01/func_error_type.xhp#error_type_head"/></h2> +<paragraph id="par_id164731033513430" role="paragraph" localize="false" xml-lang="en-US"><embedvar href="text/scalc/01/func_error_type.xhp#error_type_des"/></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"/> +<h2 id="hd_id3151221">INDEX</h2> + <paragraph xml-lang="en-US" id="par_id3150268" role="paragraph"><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> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph xml-lang="en-US" id="par_id3149007" role="code">INDEX(Reference [; Row [; Column [; Range]]])</paragraph> + <paragraph xml-lang="en-US" id="par_id3153260" role="paragraph"> + <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"> + <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"> + <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"> + <emph>Range</emph> (optional) represents the index of the subrange if referring to a multiple range.</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph xml-lang="en-US" id="par_id3159112" role="paragraph"> + <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"> + <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>Sheet - Named Ranges and Expressions - Define</emph>.</paragraph> + <paragraph xml-lang="en-US" id="par_id4109012" role="paragraph"> + <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"> + <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"> + <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>Sheet - Named Ranges and Expressions - 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"> + <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"> + <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"/> +<h2 id="hd_id3153181">INDIRECT</h2> + <paragraph xml-lang="en-US" id="par_id3147169" role="paragraph"><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/ful_func.xhp#func_volatile"/> + <embed href="text/scalc/01/04060109.xhp#r1c1"/> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph xml-lang="en-US" id="par_id3149824" role="code">INDIRECT(Ref [; A1])</paragraph> + <paragraph xml-lang="en-US" id="par_id3154317" role="paragraph"> + <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"> + <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> + <note id="par_idN10CAE">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></note> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph xml-lang="en-US" id="par_id3150608" role="paragraph"> + <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"> + <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"/> +<h2 id="hd_id3154818">COLUMN</h2> + <paragraph xml-lang="en-US" id="par_id3149711" role="paragraph"><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#creating_array_formulas" 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> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph xml-lang="en-US" id="par_id3149447" role="code">COLUMN([Reference])</paragraph> + <paragraph xml-lang="en-US" id="par_id3156310" role="paragraph"> + <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">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> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph xml-lang="en-US" id="par_id3147571" role="paragraph"> + <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"> + <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"> + <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"> + <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"> + <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"> + <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"/> +<h2 id="hd_id3154643">COLUMNS</h2> + <paragraph xml-lang="en-US" id="par_id3151182" role="paragraph"><ahelp hid="HID_FUNC_SPALTEN">Returns the number of columns in the given reference.</ahelp></paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph xml-lang="en-US" id="par_id3154047" role="code">COLUMNS(Array)</paragraph> + <paragraph xml-lang="en-US" id="par_id3154745" role="paragraph"> + <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> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph xml-lang="en-US" id="par_id3149577" role="paragraph"> + <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"> + <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"> + <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"/> +<h2 id="hd_id3153152">VLOOKUP</h2> +<paragraph xml-lang="en-US" id="par_id3149984" role="paragraph"><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 <emph>Index</emph>. If the <emph>Sorted</emph> 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 <emph>Lookup</emph> is not found, the last value that is smaller than the criterion will be returned. If <emph>Sorted</emph> 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#regex"/> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph xml-lang="en-US" id="par_id3150156" role="code">=VLOOKUP(Lookup; Array; Index [; SortedRangeLookup])</paragraph> + <paragraph xml-lang="en-US" id="par_id3149289" role="paragraph"> + <emph>Lookup</emph> is the value of any type looked for in the first column of the array.</paragraph> + <paragraph xml-lang="en-US" id="par_id3153884" role="paragraph"> + <emph>Array</emph> is the reference, which is to comprise at least as many columns as the number passed in Index argument.</paragraph> + <paragraph xml-lang="en-US" id="par_id3156005" role="paragraph"> + <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"> + <emph>SortedRangeLookup</emph> is an optional parameter that indicates whether the first column in the array contains range boundaries instead of plain values. In this mode, the lookup returns the value in the row with first column having value equal to or less than <emph>Lookup</emph>. E.g., it could contain dates when some tax value had been changed, and so the values represent starting dates of a period when a specific tax value was effective. Thus, searching for a date that is absent in the first array column, but falls between some existing boundary dates, would give the lower of them, allowing to find out the data being effective to the searched date. Enter the Boolean value FALSE or zero if the first column is not a range boundary list. When this parameter is TRUE or not given, the first column in the array <emph>must be sorted in ascending order</emph>. 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 greater than the lowest value of the sorted list. In unsorted lists, the search value must be matched exactly. Otherwise the function will return #N/A with message: <emph>Error: Value Not Available</emph>.</paragraph> + <embed href="text/scalc/05/empty_cells.xhp#empty_cells"/> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph xml-lang="en-US" id="par_id3154129" role="paragraph">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">Sorted</item> parameter is not necessary.</paragraph> + <paragraph xml-lang="en-US" id="par_id3145663" role="paragraph">Enter the following formula in B1:</paragraph> + <paragraph xml-lang="en-US" id="par_id3151172" role="paragraph"> + <item type="input">=VLOOKUP(A1;D1:E100;2)</item> + </paragraph> + <paragraph xml-lang="en-US" id="par_id3149200" role="paragraph">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"/> +<h2 id="hd_id3153905">SHEET</h2> + <paragraph xml-lang="en-US" id="par_id3150309" role="paragraph"><ahelp hid="HID_FUNC_TABELLE">Returns the sheet number of either 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> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph xml-lang="en-US" id="par_id3153095" role="code">SHEET([Reference])</paragraph> + <paragraph xml-lang="en-US" id="par_id3154588" role="paragraph"> + <emph>Reference</emph> is optional and is the reference to a cell, an area, or a sheet name string.</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph xml-lang="en-US" id="par_id3146988" role="paragraph"> + <input>=SHEET(Sheet2.A1)</input> returns 2 if Sheet2 is the second sheet in the spreadsheet document.</paragraph> + <paragraph role="paragraph" id="par_id491612531793751"> + <input>=SHEET("Sheet3")</input> returns 3 if Sheet3 is the third 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"/> +<h2 id="hd_id3148829">SHEETS</h2> + <paragraph xml-lang="en-US" id="par_id3148820" role="paragraph"><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> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph xml-lang="en-US" id="par_id3150777" role="code">SHEETS([Reference])</paragraph> + <paragraph xml-lang="en-US" id="par_id3153060" role="paragraph"> + <emph>Reference</emph> is the reference to a sheet or an area. This parameter is optional.</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph xml-lang="en-US" id="par_id3150507" role="paragraph"> + <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"/> +<h2 id="hd_id3158407">MATCH</h2> + <paragraph xml-lang="en-US" id="par_id3154896" role="paragraph"><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> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph xml-lang="en-US" id="par_id3159152" role="code">MATCH(Search; LookupArray [; Type])</paragraph> + <paragraph xml-lang="en-US" id="par_id3149336" role="paragraph"> + <emph>Search</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"> + <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"> + <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">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 (if enabled in calculation options) or wildcards (if enabled in calculation options).</paragraph> + <paragraph xml-lang="en-US" id="par_id3147528" role="paragraph">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. For Type = -1, the index of the last value that is larger or equal is returned.</paragraph> + <embed href="text/shared/00/00000001.xhp#regex"/> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph xml-lang="en-US" id="par_id3155343" role="paragraph"> + <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"/> +<h2 id="hd_id3158430">OFFSET</h2> + <paragraph xml-lang="en-US" id="par_id3149167" role="paragraph"><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> + <embed href="text/scalc/01/ful_func.xhp#func_volatile"/> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph xml-lang="en-US" id="par_id3159194" role="code">OFFSET(Reference; Rows; Columns [; Height [; Width]])</paragraph> + <paragraph xml-lang="en-US" id="par_id3152360" role="paragraph"> + <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"> + <emph>Rows</emph> is the number of rows by which the reference was corrected up (negative value) or down. Use 0 to stay in the same row.</paragraph> + <paragraph xml-lang="en-US" id="par_id3166458" role="paragraph"> + <emph>Columns</emph> is the number of columns by which the reference was corrected to the left (negative value) or to the right. Use 0 to stay in the same column</paragraph> + <paragraph xml-lang="en-US" id="par_id3150708" role="paragraph"> + <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"> + <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">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">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" localize="false"> + <embedvar href="text/scalc/00/00000004.xhp#optional"/> + </paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph xml-lang="en-US" id="par_id3149744" role="paragraph"> + <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"> + <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"> + <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"> + <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"> + <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 (B3:E5).</paragraph> + <paragraph xml-lang="en-US" id="par_id3153739" role="paragraph"> + <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> + <note id="par_id3153740">If <emph>Width</emph> or <emph>Height</emph> are given, the OFFSET function returns a cell range reference. If <emph>Reference</emph> is a single cell reference and both <emph>Width</emph> and <emph>Height</emph> are omitted, a single cell reference is returned.</note> + </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"/> +<h2 id="hd_id3159273">LOOKUP</h2> + <paragraph xml-lang="en-US" id="par_id3153389" role="paragraph"><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#Section9" name="VLOOKUP">VLOOKUP</link> and <link href="text/scalc/01/04060109.xhp#Section17" 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> + <note id="par_id4484084">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.</note> + <embed href="text/shared/00/00000001.xhp#regex"/> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph xml-lang="en-US" id="par_id3154104" role="code">LOOKUP(Lookup; SearchVector [; ResultVector])</paragraph> + <paragraph xml-lang="en-US" id="par_id3150646" role="paragraph"> + <emph>Lookup</emph> is the value of any type to be looked for; entered either directly or as a reference.</paragraph> + <paragraph xml-lang="en-US" id="par_id3154854" role="paragraph"> + <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"> + <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"/> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph xml-lang="en-US" id="par_id3149809" role="paragraph"> + <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"/> +<h2 id="hd_id3149425">STYLE</h2> + <paragraph xml-lang="en-US" id="par_id3150826" role="paragraph"><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 depending on 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, "red" and "green" have to be defined beforehand.</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph xml-lang="en-US" id="par_id3149302" role="code">STYLE("Style" [; Time [; "Style2"]])</paragraph> + <paragraph xml-lang="en-US" id="par_id3150596" role="paragraph"> + <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"> + <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"> + <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" localize="false"> + <embedvar href="text/scalc/00/00000004.xhp#optional"/> + </paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph xml-lang="en-US" id="par_id3151374" role="paragraph"> + <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">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"> + <item type="input">="Text"&T(STYLE("myStyle"))</item> + </paragraph> + <paragraph xml-lang="en-US" id="par_id3042085" role="paragraph">See also CURRENT() for another example.</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectiontechinfo"/> + <embed href="text/scalc/01/common_func.xhp#notODFF"/> + <paragraph role="paragraph" id="par_id311644873986703" localize="false"><literal>ORG.OPENOFFICE.STYLE</literal></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"/> +<h2 id="hd_id3150430">CHOOSE</h2> + <paragraph xml-lang="en-US" id="par_id3143270" role="paragraph"><ahelp hid="HID_FUNC_WAHL">Uses an index to return a value from a list of up to 30 values.</ahelp></paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph xml-lang="en-US" id="par_id3155425" role="code">CHOOSE(Index; Value 1 [; Value 2 [; ... [; Value 30]]])</paragraph> + <paragraph xml-lang="en-US" id="par_id3144755" role="paragraph"> + <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"> + <emph>Value 1, Value 2, ..., Value 30</emph> is the list of values entered as a reference to a cell or as individual values.</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph xml-lang="en-US" id="par_id3150625" role="paragraph"> + <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"/> +<h2 id="hd_id3151001">HLOOKUP</h2> + <paragraph xml-lang="en-US" id="par_id3148688" role="paragraph"><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#regex"/> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph xml-lang="en-US" id="par_id3146070" role="code">HLOOKUP(Lookup; Array; Index [; SortedRangeLookup])</paragraph> + <paragraph xml-lang="en-US" id="par_id3148672" role="paragraph">For an explanation on the parameters, see: <link href="text/scalc/01/04060109.xhp#Section9" name="VLOOKUP">VLOOKUP</link> (columns and rows are exchanged)</paragraph> + <embed href="text/scalc/05/empty_cells.xhp#empty_cells"/> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph role="paragraph" id="par_id141612447324913">Suppose we have built a small database table occupying the cell range A1:DO4 and containing basic information about 118 chemical elements. The first column contains the row headings “Element”, “Symbol”, “Atomic Number”, and “Relative Atomic Mass”. Subsequent columns contain the relevant information for each of the elements, ordered left to right by atomic number. For example, cells B1:B4 contain “Hydrogen”, “H”, “1” and “1.008”, while cells DO1:DO4 contain “Oganesson”, “Og”, “118”, and “294”.</paragraph> + <table id="tab_id221612450364379"> + <tablerow> + <tablecell> + <paragraph id="par_id801612978604237" role="tablehead" localize="false"></paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id881612978240743" role="tablehead" localize="false">A</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id271612450364379" role="tablehead" localize="false">B</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id301612450364379" role="tablehead" localize="false">C</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id551612452808535" role="tablehead" localize="false">D</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id251612452859597" role="tablehead" localize="false">...</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id751612450364379" role="tablehead" localize="false">DO</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id421612978935630" role="tablehead" localize="false">1</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id151612978320063" role="tablecontent">Element</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id711612450364379" role="tablecontent">Hydrogen</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id681612450364379" role="tablecontent">Helium</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id531612453345232" role="tablecontent">Lithium</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id951612452954067" role="tablecontent" localize="false">...</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id571612453039430" role="tablecontent">Oganesson</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id331612978936143" role="tablehead" localize="false">2</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id341612978329327" role="tablecontent">Symbol</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id71612453081581" role="tablecontent" localize="false">H</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id791612453096630" role="tablecontent" localize="false">He</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id111612453384301" role="tablecontent" localize="false">Li</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id921612453115601" role="tablecontent" localize="false">...</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id161612453127250" role="tablecontent" localize="false">Og</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id141612978936342" role="tablehead" localize="false">3</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id601612978601591" role="tablecontent">Atomic Number</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id491612453663656" role="tablecontent" localize="false">1</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id501612453736586" role="tablecontent" localize="false">2</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id421612453790984" role="tablecontent" localize="false">3</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id21612453805178" role="tablecontent" localize="false">...</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id961612453816419" role="tablecontent" localize="false">118</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id721612978936518" role="tablehead" localize="false">4</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id751612978603374" role="tablecontent">Relative Atomic Mass</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id771612453688379" role="tablecontent" localize="false">1.008</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id281612453852664" role="tablecontent" localize="false">4.0026</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id431612453888389" role="tablecontent" localize="false">6.94</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id91612453914383" role="tablecontent" localize="false">...</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id461612453928537" role="tablecontent" localize="false">294</paragraph> + </tablecell> + </tablerow> +</table> + <paragraph role="paragraph" id="par_id51612447346319"><input>=HLOOKUP("Lead"; $A$1:$DO$4; 2; 0)</input> returns “Pb”, the symbol for lead.</paragraph> + <paragraph role="paragraph" id="par_id291612447349416"><input>=HLOOKUP("Gold"; $A$1:$DO$4; 3; 0)</input> returns 79, the atomic number for gold.</paragraph> + <paragraph role="paragraph" id="par_id971612447352912"><input>=HLOOKUP("Carbon"; $A$1:$DO$4; 4; 0)</input> returns 12.011, the relative atomic mass of carbon.</paragraph> + </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"/> +<h2 id="hd_id3147321">ROW</h2> + <paragraph xml-lang="en-US" id="par_id3154564" role="paragraph"><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#creating_array_formulas" 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> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph xml-lang="en-US" id="par_id3154916" role="code">ROW([Reference])</paragraph> + <paragraph xml-lang="en-US" id="par_id3156336" role="paragraph"> + <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">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> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph xml-lang="en-US" id="par_id3154830" role="paragraph"> + <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"> + <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"> + <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"> + <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"> + <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"> + <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"/> +<h2 id="hd_id3145772">ROWS</h2> + <paragraph xml-lang="en-US" id="par_id3148971" role="paragraph"><ahelp hid="HID_FUNC_ZEILEN">Returns the number of rows in a reference or array.</ahelp></paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph xml-lang="en-US" id="par_id3154357" role="code">ROWS(Array)</paragraph> + <paragraph xml-lang="en-US" id="par_id3155942" role="paragraph"> + <emph>Array</emph> is the reference or named area whose total number of rows is to be determined.</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph xml-lang="en-US" id="par_id3154725" role="paragraph"> + <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"> + <item type="input">=ROWS(A10:B12)</item> returns 3.</paragraph> + <paragraph xml-lang="en-US" id="par_id3155143" role="paragraph"> + <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> +<h2 id="par_idN11798">HYPERLINK</h2> + <paragraph xml-lang="en-US" id="par_idN117F1" role="paragraph"><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">If you use the optional <emph>CellValue</emph> parameter, the formula locates the URL, and then displays the text or number.</paragraph> + <tip id="par_idN11803">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>.</tip> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph xml-lang="en-US" id="par_idN1180E" role="code">HYPERLINK("URL" [; CellValue])</paragraph> + <paragraph xml-lang="en-US" id="par_idN11811" role="paragraph"> + <emph>URL</emph> specifies the link target. The optional <emph>CellValue</emph> parameter is the text or a number that is displayed in the cell and will be returned as the result. If the <emph>CellValue</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">The number 0 is returned for empty cells and matrix elements.</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph xml-lang="en-US" id="par_idN11827" role="paragraph"> + <input>=HYPERLINK("http://www.example.org")</input> 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"> + <input>=HYPERLINK("http://www.example.org";"Click here")</input> 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"> + <input>=HYPERLINK("http://www.example.org";12345)</input> 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"> + <input>=HYPERLINK($B4)</input> where cell B4 contains <literal>http://www.example.org</literal>. 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"> + <input>=HYPERLINK("http://www.";"Click ") & "example.org"</input> 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"> + <input>=HYPERLINK("#Sheet1.A1";"Go to top")</input> 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"> + <input>=HYPERLINK("file:///C:/writer.odt#Specification";"Go to Writer bookmark")</input> displays the text "Go to Writer bookmark", loads the specified text document and jumps to bookmark "Specification".</paragraph> + <paragraph xml-lang="en-US" role="paragraph" id="par_id321615667588042"> + <input>=HYPERLINK("file:///C:/Documents/";"Open Documents folder")</input> displays the text "Open Documents folder" and shows the folder contents using the standard file manager in your operating system.</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"/> +<h2 id="hd_id3747062">GETPIVOTDATA</h2> + <paragraph xml-lang="en-US" id="par_id3593859" role="paragraph"><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> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph xml-lang="en-US" id="par_id909451" role="paragraph">Two different syntax definitions can be used:</paragraph> + <paragraph xml-lang="en-US" id="par_id1665089" role="code">GETPIVOTDATA(TargetField; pivot table[; Field 1; Item 1][; ... [Field 126; Item 126]])</paragraph> + <paragraph id="par_id661585662472832" role="paragraph" xml-lang="en-US">or</paragraph> + <paragraph xml-lang="en-US" id="par_id4997100" role="code">GETPIVOTDATA(pivot table; Constraints)</paragraph> + <paragraph xml-lang="en-US" id="par_id1672109" role="paragraph">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> + <h3 id="hd_id431585688827982">First Syntax</h3> + <paragraph xml-lang="en-US" id="par_id9302346" role="paragraph"> + <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"> + <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">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">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">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">If no constraint for a filter is given, the field's selected value is implicitly used. If a constraint for a filter is given, it must match the field's selected value, or an error is returned. Filters are the fields at the top left of a pivot table, populated using the "Filters" area of the pivot table layout dialog. From each filter, 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">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> + <h3 id="hd_id551585688835597">Second Syntax</h3> + <paragraph xml-lang="en-US" id="par_id9937131" role="paragraph"><emph>pivot table</emph> has the same meaning as in the first syntax.</paragraph> + <paragraph xml-lang="en-US" id="par_id5616626" role="paragraph"><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">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">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">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/helpcontent2/source/text/scalc/01/04060110.xhp b/helpcontent2/source/text/scalc/01/04060110.xhp new file mode 100644 index 000000000..d4a9c0016 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/04060110.xhp @@ -0,0 +1,759 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . +--> + +<meta> + <topic id="textscalc0104060110xml" indexer="include"> + <title id="tit" xml-lang="en-US">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> + + +<h1 id="hd_id3145389"><variable id="head_text"><link href="text/scalc/01/04060110.xhp" name="Text Functions">Text Functions</link></variable></h1> +<paragraph id="par_id3152986" role="paragraph" xml-lang="en-US"><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> + +<section id="double_quotation_marks_in_formulas"> +<bookmark xml-lang="en-US" branch="index" id="bm_id331624453577057"> + <bookmark_value>using double quotation marks in formulas</bookmark_value> + <bookmark_value>formulas; using double quotation marks</bookmark_value> +</bookmark> + +<h2 id="hd_id291624454173529">Using double quotation marks in formulas</h2> + +<paragraph role="paragraph" id="par_id891624454058773">To include a text string in a formula, place the text string between two double quotation marks (") and Calc takes the characters in the string without attempting to interpret them. For example, the formula <input>="Hello world!"</input> displays the text string <literal>Hello world!</literal> in the cell, with no surrounding double quotation marks.</paragraph> + +<paragraph role="paragraph" id="par_id461624454425320">The more complex formula <input>=CONCATENATE("Life is really simple, "; "but we insist on making it complicated "; "(Confucius).")</input> concatenates three individual strings in double quotation marks, outputting <literal>Life is really simple, but we insist on making it complicated (Confucius).</literal></paragraph> + +<paragraph role="paragraph" id="par_id711624454477483">To place a literal double quotation mark within a string inside a formula, two methods can be used:</paragraph> + +<list type="ordered"> + <listitem> + <paragraph id="par_id541624454496424" role="listitem">You can "escape" the double quotation mark with an additional double quotation mark, and Calc treats the escaped double quotation mark as a literal value. For example, the formula <input>="My name is ""John Doe""."</input> outputs the string <literal>My name is "John Doe".</literal> Another simple example is the formula <input>=UNICODE("""")</input> which returns <literal>34</literal>, the decimal value of the Unicode quotation mark character (U+0022) — here the first and fourth double quotation marks indicate the beginning and end of the string, while the second double quotation mark escapes the third.</paragraph> + </listitem> + <listitem> + <paragraph id="par_id21624454513641" role="listitem">You can use the CHAR function or the UNICHAR function to insert a double quotation mark. For example, the formula <input>=UNICHAR(34) & "The Catcher in the Rye" & UNICHAR(34) & " is a famous book by J. D. Salinger."</input> displays the string <literal>"The Catcher in the Rye" is a famous book by J. D. Salinger.</literal></paragraph> + </listitem> +</list> + +<paragraph role="paragraph" id="par_id401624454547945">Beware that Calc's AutoCorrect function may modify double quotation marks. AutoCorrect should not change the double quotation marks within formula cells but may change those used in non-formula cells containing text. For example, if you copy a string that is surrounded by some other form of typographical double quotation marks, such as the left double quotation mark (U+201C) and the right double quotation mark (U+201D), and then paste into a formula cell, an error may result. Open the <emph>Double Quotes</emph> area of the <menuitem>Tools - AutoCorrect Options - Localized Options</menuitem> dialog to set the characters used to automatically correct the start and end typographical double quotation marks. Uncheck the <menuitem>Replace</menuitem> toggle button to disable the feature.</paragraph> + +</section> + +<sort order="asc" descendant="h2"> + +<section id="arabic"> + <embed href="text/scalc/01/func_arabic.xhp#func_arabic"/> +</section> + +<section id="asc"> + <embed href="text/scalc/01/func_asc.xhp#func_asc"/> +</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> +<h2 id="hd_id6695455">BAHTTEXT</h2> +<paragraph id="par_id354014" role="paragraph" xml-lang="en-US">Converts a number to Thai text, including the Thai currency names.</paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id8780785" role="code" xml-lang="en-US">BAHTTEXT(Number)</paragraph> +<paragraph id="par_id1539353" role="paragraph" xml-lang="en-US"> <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> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3289284" role="paragraph" xml-lang="en-US"> <item type="input">=BAHTTEXT(12.65)</item> returns a string in Thai characters with the meaning of "Twelve Baht and sixty five Satang".</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectiontechinfo"/> + <embed href="text/scalc/01/common_func.xhp#notODFF"/> + <paragraph role="paragraph" id="par_id341640873986703" localize="false"><literal>COM.MICROSOFT.BAHTTEXT</literal></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"/> +<bookmark xml-lang="en-US" branch="index" id="bm_id3156399"> + <bookmark_value>decimal system; converting to</bookmark_value> +</bookmark> +<h2 id="hd_id3153072">BASE</h2> +<paragraph id="par_id3153289" role="paragraph" xml-lang="en-US"><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#number_system" name="numbering system">numbering system</link>.</ahelp> The digits 0-9 and the letters A-Z are used.</paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3155743" role="code" xml-lang="en-US">BASE(Number; Radix [; MinimumLength])</paragraph> +<paragraph id="par_id3151339" role="paragraph" xml-lang="en-US"> <emph>Number</emph> is the positive integer to be converted.</paragraph> +<paragraph id="par_id3159262" role="paragraph" xml-lang="en-US"> <emph>Radix</emph> indicates the base of the numeral system. It may be any positive integer between 2 and 36.</paragraph> +<paragraph id="par_id3148746" role="paragraph" xml-lang="en-US"> <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> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3156399" role="paragraph" xml-lang="en-US"> <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 id="par_id3157871" role="paragraph" xml-lang="en-US"> <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 id="par_id3145226" role="paragraph" xml-lang="en-US"> <item type="input">=BASE(255;16;4)</item> returns 00FF in the hexadecimal system.</paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionseealso"/> +<paragraph role="paragraph" id="par_id991655560817321"><link href="text/scalc/01/04060110.xhp#decimal" name="decimal">DECIMAL</link></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"/> + +<h2 id="hd_id3149321">CHAR</h2> +<paragraph id="par_id3149150" role="paragraph" xml-lang="en-US"><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"/> + +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3145634" role="code" xml-lang="en-US">CHAR(Number)</paragraph> +<paragraph id="par_id3155906" role="paragraph" xml-lang="en-US"> <emph>Number</emph> is a number between 1 and 255 representing the code value for the character.</paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3149890" role="paragraph" xml-lang="en-US"> <item type="input">=CHAR(100)</item> returns the character d.</paragraph> +<paragraph id="par_id0907200910283297" role="paragraph" xml-lang="en-US">="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"/> + +<h2 id="hd_id3149009">CLEAN</h2> +<paragraph id="par_id3150482" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_SAEUBERN">All non-printing characters are removed from the string.</ahelp></paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3147472" role="code" xml-lang="en-US">CLEAN("Text")</paragraph> +<paragraph id="par_id3150695" role="paragraph" xml-lang="en-US"> <emph>Text</emph> refers to the text from which to remove all non-printable characters.</paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph role="paragraph" id="par_id581621538151600"><input>=LEN(CLEAN(CHAR(7) & "LibreOffice Calc" & CHAR(8)))</input> returns 16, showing that the CLEAN function removes the non-printable Unicode U+0007 ("BEL") and U+0008 ("BS") characters at the beginning and end of the string argument. CLEAN does not remove spaces.</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"/> + +<h2 id="hd_id3155498">CODE</h2> +<paragraph id="par_id3152770" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_CODE">Returns a numeric code for the first character in a text string.</ahelp></paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3149188" role="code" xml-lang="en-US">CODE("Text")</paragraph> +<paragraph id="par_id3154383" role="paragraph" xml-lang="en-US"> <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"/> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3159209" role="paragraph" xml-lang="en-US"> <item type="input">=CODE("Hieronymus")</item> returns 72, <item type="input">=CODE("hieroglyphic")</item> returns 104.</paragraph> +<note id="par_id3150280">The code used here does not refer to ASCII, but to the code table currently loaded.</note> +</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"/> +<h2 id="hd_id3149688">CONCATENATE</h2> +<paragraph id="par_id3154524" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_VERKETTEN">Combines several text strings into one string.</ahelp></paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3155954" role="code" xml-lang="en-US">CONCATENATE(<embedvar href="text/scalc/01/ful_func.xhp#string255_1" markup="keep"/>)</paragraph> +<paragraph role="paragraph" id="par_id781585222554150"><emph>String 1[; String 2][; … ;[String 255]]</emph> are strings or references to cells containing strings.</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3150008" role="paragraph" xml-lang="en-US"> <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"/> + +<h2 id="hd_id3145166">DECIMAL</h2> +<paragraph id="par_id3156361" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_DEZIMAL">Converts text that represents a number in a <link href="text/shared/00/00000005.xhp#number_system" name="numeral system">numeral system</link> with the given base radix to a positive integer.</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 id="par_id3157994" role="paragraph" xml-lang="en-US">If the radix is 16, a leading x or X or 0x or 0X, and an appended h or H, are disregarded. If the radix is 2, an appended b or B is disregarded. Other characters that do not belong to the numeral system generate an error.</paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3154328" role="code" xml-lang="en-US">DECIMAL("Text"; Radix)</paragraph> +<paragraph id="par_id3150128" role="paragraph" xml-lang="en-US"> <emph>Text</emph> is the text to be converted.</paragraph> +<paragraph id="par_id3145241" role="paragraph" xml-lang="en-US"> <emph>Radix</emph> indicates the base of the numeral system. It may be any positive integer between 2 and 36.</paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3145355" role="paragraph" xml-lang="en-US"> <item type="input">=DECIMAL("17";10)</item> returns 17.</paragraph> +<paragraph id="par_id3155622" role="paragraph" xml-lang="en-US"> <item type="input">=DECIMAL("FACE";16)</item> returns 64206.</paragraph> +<paragraph id="par_id3151015" role="paragraph" xml-lang="en-US"> <item type="input">=DECIMAL("0101";2)</item> returns 5.</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionseealso"/> +<paragraph role="paragraph" id="par_id421655560837244"><link href="text/scalc/01/04060110.xhp#base" name="base">BASE</link></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"/> + +<h2 id="hd_id3148402">DOLLAR</h2> +<paragraph id="par_id3153049" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_DM">Converts a number to a string representing the amount in the currency format, rounded to a specified decimal places, using the decimal separator that corresponds to the <link href="text/shared/optionen/01140000.xhp" name="current locale setting">current locale setting</link>.</ahelp> In the <item type="literal">Value</item> field enter the number to be converted. 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 id="par_id3151280" role="paragraph" xml-lang="en-US">You set the currency format in your system settings.</paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3154188" role="code" xml-lang="en-US">DOLLAR(Value [; Decimals])</paragraph> +<paragraph id="par_id3145299" role="paragraph" xml-lang="en-US"> <emph>Value</emph> is a number, a reference to a cell containing a number, or a formula which returns a number.</paragraph> +<paragraph id="par_id3145629" role="paragraph" xml-lang="en-US"> <emph>Decimals</emph> is the optional number of decimal places.</paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3153546" role="paragraph" xml-lang="en-US"> <item type="input">=DOLLAR(255)</item> returns $255.00 for the English (USA) locale and USD (dollar) currency; ¥255.00 for the Japanese locale and JPY (yen) currency; or 255,00 € for the German (Germany) locale and EUR (euro) currency.</paragraph> +<paragraph id="par_id3154635" role="paragraph" xml-lang="en-US"> <item type="input">=DOLLAR(367.456;2)</item> returns $367.46.</paragraph> +</section> + +<section id="exact"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3150685"> + <bookmark_value>EXACT function</bookmark_value> +</bookmark> + +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_IDENTISCH" id="bm_id3155081" localize="false"/> + +<h2 id="hd_id3150685">EXACT</h2> +<paragraph id="par_id3158413" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_IDENTISCH">Compares two text strings and returns TRUE if they are identical.</ahelp> This function is case-sensitive.</paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3148594" role="code" xml-lang="en-US">EXACT("Text1"; "Text2")</paragraph> +<paragraph id="par_id3153224" role="paragraph" xml-lang="en-US"> <emph>Text1</emph> refers to the first text to compare.</paragraph> +<paragraph id="par_id3148637" role="paragraph" xml-lang="en-US"> <emph>Text2</emph> is the second text to compare.</paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3156263" role="paragraph" xml-lang="en-US"> <item type="input">=EXACT("microsystems";"Microsystems")</item> returns FALSE.</paragraph> +</section> + +<section id="find"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3152589"> + <bookmark_value>FIND function</bookmark_value> +</bookmark> + +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_FINDEN" id="bm_id3147482" localize="false"/> + +<h2 id="hd_id3152589">FIND</h2> +<paragraph id="par_id3146149" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_FINDEN">Returns the position of a string of text within another string.</ahelp>You can also define where to begin the search. The search term can be a number or any string of characters. The search is case-sensitive.</paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3083452" role="code" xml-lang="en-US">FIND("FindText"; "Text" [; Position])</paragraph> +<paragraph id="par_id3150608" role="paragraph" xml-lang="en-US"> <emph>FindText</emph> refers to the text to be found.</paragraph> +<paragraph id="par_id3152374" role="paragraph" xml-lang="en-US"> <emph>Text</emph> is the text where the search takes place.</paragraph> +<paragraph id="par_id3152475" role="paragraph" xml-lang="en-US"> <emph>Position</emph> (optional) is the position in the text from which the search starts.</paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3156375" role="paragraph" xml-lang="en-US"> <item type="input">=FIND(76;998877665544)</item> returns 6.</paragraph> +</section> + +<section id="fixed"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3149268"> + <bookmark_value>FIXED function</bookmark_value> +</bookmark> + +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_FEST" id="bm_id3149450" localize="false"/> + +<h2 id="hd_id3149268">FIXED</h2> +<paragraph role="paragraph" id="par_id641617285271044" xml-lang="en-US"><ahelp hid="HID_FUNC_FEST">Returns a number as text with a specified number of decimal places and optional thousands separators.</ahelp></paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3147567" role="code" xml-lang="en-US">FIXED(Number; [Decimals = 2 [; NoThousandsSeparators = FALSE]])</paragraph> + +<paragraph id="par_id3151272" role="paragraph" xml-lang="en-US"> <emph>Number</emph> is rounded to <literal>Decimals</literal> places (after the decimal separator) and the result formatted as text, using <link href="text/shared/optionen/01140000.xhp" name="current locale setting">locale-specific settings</link>.</paragraph> +<paragraph id="par_id3156322" role="paragraph" xml-lang="en-US"> <emph>Decimals</emph> (optional) refers to the number of decimal places to be displayed. If <literal>Decimals</literal> is negative, <literal>Number</literal> is rounded to ABS(<literal>Decimals</literal>) places to the left from the decimal point. If <literal>Decimals</literal> is a fraction, it is truncated actually ignoring what is the closest integer.</paragraph> +<paragraph id="par_id3150877" role="paragraph" xml-lang="en-US"> <emph>NoThousandsSeparators</emph> (optional) determines whether the thousands separator is used. If it is <literal>TRUE</literal> or non-zero, then group separators are omitted from the resulting string. If the parameter is equal to 0 or if it is missing altogether, the thousands separators of your <link href="text/shared/optionen/01140000.xhp" name="current locale setting">current locale setting</link> are displayed.</paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3145208" role="paragraph" xml-lang="en-US"> <item type="input">=FIXED(1234567.89;3)</item> returns 1,234,567.890 as a text string. </paragraph> +<paragraph id="par_id5282143" role="paragraph" xml-lang="en-US"> <item type="input">=FIXED(123456.789;;TRUE)</item> returns 123456.79 as a text string.</paragraph> +<paragraph role="paragraph" id="par_id21617202293406" xml-lang="en-US"> <item type="input">=FIXED(12345.6789;-2)</item> returns 12,300 as a text string.</paragraph> +<paragraph role="paragraph" id="par_id161617202295558" xml-lang="en-US"> <item type="input">=FIXED(12134567.89;-3;1)</item> returns 12135000 as a text string.</paragraph> +<paragraph role="paragraph" id="par_id451617286696878" xml-lang="en-US"> <item type="input">=FIXED(12345.789;3/4)</item> returns 12,346 as a text string.</paragraph> +<paragraph role="paragraph" id="par_id371617286698199" xml-lang="en-US"> <item type="input">=FIXED(12345.789;8/5)</item> returns 12,345.8 as a text string.</paragraph> +</section> + +<section id="jis"> + <embed href="text/scalc/01/func_jis.xhp#func_jis"/> +</section> + +<section id="left"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3147083"> + <bookmark_value>LEFT function</bookmark_value> +</bookmark> + +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_LINKS" id="bm_id3154645" localize="false"/> + +<h2 id="hd_id3147083">LEFT</h2> +<paragraph id="par_id3153622" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_LINKS">Returns the first character or characters of a text.</ahelp></paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3146786" role="code" xml-lang="en-US">LEFT("Text" [; Number])</paragraph> +<paragraph id="par_id3147274" role="paragraph" xml-lang="en-US"> <emph>Text</emph> is the text where the initial partial words are to be determined.</paragraph> +<paragraph id="par_id3153152" role="paragraph" xml-lang="en-US"> <emph>Number</emph> (optional) specifies the number of characters for the start text. If this parameter is not defined, one character is returned.</paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3149141" role="paragraph" xml-lang="en-US"> <item type="input">=LEFT("output";3)</item> returns “out”.</paragraph> +</section> + +<section id="leftb"> +<bookmark xml-lang="en-US" branch="index" id="bm_id2947083"> + <bookmark_value>LEFTB function</bookmark_value> +</bookmark> + +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_LEFTB" id="bm_id2954645" localize="false"/> + +<h2 id="hd_id2947083"><variable id="leftbvar"><link href="text/scalc/01/04060110.xhp#leftb" name="LEFTB">LEFTB</link></variable></h2> +<paragraph id="par_id2953622" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_LEFTB">Returns the first characters of a DBCS text.</ahelp></paragraph> +<embed href="text/scalc/00/avail_release.xhp#4.2"/> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id2946786" role="code" xml-lang="en-US">LEFTB("Text" [; Number_bytes])</paragraph> +<paragraph id="par_id2947274" role="paragraph" xml-lang="en-US"><emph>Text</emph> is the text where the initial partial words are to be determined.</paragraph> +<paragraph id="par_id2953152" role="paragraph" xml-lang="en-US"><emph>Number_bytes</emph> (optional) specifies the number of characters you want LEFTB to extract, based on bytes. If this parameter is not defined, one character is returned.</paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id2949141" role="paragraph" xml-lang="en-US"><item type="input">=LEFTB("中国";1)</item> returns " " (1 byte is only half a DBCS character and a space character is returned instead).</paragraph> +<paragraph id="par_id2949151" role="paragraph" xml-lang="en-US"><item type="input">=LEFTB("中国";2)</item> returns "中" (2 bytes constitute one complete DBCS character).</paragraph> +<paragraph id="par_id2949161" role="paragraph" xml-lang="en-US"><item type="input">=LEFTB("中国";3)</item> returns "中 " (3 bytes constitute one DBCS character and a half; the last character returned is therefore a space character).</paragraph> +<paragraph id="par_id2949171" role="paragraph" xml-lang="en-US"><item type="input">=LEFTB("中国";4)</item> returns "中国" (4 bytes constitute two complete DBCS characters).</paragraph> +<paragraph id="par_id2949181" role="paragraph" xml-lang="en-US"><item type="input">=LEFTB("office";3)</item> returns "off" (3 non-DBCS characters each consisting of 1 byte).</paragraph> +</section> + +<section id="len"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3156110"> + <bookmark_value>LEN function</bookmark_value> +</bookmark> + +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_LAENGE" id="bm_id3154050" localize="false"/> + +<h2 id="hd_id3156110">LEN</h2> +<paragraph id="par_id3150147" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_LAENGE">Returns the length of a string including spaces.</ahelp></paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3154063" role="code" xml-lang="en-US">LEN("Text")</paragraph> +<paragraph id="par_id3146894" role="paragraph" xml-lang="en-US"> <emph>Text</emph> is the text whose length is to be determined.</paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3156008" role="paragraph" xml-lang="en-US"> <item type="input">=LEN("Good Afternoon")</item> returns 14.</paragraph> +<paragraph id="par_id3154300" role="paragraph" xml-lang="en-US"> <item type="input">=LEN(12345.67)</item> returns 8.</paragraph> +</section> + +<section id="lenb"> +<bookmark xml-lang="en-US" branch="index" id="bm_id2956110"> + <bookmark_value>LENB function</bookmark_value> +</bookmark> + +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_LENB" id="bm_id2954050" localize="false"/> + +<h2 id="hd_id2956110"><variable id="lenbvar"><link href="text/scalc/01/04060110.xhp#lenb" name="LENB">LENB</link></variable></h2> +<paragraph id="par_id2950147" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_LENB">For double-byte character set (DBCS) languages, returns the number of bytes used to represent the characters in a text string.</ahelp></paragraph> +<embed href="text/scalc/00/avail_release.xhp#4.2"/> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id2954063" role="code" xml-lang="en-US">LENB("Text")</paragraph> +<paragraph id="par_id2946894" role="paragraph" xml-lang="en-US"><emph>Text</emph> is the text whose length is to be determined.</paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id2956018" role="paragraph" xml-lang="en-US"><item type="input">LENB("中")</item> returns 2 (1 DBCS character consisting of 2 bytes).</paragraph> +<paragraph id="par_id2956028" role="paragraph" xml-lang="en-US"><item type="input">LENB("中国")</item> returns 4 (2 DBCS characters each consisting of 2 bytes).</paragraph> +<paragraph id="par_id2956038" role="paragraph" xml-lang="en-US"><item type="input">LENB("office")</item> returns 6 (6 non-DBCS characters each consisting of 1 byte).</paragraph> +<paragraph id="par_id2956008" role="paragraph" xml-lang="en-US"> <item type="input">=LENB("Good Afternoon")</item> returns 14.</paragraph> +<paragraph id="par_id2954300" role="paragraph" xml-lang="en-US"> <item type="input">=LENB(12345.67)</item> returns 8.</paragraph> +</section> + +<section id="lower"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3153983"> + <bookmark_value>LOWER function</bookmark_value> +</bookmark> + +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_KLEIN" id="bm_id3151173" localize="false"/> + +<h2 id="hd_id3153983">LOWER</h2> +<paragraph id="par_id3152791" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_KLEIN">Converts all uppercase letters in a text string to lowercase.</ahelp></paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3150121" role="code" xml-lang="en-US">LOWER("Text")</paragraph> +<paragraph id="par_id3153910" role="paragraph" xml-lang="en-US"> <emph>Text</emph> refers to the text to be converted.</paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3155329" role="paragraph" xml-lang="en-US"> <item type="input">=LOWER("Sun")</item> returns sun.</paragraph> +</section> + +<section id="mid"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3154589"> + <bookmark_value>MID function</bookmark_value> +</bookmark> + +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_TEIL" id="bm_id3155392" localize="false"/> + +<h2 id="hd_id3154589">MID</h2> +<paragraph id="par_id3154938" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_TEIL">Returns a text string of a text. The parameters specify the starting position and the number of characters.</ahelp></paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3150526" role="code" xml-lang="en-US">MID("Text"; Start; Number)</paragraph> +<paragraph id="par_id3148820" role="paragraph" xml-lang="en-US"> <emph>Text</emph> is the text containing the characters to extract.</paragraph> +<paragraph id="par_id3150774" role="paragraph" xml-lang="en-US"> <emph>Start</emph> is the position of the first character in the text to extract.</paragraph> +<paragraph id="par_id3153063" role="paragraph" xml-lang="en-US"> <emph>Number</emph> specifies the number of characters in the part of the text.</paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3158407" role="paragraph" xml-lang="en-US"> <item type="input">=MID("office";2;2)</item> returns ff.</paragraph> +</section> + +<section id="midb"> +<bookmark xml-lang="en-US" branch="index" id="bm_id2954589"> + <bookmark_value>MIDB function</bookmark_value> +</bookmark> + +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_MIDB" id="bm_id2955392" localize="false"/> + +<h2 id="hd_id2954589"><variable id="midbvar"><link href="text/scalc/01/04060110.xhp#midb" name="MIDB">MIDB</link></variable></h2> +<paragraph id="par_id2954938" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_MIDB">Returns a text string of a DBCS text. The parameters specify the starting position and the number of characters.</ahelp></paragraph> +<embed href="text/scalc/00/avail_release.xhp#4.2"/> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id2950526" role="code" xml-lang="en-US">MIDB("Text"; Start; Number_bytes)</paragraph> +<paragraph id="par_id2948820" role="paragraph" xml-lang="en-US"><emph>Text</emph> is the text containing the characters to extract.</paragraph> +<paragraph id="par_id2950774" role="paragraph" xml-lang="en-US"><emph>Start</emph> is the position of the first character in the text to extract.</paragraph> +<paragraph id="par_id2953063" role="paragraph" xml-lang="en-US"><emph>Number_bytes</emph> specifies the number of characters MIDB will return from text, in bytes.</paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id2958417" role="paragraph" xml-lang="en-US"><item type="input">=MIDB("中国";1;0)</item> returns "" (0 bytes is always an empty string).</paragraph> +<paragraph id="par_id2958427" role="paragraph" xml-lang="en-US"><item type="input">=MIDB("中国";1;1)</item> returns " " (1 byte is only half a DBCS character and therefore the result is a space character).</paragraph> +<paragraph id="par_id2958437" role="paragraph" xml-lang="en-US"><item type="input">=MIDB("中国";1;2)</item> returns "中" (2 bytes constitute one complete DBCS character).</paragraph> +<paragraph id="par_id2958447" role="paragraph" xml-lang="en-US"><item type="input">=MIDB("中国";1;3)</item> returns "中 " (3 bytes constitute one and a half DBCS character; the last byte results in a space character).</paragraph> +<paragraph id="par_id2958457" role="paragraph" xml-lang="en-US"><item type="input">=MIDB("中国";1;4)</item> returns "中国" (4 bytes constitute two complete DBCS characters).</paragraph> +<paragraph id="par_id2958467" role="paragraph" xml-lang="en-US"><item type="input">=MIDB("中国";2;1)</item> returns " " (byte position 2 is not at the beginning of a character in a DBCS string; 1 space character is returned).</paragraph> +<paragraph id="par_id2958477" role="paragraph" xml-lang="en-US"><item type="input">=MIDB("中国";2;2)</item> returns " " (byte position 2 points to the last half of the first character in the DBCS string; the 2 bytes asked for therefore constitutes the last half of the first character and the first half of the second character in the string; 2 space characters are therefore returned).</paragraph> +<paragraph id="par_id2958487" role="paragraph" xml-lang="en-US"><item type="input">=MIDB("中国";2;3)</item> returns " 国" (byte position 2 is not at the beginning of a character in a DBCS string; a space character is returned for byte position 2).</paragraph> +<paragraph id="par_id2958497" role="paragraph" xml-lang="en-US"><item type="input">=MIDB("中国";3;1)</item> returns " " (byte position 3 is at the beginning of a character in a DBCS string, but 1 byte is only half a DBCS character and a space character is therefore returned instead).</paragraph> +<paragraph id="par_id2958507" role="paragraph" xml-lang="en-US"><item type="input">=MIDB("中国";3;2)</item> returns "国" (byte position 3 is at the beginning of a character in a DBCS string, and 2 bytes constitute one DBCS character).</paragraph> +<paragraph id="par_id2958517" role="paragraph" xml-lang="en-US"><item type="input">=MIDB("office";2;3)</item> returns "ffi" (byte position 2 is at the beginning of a character in a non-DBCS string, and 3 bytes of a non-DBCS string constitute 3 characters).</paragraph> +</section> + +<section id="proper"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3159143"> + <bookmark_value>PROPER function</bookmark_value> +</bookmark> + +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_GROSS2" id="bm_id3154897" localize="false"/> + +<h2 id="hd_id3159143">PROPER</h2> +<paragraph id="par_id3149768" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_GROSS2">Capitalizes the first letter in all words of a text string.</ahelp></paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3154260" role="code" xml-lang="en-US">PROPER("Text")</paragraph> +<paragraph id="par_id3147509" role="paragraph" xml-lang="en-US"> <emph>Text</emph> refers to the text to be converted.</paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3155364" role="paragraph" xml-lang="en-US"> <item type="input">=PROPER("the document foundation")</item> returns The Document Foundation.</paragraph> +</section> + +<section id="regex"> +<embed href="text/scalc/01/func_regex.xhp#func_regex"/> +</section> + +<section id="replace"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3149171"> + <bookmark_value>REPLACE function</bookmark_value> +</bookmark> + +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_ERSETZEN" id="bm_id3149990" localize="false"/> + +<h2 id="hd_id3149171">REPLACE</h2> +<paragraph id="par_id3148925" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_ERSETZEN">Replaces part of a text string with a different text string.</ahelp> This function can be used to replace both characters and numbers (which are automatically converted to text). The result of the function is always displayed as text. If you intend to perform further calculations with a number which has been replaced by text, you will need to convert it back to a number using the <link href="text/scalc/01/04060110.xhp" name="VALUE">VALUE</link> function.</paragraph> +<paragraph id="par_id3158426" role="paragraph" xml-lang="en-US">Any text containing numbers must be enclosed in quotation marks if you do not want it to be interpreted as a number and automatically converted to text.</paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3147286" role="code" xml-lang="en-US">REPLACE("Text"; Position; Length; "NewText")</paragraph> +<paragraph id="par_id3149797" role="paragraph" xml-lang="en-US"> <emph>Text</emph> refers to text of which a part will be replaced.</paragraph> +<paragraph id="par_id3166451" role="paragraph" xml-lang="en-US"> <emph>Position</emph> refers to the position within the text where the replacement will begin.</paragraph> +<paragraph id="par_id3156040" role="paragraph" xml-lang="en-US"> <emph>Length</emph> is the number of characters in <emph>Text</emph> to be replaced.</paragraph> +<paragraph id="par_id3159188" role="paragraph" xml-lang="en-US"> <emph>NewText</emph> refers to the text which replaces <emph>Text</emph>.</paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3154096" role="paragraph" xml-lang="en-US"> <item type="input">=REPLACE("1234567";1;1;"444")</item> returns "444234567". One character at position 1 is replaced by the complete <item type="literal">NewText</item>.</paragraph> +</section> + +<section id="rept"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3149741"> + <bookmark_value>REPT function</bookmark_value> +</bookmark> + +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_WIEDERHOLEN" id="bm_id3155582" localize="false"/> + +<h2 id="hd_id3149741">REPT</h2> +<paragraph id="par_id3153748" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_WIEDERHOLEN">Repeats a character string by the given <emph>number</emph> of copies.</ahelp></paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3150494" role="code" xml-lang="en-US">REPT("Text"; Number)</paragraph> +<paragraph id="par_id3154859" role="paragraph" xml-lang="en-US"> <emph>Text</emph> is the text to be repeated.</paragraph> +<paragraph id="par_id3150638" role="paragraph" xml-lang="en-US"> <emph>Number</emph> is the number of repetitions.</paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3148626" role="paragraph" xml-lang="en-US"> <item type="input">=REPT("Good morning";2)</item> returns Good morningGood morning.</paragraph> + +<tip id="par_id381626381556310">Refer to the <link href="https://wiki.documentfoundation.org/Documentation/Calc_Functions/REPT" name="REPT_Wiki">REPT</link> wiki page for more details about this function.</tip></section> + +<section id="right"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3149805"> + <bookmark_value>RIGHT function</bookmark_value> +</bookmark> + +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_RECHTS" id="bm_id3154602" localize="false"/> + +<h2 id="hd_id3149805">RIGHT</h2> +<paragraph id="par_id3145375" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_RECHTS">Returns the last character or characters of a text.</ahelp></paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3154344" role="code" xml-lang="en-US">RIGHT("Text" [; Number])</paragraph> +<paragraph id="par_id3149426" role="paragraph" xml-lang="en-US"> <emph>Text</emph> is the text of which the right part is to be determined.</paragraph> +<paragraph id="par_id3153350" role="paragraph" xml-lang="en-US"> <emph>Number</emph> (optional) is the number of characters from the right part of the text. If this parameter is not defined, one character is returned.</paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3151132" role="paragraph" xml-lang="en-US"> <item type="input">=RIGHT("Sun";2)</item> returns un.</paragraph> +</section> + +<section id="rightb"> +<bookmark xml-lang="en-US" branch="index" id="bm_id2949805"> + <bookmark_value>RIGHTB function</bookmark_value> +</bookmark> + +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_RIGHTB" id="bm_id2954602" localize="false"/> + +<h2 id="hd_id2949805"><variable id="rightbvar"><link href="text/scalc/01/04060110.xhp#rightb" name="RIGHTB">RIGHTB</link></variable></h2> +<paragraph id="par_id2945375" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_RIGHTB">Returns the last character or characters of a text with double bytes characters sets (DBCS).</ahelp></paragraph> +<embed href="text/scalc/00/avail_release.xhp#4.2"/> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id2954344" role="code" xml-lang="en-US">RIGHTB("Text" [; Number_bytes])</paragraph> +<paragraph id="par_id2949426" role="paragraph" xml-lang="en-US"><emph>Text</emph> is the text of which the right part is to be determined.</paragraph> +<paragraph id="par_id2953350" role="paragraph" xml-lang="en-US"><emph>Number_bytes</emph> (optional) specifies the number of characters you want RIGHTB to extract, based on bytes. If this parameter is not defined, one byte is returned.</paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id2951132" role="paragraph" xml-lang="en-US"><item type="input">RIGHTB("中国";1)</item> returns " " (1 byte is only half a DBCS character and a space character is returned instead).</paragraph> +<paragraph id="par_id2951142" role="paragraph" xml-lang="en-US"><item type="input">RIGHTB("中国";2)</item> returns "国" (2 bytes constitute one complete DBCS character).</paragraph> +<paragraph id="par_id2951152" role="paragraph" xml-lang="en-US"><item type="input">RIGHTB("中国";3)</item> returns " 国" (3 bytes constitute one half DBCS character and one whole DBCS character; a space is returned for the first half).</paragraph> +<paragraph id="par_id2951162" role="paragraph" xml-lang="en-US"><item type="input">RIGHTB("中国";4)</item> returns "中国" (4 bytes constitute two complete DBCS characters).</paragraph> +<paragraph id="par_id2951172" role="paragraph" xml-lang="en-US"><item type="input">RIGHTB("office";3)</item> returns "ice" (3 non-DBCS characters each consisting of 1 byte).</paragraph> +</section> + +<section id="roman"> + <embed href="text/scalc/01/func_roman.xhp#func_roman"/> +</section> + +<section id="search"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3151005"> + <bookmark_value>SEARCH function</bookmark_value> +</bookmark> + +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_SUCHEN" id="bm_id3149484" localize="false"/> + +<h2 id="hd_id3151005">SEARCH</h2> +<paragraph id="par_id3148692" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_SUCHEN">Returns the position of a text segment within a character string.</ahelp> You can set the start of the search as an option. The search text can be a number or any sequence of characters. The search is not case-sensitive. If the text is not found, returns error 519 (#VALUE).</paragraph> +<embed href="text/shared/00/00000001.xhp#regex"/> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3154671" role="code" xml-lang="en-US">SEARCH("FindText"; "Text" [; Position])</paragraph> +<paragraph id="par_id3146080" role="paragraph" xml-lang="en-US"> <emph>FindText</emph> is the text to be searched for.</paragraph> +<paragraph id="par_id3154111" role="paragraph" xml-lang="en-US"> <emph>Text</emph> is the text where the search will take place.</paragraph> +<paragraph id="par_id3149559" role="paragraph" xml-lang="en-US"> <emph>Position</emph> (optional) is the position in the text where the search is to start.</paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3154564" role="paragraph" xml-lang="en-US"> <item type="input">=SEARCH(54;998877665544)</item> returns 10.</paragraph> +</section> + +<section id="substitute"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3154830"> + <bookmark_value>SUBSTITUTE function</bookmark_value> +</bookmark> + +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_WECHSELN" id="bm_id3147090" localize="false"/> + +<h2 id="hd_id3154830">SUBSTITUTE</h2> +<paragraph id="par_id3153698" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_WECHSELN">Substitutes new text for old text in a string.</ahelp></paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3147582" role="code" xml-lang="en-US">SUBSTITUTE("Text"; "SearchText"; "NewText" [; Occurrence])</paragraph> +<paragraph id="par_id3153675" role="paragraph" xml-lang="en-US"> <emph>Text</emph> is the text in which text segments are to be exchanged.</paragraph> +<paragraph id="par_id3156155" role="paragraph" xml-lang="en-US"> <emph>SearchText </emph>is the text segment that is to be replaced (a number of times).</paragraph> +<paragraph id="par_id3145779" role="paragraph" xml-lang="en-US"> <emph>NewText</emph> is the text that is to replace the text segment.</paragraph> +<paragraph id="par_id3150348" role="paragraph" xml-lang="en-US"> <emph>Occurrence</emph> (optional) indicates which occurrence of the search text is to be replaced. If this parameter is missing the search text is replaced throughout.</paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3150412" role="paragraph" xml-lang="en-US"> <item type="input">=SUBSTITUTE("123123123";"3";"abc")</item> returns 12abc12abc12abc.</paragraph> +<paragraph id="par_id3154915" role="paragraph" xml-lang="en-US"> <item type="input">=SUBSTITUTE("123123123";"3";"abc";2)</item> returns 12312abc123.</paragraph> +</section> + +<section id="t"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3148977"> + <bookmark_value>T function</bookmark_value> +</bookmark> + +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_T" id="bm_id3156051" localize="false"/> + +<h2 id="hd_id3148977">T</h2> +<paragraph id="par_id3154359" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_T">This function returns the target text, or a blank text string if the target is not text.</ahelp></paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3155871" role="code" xml-lang="en-US">T(Value)</paragraph> +<paragraph id="par_id3154726" role="paragraph" xml-lang="en-US">If <emph>Value</emph> is a text string or refers to a text string, T returns that text string; otherwise it returns a blank text string.</paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3151062" role="paragraph" xml-lang="en-US"> <item type="input">=T(12345)</item> returns an empty string. </paragraph> +<paragraph id="par_id4650105" role="paragraph" xml-lang="en-US"> <item type="input">=T("12345")</item> returns the string 12345.</paragraph> +</section> + +<section id="text"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3147132"> + <bookmark_value>TEXT function</bookmark_value> +</bookmark> + +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_TEXT" id="bm_id3156426" localize="false"/> + +<h2 id="hd_id3147132">TEXT</h2> +<paragraph id="par_id3147213" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_TEXT">Converts a value into text according to a given format.</ahelp></paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3147377" role="code" xml-lang="en-US">TEXT(Value; Format)</paragraph> +<paragraph id="par_id3147389" role="paragraph" xml-lang="en-US"> <emph>Value</emph> is the value (numerical or textual) to be converted.</paragraph> +<paragraph id="par_id3156167" role="paragraph" xml-lang="en-US"> <emph>Format</emph> is the text which defines the format. Use decimal and thousands separators according to the language set in the cell format.</paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id9044770" role="paragraph" xml-lang="en-US"> <item type="input">=TEXT(12.34567;"###.##")</item> returns the text 12.35</paragraph> +<paragraph id="par_id3674123" role="paragraph" xml-lang="en-US"> <item type="input">=TEXT(12.34567;"000.00")</item> returns the text 012.35</paragraph> +<paragraph id="par_id3674124" role="paragraph" xml-lang="en-US"> <item type="input">=TEXT("xyz";"=== @ ===")</item> returns the text === xyz ===</paragraph> + +<tip id="par_id3145364">See also <link href="text/shared/01/05020301.xhp" name="Number format codes">Number format codes</link>: custom format codes defined by the user.</tip> +</section> + +<section id="trim"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3151039"> + <bookmark_value>TRIM function</bookmark_value> +</bookmark> + +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_GLAETTEN" id="bm_id3150584" localize="false"/> + +<h2 id="hd_id3151039">TRIM</h2> +<paragraph id="par_id3157888" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_GLAETTEN">Removes spaces from a string, leaving only a single space character between words.</ahelp></paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3151349" role="code" xml-lang="en-US">TRIM("Text")</paragraph> +<paragraph id="par_id3151362" role="paragraph" xml-lang="en-US"> <emph>Text</emph> refers to text in which spaces are to be removed.</paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3156074" role="paragraph" xml-lang="en-US"> <item type="input">=TRIM(" hello world ")</item> returns hello world without leading and trailing spaces and with single space between words.</paragraph> +</section> + +<section id="unichar"> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_UNICHAR" id="bm_id0907200904004674" localize="false"/> +<bookmark xml-lang="en-US" branch="index" id="bm_id0907200904030935"> + <bookmark_value>UNICHAR function</bookmark_value> +</bookmark> + + +<h2 id="hd_id0907200904022525">UNICHAR</h2> +<paragraph id="par_id0907200904022538" role="paragraph" xml-lang="en-US"><ahelp hid=".">Converts a code number into a Unicode character or letter.</ahelp></paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id0907200904123753" role="paragraph" xml-lang="en-US"><item type="literal">UNICHAR(number)</item></paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id090720090412378" role="paragraph" xml-lang="en-US">=UNICHAR(169) returns the Copyright character <emph>©</emph>.</paragraph> +<tip id="par_id050220170755399756">See also the UNICODE() function.</tip> +</section> + +<section id="unicode"> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_UNICODE" id="bm_id0907200904011330" localize="false"/> +<bookmark xml-lang="en-US" branch="index" id="bm_id0907200904033543"> + <bookmark_value>UNICODE function</bookmark_value> +</bookmark> + + +<h2 id="hd_id0907200904022588">UNICODE</h2> +<paragraph id="par_id0907200904022594" role="paragraph" xml-lang="en-US"><ahelp hid=".">Returns the numeric code for the first Unicode character in a text string.</ahelp></paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id0907200904123846" role="paragraph" xml-lang="en-US"><item type="literal">UNICODE("Text")</item></paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id0907200904123919" role="paragraph" xml-lang="en-US">=UNICODE("©") returns the Unicode number 169 for the Copyright character.</paragraph> +<tip id="par_id050220170755393174">See also the UNICHAR() function.</tip> +</section> + +<section id="upper"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3145178"> + <bookmark_value>UPPER function</bookmark_value> +</bookmark> + +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_GROSS" id="bm_id3145189" localize="false"/> + +<h2 id="hd_id3145178">UPPER</h2> +<paragraph id="par_id3162905" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_GROSS">Converts the string specified in the <emph>text</emph> field to uppercase.</ahelp></paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3148539" role="code" xml-lang="en-US">UPPER("Text")</paragraph> +<paragraph id="par_id3148496" role="paragraph" xml-lang="en-US"> <emph>Text</emph> refers to the lower case letters you want to convert to upper case.</paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3146757" role="paragraph" xml-lang="en-US"> <item type="input">=UPPER("Good Morning")</item> returns GOOD MORNING.</paragraph> +</section> + +<section id="value"> +<embed href="text/scalc/01/func_value.xhp#func_value"/> +</section> + +<section id="webservice"> + <embed href="text/scalc/01/func_webservice.xhp#webservicefuncheader"/> +</section> +<section id="filterxml"> + <embed href="text/scalc/01/func_webservice.xhp#filterxmlfuncheader"/> +</section> +<section id="encodeurl"> + <embed href="text/scalc/01/func_webservice.xhp#encodeurlfuncheader"/> +</section> +</sort> + +<section id="relatedtopics"> +<embed href="text/scalc/01/04060100.xhp#drking"/> +</section> +</body> + +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/04060111.xhp b/helpcontent2/source/text/scalc/01/04060111.xhp new file mode 100644 index 000000000..d50288c05 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/04060111.xhp @@ -0,0 +1,204 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> + +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . + --> + +<meta> +<topic id="textscalc0104060111xml" indexer="include"> +<title id="tit" xml-lang="en-US">Add-in Functions</title> +<filename>/text/scalc/01/04060111.xhp</filename> +</topic> +</meta> +<body> +<bookmark xml-lang="en-US" branch="index" id="bm_id3150870"><bookmark_value>add-ins; functions</bookmark_value> +<bookmark_value>functions; add-in functions</bookmark_value> +<bookmark_value>Function Wizard; add-ins</bookmark_value> +</bookmark> +<h1 id="hd_id3150870"><variable id="head_addin"><link href="text/scalc/01/04060111.xhp" name="Add-in Functions">Add-in Functions</link></variable></h1> +<paragraph role="paragraph" id="par_id3147427" xml-lang="en-US"><variable id="addintext">The following describes and lists some of the available add-in functions. +</variable></paragraph> +<paragraph role="paragraph" id="par_id3163713" xml-lang="en-US"><link href="text/scalc/01/04060112.xhp#addinconcept">Add-in concept</link></paragraph> +<paragraph role="paragraph" id="par_id3146120" xml-lang="en-US">You will also find a <link href="text/scalc/01/04060112.xhp">description of the $[officename] Calc add-in interface</link> in the Help. In addition, important functions and their parameters are described in the Help for the <switchinline select="sys"><caseinline select="UNIX">Shared Library +</caseinline><defaultinline>$[officename] Calc add-in DLL</defaultinline></switchinline>.</paragraph> +<h2 id="hd_id3151075">Add-ins supplied</h2> +<paragraph role="paragraph" id="par_id3156285" xml-lang="en-US">$[officename] contains examples for the add-in interface of $[officename] Calc.</paragraph> +<paragraph role="paragraph" id="par_id3159267" xml-lang="en-US"><link href="text/scalc/01/04060115.xhp">Analysis Functions Part One</link></paragraph> +<paragraph role="paragraph" id="par_id3154703" xml-lang="en-US"><link href="text/scalc/01/04060116.xhp">Analysis Functions Part Two</link></paragraph> +<sort order="asc" descendant="h2"> +<section id="isleapyear"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3149566"><bookmark_value>ISLEAPYEAR function</bookmark_value> +<bookmark_value>leap year determination</bookmark_value> +</bookmark><comment>mw added one entry</comment> +<h2 id="hd_id3149566">ISLEAPYEAR</h2> +<paragraph role="paragraph" id="par_id3150297" xml-lang="en-US"><ahelp hid=".">Determines whether a year is a leap year.</ahelp> If yes, the function will return the value 1 (TRUE); if not, it will return 0 (FALSE).</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph role="code" id="par_id3150205" xml-lang="en-US">ISLEAPYEAR(Date)</paragraph> +<paragraph role="paragraph" id="par_id3159239" xml-lang="en-US"> +<emph>Date</emph> specifies whether a given date falls within a leap year. The Date parameter must be a valid date.</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph role="paragraph" id="par_id3150786" xml-lang="en-US">=ISLEAPYEAR(A1) returns 1, if A1 contains 1968-02-29, the valid date 29th of February 1968 in your locale setting.</paragraph> +<paragraph role="paragraph" id="par_idN107E7" xml-lang="en-US">You may also use =ISLEAPYEAR(DATE(1968;2;29)) or =ISLEAPYEAR("1968-02-29") giving the date string in the ISO 8601 notation.</paragraph> +<paragraph role="paragraph" id="par_idN107EA" xml-lang="en-US">Never use =ISLEAPYEAR(2/29/68), because this would first evaluate 2 divided by 29 divided by 68, and then calculate the ISLEAPYEAR function from this small number as a serial date number.</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectiontechinfo"/> +<embed href="text/scalc/01/common_func.xhp#notODFF"/> +<paragraph role="paragraph" id="par_id311600873986703" localize="false"><literal>ORG.OPENOFFICE.ISLEAPYEAR</literal></paragraph> +</section> +<section id="years"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3154656"><bookmark_value>YEARS function</bookmark_value> +<bookmark_value>number of years between two dates</bookmark_value> +</bookmark><comment>mw added one entry</comment> +<bookmark xml-lang="en-US" branch="hid/SC_HID_DAI_FUNC_DIFFYEARS" id="bm_id3150368" localize="false"/> +<h2 id="hd_id3154656">YEARS</h2> +<paragraph role="paragraph" id="par_id3150886" xml-lang="en-US"><ahelp hid="HID_DAI_FUNC_DIFFYEARS">Calculates the difference in years between two dates.</ahelp></paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph role="code" id="par_id3146114" xml-lang="en-US">YEARS(StartDate; EndDate; Type)</paragraph> +<paragraph role="paragraph" id="par_id3145387" xml-lang="en-US"> +<emph>StartDate</emph> is the first date</paragraph> +<paragraph role="paragraph" id="par_id3156290" xml-lang="en-US"> +<emph>EndDate</emph> is the second date</paragraph> +<paragraph role="paragraph" id="par_id3152893" xml-lang="en-US"> +<emph>Type</emph> calculates the type of difference. Possible values are 0 (interval) and 1 (in calendar years).</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectiontechinfo"/> +<embed href="text/scalc/01/common_func.xhp#notODFF"/> +<paragraph role="paragraph" id="par_id311640873086703" localize="false"><literal>ORG.OPENOFFICE.YEARS</literal></paragraph> +</section> +<section id="months"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3152898"><bookmark_value>MONTHS function</bookmark_value> +<bookmark_value>number of months between two dates</bookmark_value> +</bookmark><comment>mw added one entry</comment> +<bookmark xml-lang="en-US" branch="hid/SC_HID_DAI_FUNC_DIFFMONTHS" id="bm_id3148839" localize="false"/> +<h2 id="hd_id3152898">MONTHS</h2> +<paragraph role="paragraph" id="par_id3153066" xml-lang="en-US"><ahelp hid="HID_DAI_FUNC_DIFFMONTHS">Calculates the difference in months between two dates.</ahelp></paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph role="code" id="par_id3146869" xml-lang="en-US">MONTHS(StartDate; EndDate; Type)</paragraph> +<paragraph role="paragraph" id="par_id3145075" xml-lang="en-US"> +<emph>StartDate</emph> is the first date</paragraph> +<paragraph role="paragraph" id="par_id3157981" xml-lang="en-US"> +<emph>EndDate</emph> is the second date</paragraph> +<paragraph role="paragraph" id="par_id3150111" xml-lang="en-US"> +<emph>Type</emph> calculates the type of difference. Possible values include 0 (interval) and 1 (in calendar months).</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectiontechinfo"/> +<embed href="text/scalc/01/common_func.xhp#notODFF"/> +<paragraph role="paragraph" id="par_id321640873986703" localize="false"><literal>ORG.OPENOFFICE.MONTHS</literal></paragraph> +</section> +<section id="rot13"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3159094"><bookmark_value>ROT13 function</bookmark_value> +<bookmark_value>encrypting text</bookmark_value> +</bookmark><comment>mw added one entry</comment> +<bookmark xml-lang="en-US" branch="hid/SC_HID_DAI_FUNC_ROT13" id="bm_id3153283" localize="false"/> +<h2 id="hd_id3159094">ROT13</h2> +<paragraph role="paragraph" id="par_id3146781" xml-lang="en-US"><ahelp hid="HID_DAI_FUNC_ROT13">Encrypts a character string by moving the characters 13 positions in the alphabet.</ahelp> After the letter Z, the alphabet begins again (Rotation). By applying the encryption function again to the resulting code, you can decrypt the text.</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph role="code" id="par_id3159205" xml-lang="en-US">ROT13(Text)</paragraph> +<paragraph role="paragraph" id="par_id3153249" xml-lang="en-US"> +<emph>Text</emph> is the character string to be encrypted. ROT13(ROT13(Text)) decrypts the code.</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id151626469224135" role="paragraph"><input>=ROT13("Gur Qbphzrag Sbhaqngvba jnf sbhaqrq va Frcgrzore 2010.")</input> returns the string "The Document Foundation was founded in September 2010.". Notice how spaces, digits, and full stops are unaffected by ROT13.</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectiontechinfo"/> +<embed href="text/scalc/01/common_func.xhp#notODFF"/> +<paragraph role="paragraph" id="par_id314640873986703" localize="false"><literal>ORG.OPENOFFICE.ROT13</literal></paragraph> +<tip id="par_id221626469509161">Refer to the <link href="https://wiki.documentfoundation.org/Documentation/Calc_Functions/ROT13" name="ROT13_Wiki">ROT13</link> wiki page for more details about this function.</tip> +</section> +<section id="daysinyear"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3151300"><bookmark_value>DAYSINYEAR function</bookmark_value> +<bookmark_value>number of days; in a specific year</bookmark_value> +</bookmark><comment>mw added one entry</comment> +<bookmark xml-lang="en-US" branch="hid/SC_HID_DAI_FUNC_DAYSINYEAR" id="bm_id3153972" localize="false"/> +<h2 id="hd_id3151300">DAYSINYEAR</h2> +<paragraph role="paragraph" id="par_id3143220" xml-lang="en-US"><ahelp hid="HID_DAI_FUNC_DAYSINYEAR">Calculates the number of days of the year in which the date entered occurs.</ahelp></paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph role="code" id="par_id3154651" xml-lang="en-US">DAYSINYEAR(Date)</paragraph> +<paragraph role="paragraph" id="par_id3153803" xml-lang="en-US"> +<emph>Date</emph> is any date in the respective year. The Date parameter must be a valid date according to the locale settings of %PRODUCTNAME.</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph role="paragraph" id="par_id3153811" xml-lang="en-US">=DAYSINYEAR(A1) returns 366 days if A1 contains 1968-02-29, a valid date for the year 1968.</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectiontechinfo"/> +<embed href="text/scalc/01/common_func.xhp#notODFF"/> +<paragraph role="paragraph" id="par_id311640873586703" localize="false"><literal>ORG.OPENOFFICE.DAYSINYEAR</literal></paragraph> +</section> +<section id="daysinmonth"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3154737"><bookmark_value>DAYSINMONTH function</bookmark_value> +<bookmark_value>number of days;in a specific month of a year</bookmark_value> +</bookmark><comment>mw added one entry</comment> +<bookmark xml-lang="en-US" branch="hid/SC_HID_DAI_FUNC_DAYSINMONTH" id="bm_id3155593" localize="false"/> +<h2 id="hd_id3154737">DAYSINMONTH</h2> +<paragraph role="paragraph" id="par_id3149316" xml-lang="en-US"><ahelp hid="HID_DAI_FUNC_DAYSINMONTH">Calculates the number of days of the month in which the date entered occurs.</ahelp></paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph role="code" id="par_id3150955" xml-lang="en-US">DAYSINMONTH(Date)</paragraph> +<paragraph role="paragraph" id="par_id3147501" xml-lang="en-US"> +<emph>Date</emph> is any date in the respective month of the desired year. The Date parameter must be a valid date according to the locale settings of %PRODUCTNAME.</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph role="paragraph" id="par_id3155742" xml-lang="en-US">=DAYSINMONTH(A1) returns 29 days if A1 contains 1968-02-17, a valid date for February 1968.</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectiontechinfo"/> +<embed href="text/scalc/01/common_func.xhp#notODFF"/> +<paragraph role="paragraph" id="par_id311640873986700" localize="false"><literal>ORG.OPENOFFICE.DAYSINMONTH</literal></paragraph> +</section> +<section id="weeks"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3149048"><bookmark_value>WEEKS function</bookmark_value> +<bookmark_value>number of weeks;between two dates</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_DAI_FUNC_DIFFWEEKS" id="bm_id3150435" localize="false"/> +<h2 id="hd_id3149048">WEEKS</h2> +<paragraph role="paragraph" id="par_id3153340" xml-lang="en-US"><ahelp hid="HID_DAI_FUNC_DIFFWEEKS">Calculates the difference in weeks between two dates.</ahelp></paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph role="code" id="par_id3147402" xml-lang="en-US">WEEKS(StartDate; EndDate; Type)</paragraph> +<paragraph role="paragraph" id="par_id3151387" xml-lang="en-US"> +<emph>StartDate</emph> is the start date in the interval.</paragraph> +<paragraph role="paragraph" id="par_id3146324" xml-lang="en-US"> +<emph>EndDate</emph> is the end date in the interval. The end date must be greater than the start date, or else an error is returned.</paragraph> +<paragraph role="paragraph" id="par_id3166467" xml-lang="en-US"> +<emph>Type</emph> specifies the type of difference to be calculated. Possible values are 0 (time interval) or 1 (calendar weeks).</paragraph> +<paragraph role="paragraph" id="par_id81641990941192">If <emph>Type = 0</emph> the function will assume that 7 days is equivalent to one week without considering any specific day to mark the beginning of a week.</paragraph> +<paragraph role="paragraph" id="par_id31641991010650">If <emph>Type = 1</emph> the function will consider Monday to be the first day of the week. Therefore, except for the start date, each occurrence of a Monday in the interval is counted as an additional week.</paragraph> +<note id="par_id971641990480242">This function considers Monday to be the first day of the week regardless of the current locale settings.</note> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph role="paragraph" id="par_id671641994821992">In the following examples, dates are passed as strings. However, they can also be stored in separate cells and be passed as references.</paragraph> +<paragraph role="paragraph" id="par_id71641991391639"><input>=WEEKS("01/12/2022","01/17/2022",0)</input> returns 0 because <emph>Type</emph> was set to 0 and there are only 5 days in the interval.</paragraph> +<paragraph role="paragraph" id="par_id71641991390039"><input>=WEEKS("01/12/2022","01/19/2022",0)</input> returns 1 because <emph>Type</emph> was set to 0 and there are 7 days in the interval.</paragraph> +<paragraph role="paragraph" id="par_id71641991391123"><input>=WEEKS("01/12/2022","01/17/2022",1)</input> returns 1 because <emph>Type</emph> was set to 1 and the interval contains a Monday, since 01/12/2022 is a Wednesday and 01/17/2022 is a Monday.</paragraph> +<paragraph role="paragraph" id="par_id71641991332523"><input>=WEEKS("01/10/2022","01/15/2022",1)</input> returns 0 because <emph>Type</emph> was set to 1 and the interval does not contain any Mondays, except for the start date.</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectiontechinfo"/> +<embed href="text/scalc/01/common_func.xhp#notODFF"/> +<paragraph role="paragraph" id="par_id311640873986703" localize="false"><literal>ORG.OPENOFFICE.WEEKS</literal></paragraph> +</section> +<section id="weeksinyear"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3145237"><bookmark_value>WEEKSINYEAR function</bookmark_value> +<bookmark_value>number of weeks;in a specific year</bookmark_value> +</bookmark><comment>mw added one entry</comment> +<bookmark xml-lang="en-US" branch="hid/SC_HID_DAI_FUNC_WEEKSINYEAR" id="bm_id3146883" localize="false"/> +<h2 id="hd_id3145237">WEEKSINYEAR</h2> +<paragraph role="paragraph" id="par_id3147410" xml-lang="en-US"><ahelp hid="HID_DAI_FUNC_WEEKSINYEAR">Calculates the number of weeks of the year in which the date entered occurs.</ahelp> The number of weeks is defined as follows: a week that spans two years is added to the year in which most days of that week occur.</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph role="code" id="par_id3145638" xml-lang="en-US">WEEKSINYEAR(Date)</paragraph> +<paragraph role="paragraph" id="par_id3149946" xml-lang="en-US"> +<emph>Date</emph> is any date in the respective year. The Date parameter must be a valid date according to the locale settings of %PRODUCTNAME.</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph role="paragraph" id="par_id3147614" xml-lang="en-US">WEEKSINYEAR(A1) returns 53 if A1 contains 1970-02-17, a valid date for the year 1970.</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectiontechinfo"/> +<embed href="text/scalc/01/common_func.xhp#notODFF"/> +<paragraph role="paragraph" id="par_id311540873986703" localize="false"><literal>ORG.OPENOFFICE.WEEKSINYEAR</literal></paragraph> +</section> +</sort> +<h2 id="hd_id3157901">Add-ins through %PRODUCTNAME API</h2> +<paragraph role="paragraph" id="par_id3149351" xml-lang="en-US">Add-ins can also be implemented through the %PRODUCTNAME <link href="https://api.libreoffice.org/" name="api.libreoffice.org">API</link>.</paragraph> +<section id="relatedtopics"> +<embed href="text/scalc/01/04060100.xhp#drking"/> +</section> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/04060112.xhp b/helpcontent2/source/text/scalc/01/04060112.xhp new file mode 100644 index 000000000..5a80424b3 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/04060112.xhp @@ -0,0 +1,682 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . + --> +<helpdocument version="1.0"> +<meta> +<topic id="textscalc0104060112xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Add-in for Programming in $[officename] Calc</title> +<filename>/text/scalc/01/04060112.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +</history> +</meta> +<body> +<bookmark xml-lang="en-US" branch="index" id="bm_id3151076"><bookmark_value>programming; add-ins</bookmark_value> +<bookmark_value>shared libraries; programming</bookmark_value> +<bookmark_value>external DLL functions</bookmark_value> +<bookmark_value>functions; $[officename] Calc add-in DLL</bookmark_value> +<bookmark_value>add-ins; for programming</bookmark_value> +</bookmark><comment>mw made "external..." a one level entry and deleted one "functions;..." entry</comment> +<h1 id="hd_id3151076">Add-in for Programming in $[officename] Calc</h1> +<warning id="par_id3147001">The method of extending Calc by Add-Ins that is described in the following is outdated. The interfaces are still valid and supported, to ensure compatibility with existing Add-Ins, but for programming new Add-Ins you should use the new <link href="text/shared/guide/integratinguno.xhp" name="API functions">API functions</link>.</warning> +<paragraph role="paragraph" id="par_id3150361" xml-lang="en-US">$[officename] Calc can be expanded by Add-Ins, which are external programming modules providing additional functions for working with spreadsheets. These are listed in the <emph>Function Wizard</emph> in the <emph>Add-In</emph> category. If you would like to program an Add-In yourself, you can learn here which functions must be exported by the <switchinline select="sys"><caseinline select="UNIX">shared library +</caseinline><defaultinline>external DLL</defaultinline></switchinline> so that the Add-In can be successfully attached.</paragraph> +<paragraph role="paragraph" id="par_id3149211" xml-lang="en-US">$[officename] searches the Add-in folder defined in the configuration for a suitable <switchinline select="sys"><caseinline select="UNIX">shared library +</caseinline><defaultinline>DLL</defaultinline></switchinline>. To be recognized by $[officename], the <switchinline select="sys"><caseinline select="UNIX">shared library +</caseinline><defaultinline>DLL</defaultinline></switchinline> must have certain properties, as explained in the following. This information allows you to program your own Add-In for <emph>Function Wizard</emph> of $[officename] Calc.</paragraph> +<section id="addinconcept"> +<h2 id="hd_id3146981">The Add-In Concept</h2> +<paragraph role="paragraph" id="par_id3156292" xml-lang="en-US">Each Add-In library provides several functions. Some functions are used for administrative purposes. You can choose almost any name for your own functions. However, they must also follow certain rules regarding parameter passing. The exact naming and calling conventions vary for different platforms.</paragraph> +</section> +<h3 id="hd_id3152890">Functions of <switchinline select="sys"><caseinline select="UNIX">Shared Library +</caseinline><defaultinline>AddIn DLL</defaultinline></switchinline></h3> +<paragraph role="paragraph" id="par_id3148837" xml-lang="en-US">At a minimum, the administrative functions <link href="text/scalc/01/04060112.xhp" name="GetFunctionCount">GetFunctionCount</link> and <link href="text/scalc/01/04060112.xhp" name="GetFunctionData">GetFunctionData</link> must exist. Using these, the functions as well as parameter types and return values can be determined. As return values, the Double and String types are supported. As parameters, additionally the cell areas <link href="text/scalc/01/04060112.xhp" name="Double Array">Double Array</link>, <link href="text/scalc/01/04060112.xhp" name="String Array">String Array</link>, and <link href="text/scalc/01/04060112.xhp" name="Cell Array">Cell Array</link> are supported.</paragraph> +<paragraph role="paragraph" id="par_id3148604" xml-lang="en-US">Parameters are passed using references. Therefore, a change of these values is basically possible. However, this is not supported in $[officename] Calc because it does not make sense within spreadsheets.</paragraph> +<paragraph role="paragraph" id="par_id3150112" xml-lang="en-US">Libraries can be reloaded during runtime and their contents can be analyzed by the administrative functions. For each function, information is available about count and type of parameters, internal and external function names and an administrative number.</paragraph> +<paragraph role="paragraph" id="par_id3155269" xml-lang="en-US">The functions are called synchronously and return their results immediately. Real time functions (asynchronous functions) are also possible; however, they are not explained in detail because of their complexity.</paragraph> +<h2 id="hd_id3145077">General information about the interface</h2> +<paragraph role="paragraph" id="par_id3146776" xml-lang="en-US">The maximum number of parameters in an Add-In function attached to $[officename] Calc is 16: one return value and a maximum of 15 function input parameters.</paragraph> +<paragraph role="paragraph" id="par_id3149899" xml-lang="en-US">The data types are defined as follows:</paragraph> +<table id="tbl_id3159203"> +<tablerow> +<tablecell> +<paragraph role="tablehead" id="par_id3151302" xml-lang="en-US"> +<emph>Data types</emph> +</paragraph> +</tablecell> +<tablecell> + <paragraph role="tablehead" id="par_id3143222" xml-lang="en-US"> +<emph>Definition</emph> +</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> + <paragraph role="paragraph" id="par_id3149384" xml-lang="en-US" localize="false">CALLTYPE</paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3146963" xml-lang="en-US">Under Windows: FAR PASCAL (_far _pascal)</paragraph> +<paragraph role="paragraph" id="par_id3153809" xml-lang="en-US">Other: default (operating system specific default)</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> + <paragraph role="paragraph" id="par_id3154734" xml-lang="en-US" localize="false">USHORT</paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3155760" xml-lang="en-US">2 Byte unsigned Integer</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> + <paragraph role="paragraph" id="par_id3145320" xml-lang="en-US" localize="false">DOUBLE</paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3150956" xml-lang="en-US">8 byte platform-dependent format</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> + <paragraph role="paragraph" id="par_id3146097" xml-lang="en-US" localize="false">Paramtype</paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3150432" xml-lang="en-US">Platform-dependent like int</paragraph> +<paragraph role="paragraph" id="par_id3153955" xml-lang="en-US">PTR_DOUBLE =0 pointer to a double</paragraph> +<paragraph role="paragraph" id="par_id3159262" xml-lang="en-US">PTR_STRING =1 pointer to a zero-terminated string</paragraph> +<paragraph role="paragraph" id="par_id3148747" xml-lang="en-US">PTR_DOUBLE_ARR =2 pointer to a double array</paragraph> +<paragraph role="paragraph" id="par_id3147406" xml-lang="en-US">PTR_STRING_ARR =3 pointer to a string array</paragraph> +<paragraph role="paragraph" id="par_id3151392" xml-lang="en-US">PTR_CELL_ARR =4 pointer to a cell array</paragraph> +<paragraph role="paragraph" id="par_id3153028" xml-lang="en-US">NONE =5</paragraph> +</tablecell> +</tablerow> +</table> + +<h2 id="hd_id3156396"><switchinline select="sys"><caseinline select="UNIX">Shared Library +</caseinline><defaultinline>DLL</defaultinline></switchinline> functions</h2> +<paragraph role="paragraph" id="par_id3153019" xml-lang="en-US">Following you will find a description of those functions, which are called at the <switchinline select="sys"><caseinline select="UNIX">Shared Library +</caseinline><defaultinline>external DLL</defaultinline></switchinline>.</paragraph> +<paragraph role="paragraph" id="par_id3150038" xml-lang="en-US">For all <switchinline select="sys"><caseinline select="UNIX">Shared Library +</caseinline><defaultinline>DLL</defaultinline></switchinline> functions, the following applies:</paragraph> +<paragraph role="paragraph" id="par_id3157876" xml-lang="en-US" localize="false"><literal>void CALLTYPE fn(out, in1, in2, ...)</literal></paragraph> +<paragraph role="paragraph" id="par_id3147616" xml-lang="en-US"><emph>Output</emph>: Resulting value</paragraph> +<paragraph role="paragraph" id="par_id3159119" xml-lang="en-US"><emph>Input</emph>: Any number of types (double&, char*, double*, char**, Cell area), where the <link href="text/scalc/01/04060112.xhp" name="Cell area">Cell area</link> is an array of types double array, string array, or cell array.</paragraph> +<h3 id="hd_id3150653">GetFunctionCount()</h3> +<paragraph role="paragraph" id="par_id3152981" xml-lang="en-US">Returns the number of functions without the management functions of the reference parameter. Each function has a unique number between 0 and nCount-1. This number will be needed for the <link href="text/scalc/01/04060112.xhp" name="GetFunctionData">GetFunctionData</link> and <link href="text/scalc/01/04060112.xhp" name="GetParameterDescription">GetParameterDescription</link> functions later.</paragraph> +<paragraph role="paragraph" id="par_id3150742" xml-lang="en-US"> +<emph>Syntax</emph> +</paragraph> +<paragraph role="paragraph" id="par_id3148728" xml-lang="en-US" localize="false"><literal>void CALLTYPE GetFunctionCount(USHORT& nCount)</literal></paragraph> +<paragraph role="paragraph" id="par_id3154677" xml-lang="en-US"> +<emph>Parameter</emph> +</paragraph> +<paragraph role="paragraph" id="par_id3146940" xml-lang="en-US" localize="false"><literal>USHORT &nCount</literal>:</paragraph> +<paragraph role="paragraph" id="par_id3149893" xml-lang="en-US"><emph>Output</emph>: Reference to a variable, which is supposed to contain the number of Add-In functions. For example: If the Add-In provides 5 functions for $[officename] Calc, then nCount=5.</paragraph> +<h3 id="hd_id3147476">GetFunctionData()</h3> +<paragraph role="paragraph" id="par_id3154841" xml-lang="en-US">Determines all the important information about an Add-In function.</paragraph> +<paragraph role="paragraph" id="par_id3148888" xml-lang="en-US"> +<emph>Syntax</emph> +</paragraph> +<paragraph role="paragraph" id="par_id3148434" xml-lang="en-US" localize="false"><literal>void CALLTYPE GetFunctionData(USHORT& nNo, char* pFuncName, USHORT& nParamCount, Paramtype* peType, char* pInternalName)</literal></paragraph> +<paragraph role="paragraph" id="par_id3149253" xml-lang="en-US"> +<emph>Parameter</emph> +</paragraph> +<paragraph role="paragraph" id="par_id3149686" xml-lang="en-US" localize="false"><literal>USHORT& nNo</literal>:</paragraph> +<paragraph role="paragraph" id="par_id3149949" xml-lang="en-US"><emph>Input</emph>: Function number between 0 and nCount-1, inclusively.</paragraph> +<paragraph role="paragraph" id="par_id3149546" xml-lang="en-US" localize="false"><literal>char* pFuncName</literal>:</paragraph> +<paragraph role="paragraph" id="par_id3148579" xml-lang="en-US"><emph>Output</emph>: Function name as seen by the programmer, as it is named in the <switchinline select="sys"><caseinline select="UNIX">Shared Library +</caseinline><defaultinline>DLL</defaultinline></switchinline>. This name does not determine the name used in the <emph>Function Wizard</emph>.</paragraph> +<paragraph role="paragraph" id="par_id3153935" xml-lang="en-US" localize="false"><literal>USHORT& nParamCount</literal>:</paragraph> +<paragraph role="paragraph" id="par_id3150142" xml-lang="en-US"><emph>Output</emph>: Number of parameters in AddIn function. This number must be greater than 0, because there is always a result value; the maximum value is 16.</paragraph> +<paragraph role="paragraph" id="par_id3145143" xml-lang="en-US" localize="false"><literal>Paramtype* peType</literal>:</paragraph> +<paragraph role="paragraph" id="par_id3148750" xml-lang="en-US"><emph>Output</emph>: Pointer to an array of exactly 16 variables of type Paramtype. The first nParamCount entries are filled with the suitable type of parameter.</paragraph> +<paragraph role="paragraph" id="par_id3153078" xml-lang="en-US" localize="false"><literal>char* pInternalName</literal>:</paragraph> +<paragraph role="paragraph" id="par_id3155261" xml-lang="en-US"><emph>Output</emph>: Function name as seen by the user, as it appears in the <emph>Function Wizard</emph>. May contain umlauts.</paragraph> +<paragraph role="paragraph" id="par_id3153327" xml-lang="en-US">The pFuncName and pInternalName parameters are char arrays, which are implemented with size 256 in $[officename] Calc.</paragraph> +<h3 id="hd_id3148567">GetParameterDescription()</h3> +<paragraph role="paragraph" id="par_id3153000" xml-lang="en-US">Provides a brief description of the Add-In function and its parameters. As an option, this function can be used to show a function and parameter description in the <emph>Function Wizard</emph>.</paragraph> +<paragraph role="paragraph" id="par_id3154501" xml-lang="en-US"> +<emph>Syntax</emph> +</paragraph> +<paragraph role="paragraph" id="par_id3153564" xml-lang="en-US"><literal>void CALLTYPE GetParameterDescription(USHORT& nNo, USHORT& nParam, char* pName, char* pDesc)</literal></paragraph> +<paragraph role="paragraph" id="par_id3157995" xml-lang="en-US"> +<emph>Parameter</emph> +</paragraph> +<paragraph role="paragraph" id="par_id3155925" xml-lang="en-US" localize="false"><literal>USHORT& nNo</literal>:</paragraph> +<paragraph role="paragraph" id="par_id3149883" xml-lang="en-US"><emph>Input</emph>: Number of the function in the library; between 0 and nCount-1.</paragraph> +<paragraph role="paragraph" id="par_id3154326" xml-lang="en-US" localize="false"><literal>USHORT& nParam</literal>:</paragraph> +<paragraph role="paragraph" id="par_id3159139" xml-lang="en-US"><emph>Input</emph>: Indicates, for which parameter the description is provided; parameters start at 1. If nParam is 0, the description itself is supposed to be provided in pDesc; in this case, pName does not have any meaning.</paragraph> +<paragraph role="paragraph" id="par_id3147374" xml-lang="en-US" localize="false"><literal>char* pName</literal>:</paragraph> +<paragraph role="paragraph" id="par_id3145245" xml-lang="en-US"><emph>Output</emph>: Takes up the parameter name or type, for example, the word "Number" or "String" or "Date", and so on. Implemented in $[officename] Calc as char[256].</paragraph> +<paragraph role="paragraph" id="par_id3151020" xml-lang="en-US" localize="false"><literal>char* pDesc</literal>:</paragraph> +<paragraph role="paragraph" id="par_id3148389" xml-lang="en-US"><emph>Output</emph>: Takes up the description of the parameter, for example, "Value, at which the universe is to be calculated." Implemented in $[officename] Calc as char[256].</paragraph> +<paragraph role="paragraph" id="par_id3145303" xml-lang="en-US">pName and pDesc are char arrays; implemented in $[officename] Calc with size 256. Please note that the space available in the <emph>Function Wizard</emph> is limited and that the 256 characters cannot be fully used.</paragraph> +<h2 id="hd_id3148874">Cell areas</h2> +<paragraph role="paragraph" id="par_id3150265" xml-lang="en-US">The following tables contain information about which data structures must be provided by an external program module in order to pass cell areas. $[officename] Calc distinguishes between three different arrays, depending on the data type.</paragraph> +<h3 id="hd_id3156060">Double Array</h3> +<paragraph role="paragraph" id="par_id3149540" xml-lang="en-US">As a parameter, a cell area with values of the Number/Double type can be passed. A double array in $[officename] Calc is defined as follows:</paragraph> +<table id="tbl_id3150665"> +<tablerow> +<tablecell> +<paragraph role="tablehead" id="par_id3149388" xml-lang="en-US">Offset</paragraph> +</tablecell> +<tablecell> + <paragraph role="tablehead" id="par_id3154636" xml-lang="en-US">Name</paragraph> +</tablecell> +<tablecell> + <paragraph role="tablehead" id="par_id3153228" xml-lang="en-US">Description</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> + <paragraph role="paragraph" id="par_id3150685" xml-lang="en-US" localize="false">0</paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3154869" xml-lang="en-US">Col1</paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3147541" xml-lang="en-US">Column number in the upper-left corner of the cell area. Numbering starts at 0.</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> + <paragraph role="paragraph" id="par_id3149783" xml-lang="en-US" localize="false">2</paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3155986" xml-lang="en-US">Row1</paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3147483" xml-lang="en-US">Row number in the upper-left corner of the cell area; numbering starts at 0.</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> + <paragraph role="paragraph" id="par_id3153721" xml-lang="en-US" localize="false">4</paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3154317" xml-lang="en-US">Tab1</paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3149820" xml-lang="en-US">Table number in the upper-left corner of the cell area; numbering starts at 0.</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> + <paragraph role="paragraph" id="par_id3163820" xml-lang="en-US" localize="false">6</paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3149710" xml-lang="en-US">Col2</paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3154819" xml-lang="en-US">Column number in the lower-right corner of the cell area. Numbering starts at 0.</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> + <paragraph role="paragraph" id="par_id3145083" xml-lang="en-US" localize="false">8</paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3156310" xml-lang="en-US">Row2</paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3150968" xml-lang="en-US">Row number in the lower-right corner of the cell area; numbering starts at 0.</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> + <paragraph role="paragraph" id="par_id3156133" xml-lang="en-US" localize="false">10</paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3153218" xml-lang="en-US">Tab2</paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3147086" xml-lang="en-US">Table number in the lower-right corner of the cell area; numbering starts at 0.</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> + <paragraph role="paragraph" id="par_id3151270" xml-lang="en-US" localize="false">12</paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3152934" xml-lang="en-US">Count</paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3145202" xml-lang="en-US">Number of the following elements. Empty cells are not counted or passed.</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> + <paragraph role="paragraph" id="par_id3150879" xml-lang="en-US" localize="false">14</paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3156002" xml-lang="en-US">Col</paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3147276" xml-lang="en-US">Column number of the element. Numbering starts at 0.</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> + <paragraph role="paragraph" id="par_id3151295" xml-lang="en-US" localize="false">16</paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3150261" xml-lang="en-US">Row</paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3155851" xml-lang="en-US">Row number of the element; numbering starts at 0.</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> + <paragraph role="paragraph" id="par_id3153150" xml-lang="en-US" localize="false">18</paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3153758" xml-lang="en-US">Tab</paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3150154" xml-lang="en-US">Table number of the element; numbering starts at 0.</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> + <paragraph role="paragraph" id="par_id3149289" xml-lang="en-US" localize="false">20</paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3156010" xml-lang="en-US">Error</paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3159181" xml-lang="en-US">Error number, where the value 0 is defined as "no error." If the element comes from a formula cell the error value is determined by the formula.</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> + <paragraph role="paragraph" id="par_id3147493" xml-lang="en-US" localize="false">22</paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3149200" xml-lang="en-US">Value</paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3151174" xml-lang="en-US">8 byte IEEE variable of type double/floating point</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> + <paragraph role="paragraph" id="par_id3154688" xml-lang="en-US" localize="false">30</paragraph> +</tablecell> +<tablecell> + <paragraph role="paragraph" id="par_id3159337" xml-lang="en-US" localize="false">...</paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3155388" xml-lang="en-US">Next element</paragraph> +</tablecell> +</tablerow> +</table> + +<h3 id="hd_id3154935">String Array</h3> +<paragraph role="paragraph" id="par_id3153105" xml-lang="en-US">A cell area, which contains values of data type Text and is passed as a string array. A string array in $[officename] Calc is defined as follows:</paragraph> +<table id="tbl_id3146992"> +<tablerow> +<tablecell> +<paragraph role="tablehead" id="par_id3149908" xml-lang="en-US">Offset</paragraph> +</tablecell> +<tablecell> + <paragraph role="tablehead" id="par_id3159165" xml-lang="en-US">Name</paragraph> +</tablecell> +<tablecell> + <paragraph role="tablehead" id="par_id3159150" xml-lang="en-US">Description</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> + <paragraph role="paragraph" id="par_id3149769" xml-lang="en-US" localize="false">0</paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3150509" xml-lang="en-US">Col1</paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3148447" xml-lang="en-US">Column number in the upper-left corner of the cell area. Numbering starts at 0.</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> + <paragraph role="paragraph" id="par_id3145418" xml-lang="en-US" localize="false">2</paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3147512" xml-lang="en-US">Row1</paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3147235" xml-lang="en-US">Row number in the upper-left corner of the cell area; numbering starts at 0.</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> + <paragraph role="paragraph" id="par_id3155362" xml-lang="en-US" localize="false">4</paragraph> +</tablecell> +<tablecell> + <paragraph role="paragraph" id="par_id3151051" xml-lang="en-US">Tab1</paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3148923" xml-lang="en-US">Table number in the upper-left corner of the cell area; numbering starts at 0.</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> + <paragraph role="paragraph" id="par_id3149158" xml-lang="en-US" localize="false">6</paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3166437" xml-lang="en-US">Col2</paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3149788" xml-lang="en-US">Column number in the lower-right corner of the cell area. Numbering starts at 0.</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> + <paragraph role="paragraph" id="par_id3166450" xml-lang="en-US" localize="false">8</paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3152877" xml-lang="en-US">Row2</paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3152949" xml-lang="en-US">Row number in the lower-right corner of the cell area; numbering starts at 0.</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> + <paragraph role="paragraph" id="par_id3159270" xml-lang="en-US" localize="false">10</paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3154107" xml-lang="en-US">Tab2</paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3153747" xml-lang="en-US">Table number in the lower-right corner of the cell area; numbering starts at 0.</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> + <paragraph role="paragraph" id="par_id3149924" xml-lang="en-US" localize="false">12</paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3154858" xml-lang="en-US">Count</paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3148621" xml-lang="en-US">Number of the following elements. Empty cells are not counted or passed.</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> + <paragraph role="paragraph" id="par_id3148467" xml-lang="en-US" localize="false">14</paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3151126" xml-lang="en-US">Col</paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3154334" xml-lang="en-US">Column number of the element. Numbering starts at 0.</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> + <paragraph role="paragraph" id="par_id3149416" xml-lang="en-US" localize="false">16</paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3150631" xml-lang="en-US">Row</paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3150424" xml-lang="en-US">Row number of the element; numbering starts at 0.</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> + <paragraph role="paragraph" id="par_id3154797" xml-lang="en-US" localize="false">18</paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3143274" xml-lang="en-US">Tab</paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3149513" xml-lang="en-US">Table number of the element; numbering starts at 0.</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> + <paragraph role="paragraph" id="par_id3145306" xml-lang="en-US" localize="false">20</paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3153948" xml-lang="en-US">Error</paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3153534" xml-lang="en-US">Error number, where the value 0 is defined as "no error." If the element comes from a formula cell the error value is determined by the formula.</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> + <paragraph role="paragraph" id="par_id3153311" xml-lang="en-US" localize="false">22</paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3148695" xml-lang="en-US">Len</paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3152769" xml-lang="en-US">Length of the following string, including closing zero byte. If the length including closing zero byte equals an odd value a second zero byte is added to the string so that an even value is achieved. Therefore, Len is calculated using ((StrLen+2)&~1).</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> + <paragraph role="paragraph" id="par_id3153772" xml-lang="en-US" localize="false">24</paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3153702" xml-lang="en-US">String</paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3154474" xml-lang="en-US">String with closing zero byte</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> + <paragraph role="paragraph" id="par_id3156269" xml-lang="en-US" localize="false">24+Len</paragraph> +</tablecell> +<tablecell> + <paragraph role="paragraph" id="par_id3154825" xml-lang="en-US" localize="false">...</paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3147097" xml-lang="en-US">Next element</paragraph> +</tablecell> +</tablerow> +</table> + +<h3 id="hd_id3159091">Cell Array</h3> +<paragraph role="paragraph" id="par_id3156140" xml-lang="en-US">Cell arrays are used to call cell areas containing text as well as numbers. A cell array in $[officename] Calc is defined as follows:</paragraph> +<table id="tbl_id3150942"> +<tablerow> +<tablecell> +<paragraph role="tablehead" id="par_id3154664" xml-lang="en-US">Offset</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablehead" id="par_id3154566" xml-lang="en-US">Name</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablehead" id="par_id3146073" xml-lang="en-US">Description</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> + <paragraph role="paragraph" id="par_id3154117" xml-lang="en-US" localize="false">0</paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3150988" xml-lang="en-US">Col1</paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3146783" xml-lang="en-US">Column number in the upper-left corner of the cell area. Numbering starts at 0.</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> + <paragraph role="paragraph" id="par_id3153666" xml-lang="en-US" localize="false">2</paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3149560" xml-lang="en-US">Row1</paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3156156" xml-lang="en-US">Row number in the upper-left corner of the cell area; numbering starts at 0.</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> + <paragraph role="paragraph" id="par_id3150408" xml-lang="en-US" localize="false">4</paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3150593" xml-lang="en-US">Tab1</paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3150357" xml-lang="en-US">Table number in the upper-left corner of the cell area; numbering starts at 0.</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> + <paragraph role="paragraph" id="par_id3146912" xml-lang="en-US" localize="false">6</paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3153352" xml-lang="en-US">Col2</paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3155893" xml-lang="en-US">Column number in the lower-right corner of the cell area. Numbering starts at 0.</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> + <paragraph role="paragraph" id="par_id3150827" xml-lang="en-US" localize="false">8</paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3148406" xml-lang="en-US">Row2</paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3150673" xml-lang="en-US">Row number in the lower-right corner of the cell area; numbering starts at 0.</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> + <paragraph role="paragraph" id="par_id3155864" xml-lang="en-US" localize="false">10</paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3153197" xml-lang="en-US">Tab2</paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3149329" xml-lang="en-US">Table number in the lower-right corner of the cell area; numbering starts at 0.</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> + <paragraph role="paragraph" id="par_id3147360" xml-lang="en-US" localize="false">12</paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3154520" xml-lang="en-US">Count</paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3150647" xml-lang="en-US">Number of the following elements. Empty cells are not counted or passed.</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> + <paragraph role="paragraph" id="par_id3149747" xml-lang="en-US" localize="false">14</paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3147579" xml-lang="en-US">Col</paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3154188" xml-lang="en-US">Column number of the element. Numbering starts at 0.</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> + <paragraph role="paragraph" id="par_id3159209" xml-lang="en-US" localize="false">16</paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3153265" xml-lang="en-US">Row</paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3150095" xml-lang="en-US">Row number of the element; numbering starts at 0.</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> + <paragraph role="paragraph" id="par_id3151276" xml-lang="en-US" localize="false">18</paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3149177" xml-lang="en-US">Tab</paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3146925" xml-lang="en-US">Table number of the element; numbering starts at 0.</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> + <paragraph role="paragraph" id="par_id3150488" xml-lang="en-US" localize="false">20</paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3149441" xml-lang="en-US">Error</paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3156048" xml-lang="en-US">Error number, where the value 0 is defined as "no error." If the element comes from a formula cell the error value is determined by the formula.</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> + <paragraph role="paragraph" id="par_id3163813" xml-lang="en-US" localize="false">22</paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3159102" xml-lang="en-US">Type</paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3149581" xml-lang="en-US">Type of cell content, 0 == Double, 1 == String</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> + <paragraph role="paragraph" id="par_id3155182" xml-lang="en-US" localize="false">24</paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3153291" xml-lang="en-US">Value or Len</paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3148560" xml-lang="en-US">If type == 0: 8 byte IEEE variable of type double/floating point</paragraph> +<paragraph role="paragraph" id="par_id3148901" xml-lang="en-US">If type == 1: Length of the following string, including closing zero byte. If the length including closing zero byte equals an odd value a second zero byte is added to the string so that an even value is achieved. Therefore, Len is calculated using ((StrLen+2)&~1).</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph role="paragraph" id="par_id3145215" xml-lang="en-US">26 if type==1</paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3155143" xml-lang="en-US">String</paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3149298" xml-lang="en-US">If type == 1: String with closing zero byte</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph role="paragraph" id="par_id3151322" xml-lang="en-US">32 or 26+Len</paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3163722" xml-lang="en-US">...</paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3151059" xml-lang="en-US">Next element</paragraph> +</tablecell> +</tablerow> +</table> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/04060115.xhp b/helpcontent2/source/text/scalc/01/04060115.xhp new file mode 100644 index 000000000..f62e4d2a2 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/04060115.xhp @@ -0,0 +1,428 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . +--> + +<meta> + <topic id="textscalc0104060115xml" indexer="include"> + <title id="tit" xml-lang="en-US">Add-in Functions, List of Analysis Functions Part One</title> + <filename>/text/scalc/01/04060115.xhp</filename> + </topic> +</meta> + +<body> + +<bookmark xml-lang="en-US" branch="index" id="bm_id3152871"> + <bookmark_value>add-ins; analysis functions</bookmark_value> + <bookmark_value>analysis functions</bookmark_value> +</bookmark> + +<h1 id="hd_id3152871"><variable id="head_addin_analysis_one"><link href="text/scalc/01/04060115.xhp" name="Add-in Functions, List of Analysis Functions Part One">Add-in Functions, List of Analysis Functions Part One</link></variable></h1> +<note id="par_id961592361784406">The Add-in functions are supplied by the <link href="text/sbasic/shared/calc_functions.xhp" name="addinanalysis">UNO <literal>com.sun.star.sheet.addin.Analysis</literal> service</link>.</note> +<section id="howtoget"> +<embed href="text/scalc/00/00000404.xhp#addinana"/> +</section> +<sort order="asc" descendant="h2"> + +<section id="besseli"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3153074"> + <bookmark_value>Bessel functions</bookmark_value> + <bookmark_value>BESSELI function</bookmark_value> +</bookmark> + +<bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_BESSELI" id="bm_id3150435" localize="false"/> + +<h2 id="hd_id3153334">BESSELI</h2> +<paragraph id="par_id3153960" role="paragraph" xml-lang="en-US"><ahelp hid="HID_AAI_FUNC_BESSELI">Calculates the modified Bessel function of the first kind In(x).</ahelp></paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3147295" role="code" xml-lang="en-US">BESSELI(X; N)</paragraph> +<paragraph id="par_id3151338" role="paragraph" xml-lang="en-US"> <emph>X</emph> is the value on which the function will be calculated.</paragraph> +<paragraph id="par_id3151392" role="paragraph" xml-lang="en-US"> <emph>N</emph> is a positive integer (N >= 0) representing the order of the Bessel function In(x)</paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id050220171019072404" role="paragraph" xml-lang="en-US">=BESSELI(3.45, 4), returns 0.651416873060081</paragraph> +<paragraph id="par_id050220171019072953" role="paragraph" xml-lang="en-US">=BESSELI(3.45, 4.333), returns 0.651416873060081, same as above because the fractional part of N is ignored.</paragraph> +<paragraph id="par_id050220171019075086" role="paragraph" xml-lang="en-US">=BESSELI(-1, 3), returns -0.022168424924332</paragraph> +</section> + +<section id="besselj"> +<bookmark xml-lang="en-US" branch="index" id="bm_id161618267677640"> + <bookmark_value>BESSELJ function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_BESSELJ" id="bm_id3150539" localize="false"/> + +<h2 id="hd_id3153027">BESSELJ</h2> +<paragraph id="par_id3153015" role="paragraph" xml-lang="en-US"><ahelp hid="HID_AAI_FUNC_BESSELJ">Calculates the Bessel function of the first kind Jn(x) (cylinder function).</ahelp></paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3150032" role="code" xml-lang="en-US">BESSELJ(X; N)</paragraph> +<paragraph id="par_id3150378" role="paragraph" xml-lang="en-US"> <emph>X</emph> is the value on which the function will be calculated.</paragraph> +<paragraph id="par_id3145638" role="paragraph" xml-lang="en-US"> <emph>N</emph> is a positive integer (N >= 0) representing the order of the Bessel function Jn(x)</paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id050220171019077179" role="paragraph" xml-lang="en-US">=BESSELJ(3.45, 4), returns 0.196772639864984</paragraph> +<paragraph id="par_id050220171019078280" role="paragraph" xml-lang="en-US">=BESSELJ(3.45, 4.333), returns 0.196772639864984, same as above because the fractional part of N is ignored.</paragraph> +<paragraph id="par_id050220171019079818" role="paragraph" xml-lang="en-US">=BESSELJ(-1, 3), returns -0.019563353982668</paragraph> +</section> + +<section id="besselk"> +<bookmark xml-lang="en-US" branch="index" id="bm_id151618267791726"> + <bookmark_value>BESSELK function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_BESSELK" id="bm_id3147616" localize="false"/> + +<h2 id="hd_id3149946">BESSELK</h2> +<paragraph id="par_id3159122" role="paragraph" xml-lang="en-US"><ahelp hid="HID_AAI_FUNC_BESSELK">Calculates the modified Bessel function of the second kind Kn(x).</ahelp></paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3149354" role="code" xml-lang="en-US">BESSELK(X; N)</paragraph> +<paragraph id="par_id3150481" role="paragraph" xml-lang="en-US"> <emph>X</emph> is the strictly positive value (X > 0) on which the function will be calculated.</paragraph> +<paragraph id="par_id3150024" role="paragraph" xml-lang="en-US"> <emph>N</emph> is a positive integer (N >= 0) representing the order of the Bessel function Kn(x)</paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id050220171019073898" role="paragraph" xml-lang="en-US">=BESSELK(3.45, 4), returns 0.144803466373734</paragraph> +<paragraph id="par_id050220171019079889" role="paragraph" xml-lang="en-US">=BESSELK(3.45, 4.333), returns 0.144803466373734, same as above because the fractional part of N is ignored.</paragraph> +<paragraph id="par_id050220171019076471" role="paragraph" xml-lang="en-US">=BESSELK(0, 3), returns Err:502 – invalid argument (X=0)</paragraph> +</section> + +<section id="bessely"> +<bookmark xml-lang="en-US" branch="index" id="bm_id201618267836525"> + <bookmark_value>BESSELY function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_BESSELY" id="bm_id3150461" localize="false"/> + +<h2 id="hd_id3145828">BESSELY</h2> +<paragraph id="par_id3146877" role="paragraph" xml-lang="en-US"><ahelp hid="HID_AAI_FUNC_BESSELY">Calculates the Bessel function of the second kind Yn(x).</ahelp></paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3148884" role="code" xml-lang="en-US">BESSELY(X; N)</paragraph> +<paragraph id="par_id3147475" role="paragraph" xml-lang="en-US"> <emph>X</emph> is the strictly positive value (X > 0) on which the function will be calculated.</paragraph> +<paragraph id="par_id3147421" role="paragraph" xml-lang="en-US"> <emph>N</emph> is a positive integer (N >= 0) representing the order of the Bessel function Yn(x)</paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id050220171019081114" role="paragraph" xml-lang="en-US">=BESSELY(3.45, 4), returns -0.679848116844476</paragraph> +<paragraph id="par_id050220171019081288" role="paragraph" xml-lang="en-US">=BESSELY(3.45, 4.333), returns -0.679848116844476, same as above because the fractional part of N is ignored.</paragraph> +<paragraph id="par_id050220171019082347" role="paragraph" xml-lang="en-US">=BESSELY(0, 3), returns Err:502 – invalid argument (X=0)</paragraph> +</section> + +<section id="bin2dec"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3153034"> + <bookmark_value>BIN2DEC function</bookmark_value> + <bookmark_value>converting;binary numbers, into decimal numbers</bookmark_value> +</bookmark> +<comment>mw added one entry</comment> +<bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_BIN2DEC" id="bm_id3151230" localize="false"/> + +<h2 id="hd_id3153034">BIN2DEC</h2> +<paragraph id="par_id3144744" role="paragraph" xml-lang="en-US"><ahelp hid="HID_AAI_FUNC_BIN2DEC">The result is the number for the binary (base-2) number string entered.</ahelp></paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3149726" role="code" xml-lang="en-US">BIN2DEC(Number)</paragraph> +<paragraph id="par_id3150142" role="paragraph" xml-lang="en-US"> <emph>Number</emph> is a string representing a binary (base-2) number. It can have a maximum of 10 places (bits). The most significant bit is the sign bit. Negative numbers are entered as two's complement.</paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3145138" role="paragraph" xml-lang="en-US"><item type="input">=BIN2DEC("1100100")</item> returns 100.</paragraph> +</section> + +<section id="bin2hex"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3149954"> + <bookmark_value>BIN2HEX function</bookmark_value> + <bookmark_value>converting;binary numbers, into hexadecimal numbers</bookmark_value> +</bookmark> +<comment>mw added one entry</comment> +<bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_BIN2HEX" id="bm_id3149548" localize="false"/> + +<h2 id="hd_id3149954">BIN2HEX</h2> +<paragraph id="par_id3148585" role="paragraph" xml-lang="en-US"><ahelp hid="HID_AAI_FUNC_BIN2HEX">The result is the string representing the number in hexadecimal form for the binary (base-2) number string entered.</ahelp></paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3148753" role="code" xml-lang="en-US">BIN2HEX(Number [; Places])</paragraph> +<paragraph id="par_id3155255" role="paragraph" xml-lang="en-US"><emph>Number</emph> is a string representing a binary (base-2) number. It can have a maximum of 10 places (bits). The most significant bit is the sign bit. Negative numbers are entered as two's complement.</paragraph> +<paragraph id="par_id3150860" role="paragraph" xml-lang="en-US"><emph>Places</emph> means the number of places to be output.</paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3149686" role="paragraph" xml-lang="en-US"><item type="input">=BIN2HEX("1100100";6)</item> returns "000064".</paragraph> +</section> + +<section id="bin2oct"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3153332"> + <bookmark_value>BIN2OCT function</bookmark_value> + <bookmark_value>converting;binary numbers, into octal numbers</bookmark_value> +</bookmark> +<comment>mw added one entry</comment> +<bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_BIN2OCT" id="bm_id3146848" localize="false"/> + +<h2 id="hd_id3153332">BIN2OCT</h2> +<paragraph id="par_id3155951" role="paragraph" xml-lang="en-US"><ahelp hid="HID_AAI_FUNC_BIN2OCT">The result is the string representing the number in octal form for the binary (base-2) number string entered.</ahelp></paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3154508" role="code" xml-lang="en-US">BIN2OCT(Number [; Places])</paragraph> +<paragraph id="par_id3153567" role="paragraph" xml-lang="en-US"><emph>Number</emph> is a string representing a binary (base-2) number. It can have a maximum of 10 places (bits). The most significant bit is the sign bit. Negative numbers are entered as two's complement.</paragraph> +<paragraph id="par_id3155929" role="paragraph" xml-lang="en-US"><emph>Places</emph> means the number of places to be output.</paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3153733" role="paragraph" xml-lang="en-US"><item type="input">=BIN2OCT("1100100";4)</item> returns "0144".</paragraph> +</section> + +<section id="delta"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3150014"> + <bookmark_value>DELTA function</bookmark_value> + <bookmark_value>recognizing;equal numbers</bookmark_value> +</bookmark> +<comment>mw added one entry</comment> +<bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_DELTA" id="bm_id3149880" localize="false"/> + +<h2 id="hd_id3150014">DELTA</h2> +<paragraph id="par_id3148760" role="paragraph" xml-lang="en-US"><ahelp hid="HID_AAI_FUNC_DELTA">The result is TRUE (1) if both numbers, which are delivered as an argument, are equal, otherwise it is FALSE (0).</ahelp></paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3145247" role="paragraph" xml-lang="en-US">DELTA(Number1 [; Number2])</paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3151020" role="paragraph" xml-lang="en-US"> <item type="input">=DELTA(1;2)</item> returns 0.</paragraph> +</section> + +<section id="dec2bin"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3157971"> + <bookmark_value>DEC2BIN function</bookmark_value> + <bookmark_value>converting;decimal numbers, into binary numbers</bookmark_value> +</bookmark> +<comment>mw added one entry</comment> +<bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_DEC2BIN" id="bm_id3148389" localize="false"/> + +<h2 id="hd_id3157971">DEC2BIN</h2> +<paragraph id="par_id3153043" role="paragraph" xml-lang="en-US"><ahelp hid="HID_AAI_FUNC_DEC2BIN">The result is the string representing the number in binary (base-2) form for the number entered.</ahelp></paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3150569" role="code" xml-lang="en-US">DEC2BIN(Number [; Places])</paragraph> +<paragraph id="par_id3148768" role="paragraph" xml-lang="en-US"><emph>Number</emph> is a number between -512 and 511. If Number is negative, the function returns a binary number string with 10 characters. The most significant bit is the sign bit, the other 9 bits return the value.</paragraph> +<paragraph id="par_id3149537" role="paragraph" xml-lang="en-US"><emph>Places</emph> means the number of places to be output.</paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3150662" role="paragraph" xml-lang="en-US"><item type="input">=DEC2BIN(100;8)</item> returns "01100100".</paragraph> +</section> + +<section id="dec2hex"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3149388"> + <bookmark_value>DEC2HEX function</bookmark_value> + <bookmark_value>converting;decimal numbers, into hexadecimal numbers</bookmark_value> +</bookmark> +<comment>mw added one entr</comment> +<bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_DEC2HEX" id="bm_id3155513" localize="false"/> + +<h2 id="hd_id3149388">DEC2HEX</h2> +<paragraph id="par_id3149030" role="paragraph" xml-lang="en-US"><ahelp hid="HID_AAI_FUNC_DEC2HEX">The result is the string representing the number in hexadecimal form for the number entered.</ahelp></paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3147535" role="code" xml-lang="en-US">DEC2HEX(Number [; Places])</paragraph> +<paragraph id="par_id3152820" role="paragraph" xml-lang="en-US"><emph>Number</emph> is a number. If Number is negative, the function returns a hexadecimal number string with 10 characters (40 bits). The most significant bit is the sign bit, the other 39 bits return the value.</paragraph> +<paragraph id="par_id3153221" role="paragraph" xml-lang="en-US"><emph>Places</emph> means the number of places to be output.</paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3150476" role="paragraph" xml-lang="en-US"><item type="input">=DEC2HEX(100;4)</item> returns "0064".</paragraph> +</section> + +<section id="dec2oct"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3154948"> + <bookmark_value>DEC2OCT function</bookmark_value> + <bookmark_value>converting;decimal numbers, into octal numbers</bookmark_value> +</bookmark> +<comment>mw added one entr</comment> +<bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_DEC2OCT" id="bm_id3156260" localize="false"/> + +<h2 id="hd_id3154948">DEC2OCT</h2> +<paragraph id="par_id3153920" role="paragraph" xml-lang="en-US"><ahelp hid="HID_AAI_FUNC_DEC2OCT">The result is the string representing the number in octal form for the number entered.</ahelp></paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3148427" role="code" xml-lang="en-US">DEC2OCT(Number [; Places])</paragraph> +<paragraph id="par_id3155991" role="paragraph" xml-lang="en-US"><emph>Number</emph> is a number. If Number is negative, the function returns an octal number string with 10 characters (30 bits). The most significant bit is the sign bit, the other 29 bits return the value.</paragraph> +<paragraph id="par_id3152587" role="paragraph" xml-lang="en-US"><emph>Places</emph> means the number of places to be output.</paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3154317" role="paragraph" xml-lang="en-US"><item type="input">=DEC2OCT(100;4)</item> returns "0144".</paragraph> +</section> + +<section id="erf"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3083446"> + <bookmark_value>ERF function</bookmark_value> + <bookmark_value>Gaussian error integral</bookmark_value> +</bookmark> +<comment>mw added one entr</comment> +<bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_ERF" id="bm_id3149823" localize="false"/> + +<h2 id="hd_id3083446">ERF</h2> +<paragraph id="par_id3150381" role="paragraph" xml-lang="en-US"><ahelp hid="HID_AAI_FUNC_ERF">Returns values of the Gaussian error integral.</ahelp></paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3163824" role="code" xml-lang="en-US">ERF(LowerLimit [; UpperLimit])</paragraph> +<paragraph id="par_id3149715" role="paragraph" xml-lang="en-US"> <emph>LowerLimit</emph> is the lower limit of the integral.</paragraph> +<paragraph id="par_id3156294" role="paragraph" xml-lang="en-US"> <emph>UpperLimit</emph> is optional. It is the upper limit of the integral. If this value is missing, the calculation takes place between 0 and the lower limit.</paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3152974" role="paragraph" xml-lang="en-US"> <item type="input">=ERF(0;1)</item> returns 0.842701.</paragraph> +</section> + +<section id="erfdotprecise"> +<bookmark xml-lang="en-US" branch="index" id="bm_id2983446"> + <bookmark_value>ERF.PRECISE function</bookmark_value> + <bookmark_value>Gaussian error integral</bookmark_value> +</bookmark> + +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_ERF_MS" id="bm_id2949823" localize="false"/> + +<h2 id="hd_id2983446">ERF.PRECISE</h2> +<paragraph id="par_id2950381" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_ERF_MS">Returns values of the Gaussian error integral between 0 and the given limit.</ahelp></paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id2963824" role="code" xml-lang="en-US">ERF.PRECISE(LowerLimit)</paragraph> +<paragraph id="par_id2949715" role="paragraph" xml-lang="en-US"><emph>LowerLimit</emph> is the limit of the integral. The calculation takes place between 0 and this limit.</paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id2952974" role="paragraph" xml-lang="en-US"> <item type="input">=ERF.PRECISE(1)</item> returns 0.842701.</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectiontechinfo"/> +<embed href="text/scalc/00/avail_release.xhp#4.3"/> +<embed href="text/scalc/01/common_func.xhp#notODFF"/> +<paragraph role="paragraph" id="par_id351640873986703" localize="false"><literal>COM.MICROSOFT.ERF.PRECISE</literal></paragraph> +</section> + +<section id="erfc"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3145082"> + <bookmark_value>ERFC function</bookmark_value> +</bookmark> + +<bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_ERFC" id="bm_id3156307" localize="false"/> + +<h2 id="hd_id3145082">ERFC</h2> +<paragraph id="par_id3149453" role="paragraph" xml-lang="en-US"><ahelp hid="HID_AAI_FUNC_ERFC">Returns complementary values of the Gaussian error integral between x and infinity.</ahelp></paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3153220" role="code" xml-lang="en-US">ERFC(LowerLimit)</paragraph> +<paragraph id="par_id3147620" role="paragraph" xml-lang="en-US"> <emph>LowerLimit</emph> is the lower limit of the integral</paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3156102" role="paragraph" xml-lang="en-US"> <item type="input">=ERFC(1)</item> returns 0.157299.</paragraph> +</section> + +<section id="erfcdotprecise"> +<bookmark xml-lang="en-US" branch="index" id="bm_id2945082"> + <bookmark_value>ERFC.PRECISE function</bookmark_value> +</bookmark> + +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_ERFC_MS" id="bm_id2956307" localize="false"/> + +<h2 id="hd_id2945082">ERFC.PRECISE</h2> +<paragraph id="par_id2949453" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_ERFC_MS">Returns complementary values of the Gaussian error integral between x and infinity.</ahelp></paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id2953220" role="code" xml-lang="en-US">ERFC.PRECISE(LowerLimit)</paragraph> +<paragraph id="par_id2947620" role="paragraph" xml-lang="en-US"> <emph>LowerLimit</emph> is the lower limit of the integral</paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id2956102" role="paragraph" xml-lang="en-US"> <item type="input">=ERFC.PRECISE(1)</item> returns 0.157299.</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectiontechinfo"/> +<embed href="text/scalc/00/avail_release.xhp#4.3"/> +<embed href="text/scalc/01/common_func.xhp#notODFF"/> +<paragraph role="paragraph" id="par_id341640853986703" localize="false"><literal>COM.MICROSOFT.ERFC.PRECISE</literal></paragraph> +</section> + +<section id="gestep"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3152927"> + <bookmark_value>GESTEP function</bookmark_value> + <bookmark_value>numbers;greater than or equal to</bookmark_value> +</bookmark> +<comment>mw added one entry</comment> +<bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_GESTEP" id="bm_id3151182" localize="false"/> + +<h2 id="hd_id3152927">GESTEP</h2> +<paragraph id="par_id3150763" role="paragraph" xml-lang="en-US"><ahelp hid="HID_AAI_FUNC_GESTEP">The result is 1 if <item type="literal">Number</item> is greater than or equal to <item type="literal">Step</item>.</ahelp></paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3145212" role="code" xml-lang="en-US">GESTEP(Number [; Step])</paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3156132" role="paragraph" xml-lang="en-US"> <item type="input">=GESTEP(5;1)</item> returns 1.</paragraph> +</section> + +<section id="hex2bin"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3147276"> + <bookmark_value>HEX2BIN function</bookmark_value> + <bookmark_value>converting;hexadecimal numbers, into binary numbers</bookmark_value> +</bookmark> +<comment>mw added one entry</comment> +<bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_HEX2BIN" id="bm_id3145659" localize="false"/> + +<h2 id="hd_id3147276">HEX2BIN</h2> +<paragraph id="par_id3150258" role="paragraph" xml-lang="en-US"><ahelp hid="HID_AAI_FUNC_HEX2BIN">The result is the string representing the number in binary (base-2) form for the hexadecimal number string entered.</ahelp></paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3155847" role="code" xml-lang="en-US">HEX2BIN(Number [; Places])</paragraph> +<paragraph id="par_id3152810" role="paragraph" xml-lang="en-US"><emph>Number</emph> is a string that represents a hexadecimal number. It can have a maximum of 10 places. The most significant bit is the sign bit, the following bits return the value. Negative numbers are entered as two's complement.</paragraph> +<paragraph id="par_id3153758" role="paragraph" xml-lang="en-US"><emph>Places</emph> is the number of places to be output.</paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3156002" role="paragraph" xml-lang="en-US"><item type="input">=HEX2BIN("6a";8)</item> returns "01101010".</paragraph> +</section> + +<section id="hex2dec"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3154742"> + <bookmark_value>HEX2DEC function</bookmark_value> + <bookmark_value>converting;hexadecimal numbers, into decimal numbers</bookmark_value> +</bookmark> +<comment>mw added one entry</comment> +<bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_HEX2DEC" id="bm_id3149978" localize="false"/> + +<h2 id="hd_id3154742">HEX2DEC</h2> +<paragraph id="par_id3153626" role="paragraph" xml-lang="en-US"><ahelp hid="HID_AAI_FUNC_HEX2DEC">The result is the number for the hexadecimal number string entered.</ahelp></paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3149293" role="code" xml-lang="en-US">HEX2DEC(Number)</paragraph> +<paragraph id="par_id3159176" role="paragraph" xml-lang="en-US"><emph>Number</emph> is a string that represents a hexadecimal number. It can have a maximum of 10 places. The most significant bit is the sign bit, the following bits return the value. Negative numbers are entered as two's complement.</paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3146093" role="paragraph" xml-lang="en-US"><item type="input">=HEX2DEC("6a")</item> returns 106.</paragraph> +</section> + +<section id="hex2oct"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3149750"> + <bookmark_value>HEX2OCT function</bookmark_value> + <bookmark_value>converting;hexadecimal numbers, into octal numbers</bookmark_value> +</bookmark> +<comment>mw added one entry</comment> +<bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_HEX2OCT" id="bm_id3147487" localize="false"/> + +<h2 id="hd_id3149750">HEX2OCT</h2> +<paragraph id="par_id3153983" role="paragraph" xml-lang="en-US"><ahelp hid="HID_AAI_FUNC_HEX2OCT">The result is the string representing the number in octal form for the hexadecimal number string entered.</ahelp></paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3151170" role="code" xml-lang="en-US">HEX2OCT(Number [; Places])</paragraph> +<paragraph id="par_id3152795" role="paragraph" xml-lang="en-US"><emph>Number</emph> is a string that represents a hexadecimal number. It can have a maximum of 10 places. The most significant bit is the sign bit, the following bits return the value. Negative numbers are entered as two's complement.</paragraph> +<paragraph id="par_id3149204" role="paragraph" xml-lang="en-US"><emph>Places</emph> is the number of places to be output.</paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3159341" role="paragraph" xml-lang="en-US"><item type="input">=HEX2OCT("6a";4)</item> returns "0152".</paragraph> +</section> +</sort> + +<section id="relatedtopics"> +<paragraph id="par_id3155751" role="paragraph" localize="false" xml-lang="en-US"><embedvar href="text/scalc/01/04060111.xhp#head_addin"/></paragraph> +<paragraph id="par_id3145324" role="paragraph" localize="false" xml-lang="en-US"><embedvar href="text/scalc/01/04060116.xhp#head_addin_analysis_two"/></paragraph> +<paragraph id="par_id3149873" role="paragraph" localize="false" xml-lang="en-US"><embedvar href="text/scalc/01/04060110.xhp#head_text"/></paragraph> +<paragraph id="par_id260920161551025898" role="paragraph" localize="false" xml-lang="en-US"><embedvar href="text/scalc/01/04060100.xhp#drking"/></paragraph> +</section> +</body> + +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/04060116.xhp b/helpcontent2/source/text/scalc/01/04060116.xhp new file mode 100644 index 000000000..ad42560a0 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/04060116.xhp @@ -0,0 +1,428 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> + +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . + --> + + +<meta> + <topic id="textscalc0104060116xml" indexer="include"> + <title xml-lang="en-US" id="tit">Add-in Functions, List of Analysis Functions Part Two</title> + <filename>/text/scalc/01/04060116.xhp</filename> + </topic> + </meta> + <body> +<bookmark xml-lang="en-US" branch="index" id="bm_id3145074"><bookmark_value>imaginary numbers in analysis functions</bookmark_value> + <bookmark_value>complex numbers in analysis functions</bookmark_value> +</bookmark> +<h1 id="hd_id3154659"><variable id="head_addin_analysis_two"><link href="text/scalc/01/04060116.xhp" name="Add-in Functions, List of Analysis Functions Part Two">Add-in Functions, List of Analysis Functions Part Two</link></variable></h1> +<note id="par_id961592361784406">The Add-in functions are supplied by the <link href="text/sbasic/shared/calc_functions.xhp" name="addinanalysis">UNO <literal>com.sun.star.sheet.addin.Analysis</literal> service</link>.</note> + <section id="howtoget"> + <embed href="text/scalc/00/00000404.xhp#addinana"/> + </section> +<sort order="asc" descendant="h2"> +<section id="imabs"> + <paragraph xml-lang="en-US" id="par_id3145074" role="paragraph" localize="false"/> +<bookmark xml-lang="en-US" branch="index" id="bm_id3154959"><bookmark_value>IMABS function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_IMABS" id="bm_id3154541" localize="false"/> +<h2 id="hd_id3154959">IMABS</h2> + <paragraph xml-lang="en-US" id="par_id3149895" role="paragraph"><ahelp hid="HID_AAI_FUNC_IMABS">The result is the absolute value of a complex number.</ahelp></paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph xml-lang="en-US" id="par_id3151302" role="code">IMABS("ComplexNumber")</paragraph> + <paragraph xml-lang="en-US" id="par_id3153974" role="paragraph"><variable id="complex"><emph>ComplexNumber</emph> is a complex number that is entered in the form "x+yi" or "x+yj". +</variable><comment>no blanks allowed, see i82522</comment></paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph xml-lang="en-US" id="par_id3143222" role="paragraph"> + <item type="input">=IMABS("5+12j")</item> returns 13.</paragraph> + </section> + <section id="imaginary"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3145357"><bookmark_value>IMAGINARY function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_IMAGINARY" id="bm_id3154651" localize="false"/> +<h2 id="hd_id3145357">IMAGINARY</h2> + <paragraph xml-lang="en-US" id="par_id3146965" role="paragraph"><ahelp hid="HID_AAI_FUNC_IMAGINARY">The result is the imaginary coefficient of a complex number.</ahelp></paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph xml-lang="en-US" id="par_id3155522" role="code">IMAGINARY("ComplexNumber")</paragraph> + <embed href="text/scalc/01/04060116.xhp#complex"/> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph xml-lang="en-US" id="par_id3155592" role="paragraph"> + <item type="input">=IMAGINARY("4+3j")</item> returns 3.</paragraph> + </section> + <section id="impower"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3146106"><bookmark_value>IMPOWER function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_IMPOWER" id="bm_id3155755" localize="false"/> +<h2 id="hd_id3146106">IMPOWER</h2> + <paragraph xml-lang="en-US" id="par_id3147245" role="paragraph"><ahelp hid="HID_AAI_FUNC_IMPOWER">The result is the <emph>ComplexNumber</emph> raised to the power of <emph>Number</emph>.</ahelp></paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph xml-lang="en-US" id="par_id3147501" role="code">IMPOWER("ComplexNumber"; Number)</paragraph> + <embed href="text/scalc/01/04060116.xhp#complex"/> + <paragraph xml-lang="en-US" id="par_id3155743" role="paragraph"> + <emph>Number</emph> is the exponent.</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph xml-lang="en-US" id="par_id3151393" role="paragraph"> + <item type="input">=IMPOWER("2+3i";2)</item> returns -5+12i.</paragraph> + </section> + <section id="imargument"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3148748"><bookmark_value>IMARGUMENT function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_IMARGUMENT" id="bm_id3147297" localize="false"/> +<h2 id="hd_id3148748">IMARGUMENT</h2> + <paragraph xml-lang="en-US" id="par_id3151341" role="paragraph"><ahelp hid="HID_AAI_FUNC_IMARGUMENT">The result is the argument (the phi angle) of a complex number.</ahelp></paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph xml-lang="en-US" id="par_id3156402" role="code">IMARGUMENT("ComplexNumber")</paragraph> + <embed href="text/scalc/01/04060116.xhp#complex"/> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph xml-lang="en-US" id="par_id3159125" role="paragraph"> + <item type="input">=IMARGUMENT("3+4j")</item> returns 0.927295.</paragraph> + </section> + <section id="imcos"> + <h2 id="hd_id69271214320055"> + <embedvar href="text/scalc/01/func_imcos.xhp#imcos_head"/> + </h2> + <paragraph id="par_id207971541015759" role="paragraph" localize="false" xml-lang="en-US"> + <embedvar href="text/scalc/01/func_imcos.xhp#imcos_des"/> + </paragraph> + </section> + <section id="imcosh"> + <h2 id="hd_id217971417131058"> + <embedvar href="text/scalc/01/func_imcosh.xhp#imcosh_head"/> + </h2> + <paragraph id="par_id6527438118584" role="paragraph" localize="false" xml-lang="en-US"> + <embedvar href="text/scalc/01/func_imcosh.xhp#imcosh_des"/> + </paragraph> + </section> + <section id="imcot"> + <h2 id="hd_id7625634121212"> + <embedvar href="text/scalc/01/func_imcot.xhp#imcot_head"/> + </h2> + <paragraph id="par_id13708154784779" role="paragraph" localize="false" xml-lang="en-US"> + <embedvar href="text/scalc/01/func_imcot.xhp#imcot_des"/> + </paragraph> + </section> + <section id="imcsc"> + <h2 id="hd_id2907192866882"> + <embedvar href="text/scalc/01/func_imcsc.xhp#imcsc_head"/> + </h2> + <paragraph id="par_id11614766524423" role="paragraph" localize="false" xml-lang="en-US"> + <embedvar href="text/scalc/01/func_imcsc.xhp#imcsc_des"/> + </paragraph> + </section> + <section id="imcsch"> + <h2 id="hd_id2111268313694"> + <embedvar href="text/scalc/01/func_imcsch.xhp#imcsch_head"/> + </h2> + <paragraph id="par_id15108118182663" role="paragraph" localize="false" xml-lang="en-US"> + <embedvar href="text/scalc/01/func_imcsch.xhp#imcsch_des"/> + </paragraph> + </section> + <section id="imdiv"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3150024"><bookmark_value>IMDIV function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_IMDIV" id="bm_id3154679" localize="false"/> +<h2 id="hd_id3150024">IMDIV</h2> + <paragraph xml-lang="en-US" id="par_id3145825" role="paragraph"><ahelp hid="HID_AAI_FUNC_IMDIV">The result is the division of two complex numbers.</ahelp></paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph xml-lang="en-US" id="par_id3146942" role="code">IMDIV("Numerator"; "Denominator")</paragraph> + <paragraph xml-lang="en-US" id="par_id3150741" role="paragraph"> + <emph>Numerator</emph>, <emph>Denominator</emph> are complex numbers that are entered in the form "x+yi" or "x+yj".</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph xml-lang="en-US" id="par_id3148440" role="paragraph"> + <item type="input">=IMDIV("-238+240i";"10+24i")</item> returns 5+12i.</paragraph> + </section> + <section id="imexp"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3153039"><bookmark_value>IMEXP function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_IMEXP" id="bm_id3147468" localize="false"/> +<h2 id="hd_id3153039">IMEXP</h2> + <paragraph xml-lang="en-US" id="par_id3144741" role="paragraph"><ahelp hid="HID_AAI_FUNC_IMEXP">The result is the power of e and the complex number.</ahelp> The constant e has a value of approximately 2.71828182845904.</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph xml-lang="en-US" id="par_id3154810" role="code">IMEXP("ComplexNumber")</paragraph> + <embed href="text/scalc/01/04060116.xhp#complex"/> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph xml-lang="en-US" id="par_id3149253" role="paragraph"> + <item type="input">=IMEXP("1+j") </item>returns 1.47+2.29j (rounded).</paragraph> + </section> + <section id="imconjugate"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3149955"><bookmark_value>IMCONJUGATE function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_IMCONJUGATE" id="bm_id3152782" localize="false"/> +<h2 id="hd_id3149955">IMCONJUGATE</h2> + <paragraph xml-lang="en-US" id="par_id3155263" role="paragraph"><ahelp hid="HID_AAI_FUNC_IMCONJUGATE">The result is the conjugated complex complement to a complex number.</ahelp></paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph xml-lang="en-US" id="par_id3153082" role="code">IMCONJUGATE("ComplexNumber")</paragraph> + <embed href="text/scalc/01/04060116.xhp#complex"/> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph xml-lang="en-US" id="par_id3149688" role="paragraph"> + <item type="input">=IMCONJUGATE("1+j")</item> returns 1-j.</paragraph> + </section> + <section id="imln"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3150898"><bookmark_value>IMLN function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_IMLN" id="bm_id3149190" localize="false"/> +<h2 id="hd_id3150898">IMLN</h2> + <paragraph xml-lang="en-US" id="par_id3146853" role="paragraph"><ahelp hid="HID_AAI_FUNC_IMLN">The result is the natural logarithm (to the base e) of a complex number.</ahelp> The constant e has a value of approximately 2.71828182845904.</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph xml-lang="en-US" id="par_id3155954" role="code">IMLN("ComplexNumber")</paragraph> + <embed href="text/scalc/01/04060116.xhp#complex"/> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph xml-lang="en-US" id="par_id3153736" role="paragraph"> + <item type="input">=IMLN("1+j")</item> returns 0.35+0.79j (rounded).</paragraph> + </section> + <section id="imlog10"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3155929"><bookmark_value>IMLOG10 function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_IMLOG10" id="bm_id3148765" localize="false"/> +<h2 id="hd_id3155929">IMLOG10</h2> + <paragraph xml-lang="en-US" id="par_id3149882" role="paragraph"><ahelp hid="HID_AAI_FUNC_IMLOG10">The result is the common logarithm (to the base 10) of a complex number.</ahelp></paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph xml-lang="en-US" id="par_id3150128" role="code">IMLOG10("ComplexNumber")</paragraph> + <embed href="text/scalc/01/04060116.xhp#complex"/> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph xml-lang="en-US" id="par_id3151021" role="paragraph"> + <item type="input">=IMLOG10("1+j")</item> returns 0.15+0.34j (rounded).</paragraph> + </section> + <section id="imlog2"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3155623"><bookmark_value>IMLOG2 function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_IMLOG2" id="bm_id3157975" localize="false"/> +<h2 id="hd_id3155623">IMLOG2</h2> + <paragraph xml-lang="en-US" id="par_id3150932" role="paragraph"><ahelp hid="HID_AAI_FUNC_IMLOG2">The result is the binary logarithm of a complex number.</ahelp></paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph xml-lang="en-US" id="par_id3145355" role="code">IMLOG2("ComplexNumber")</paragraph> + <embed href="text/scalc/01/04060116.xhp#complex"/> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph xml-lang="en-US" id="par_id3149536" role="paragraph"> + <item type="input">=IMLOG2("1+j")</item> returns 0.50+1.13j (rounded).</paragraph> + </section> + <section id="improduct"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3145626"><bookmark_value>IMPRODUCT function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_IMPRODUCT" id="bm_id3150661" localize="false"/> +<h2 id="hd_id3145626">IMPRODUCT</h2> + <paragraph xml-lang="en-US" id="par_id3153545" role="paragraph"><ahelp hid="HID_AAI_FUNC_IMPRODUCT">The result is the product of a set of complex numbers.</ahelp></paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph xml-lang="en-US" id="par_id3149027" role="code">IMPRODUCT(<embedvar href="text/scalc/01/ful_func.xhp#complex255_1" markup="keep"/>)</paragraph> + <embed href="text/scalc/01/ful_func.xhp#complex255"/> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph xml-lang="en-US" id="par_id3155815" role="paragraph"> + <item type="input">=IMPRODUCT("3+4j";"5-3j")</item> returns 27+11j.</paragraph> + </section> + <section id="imreal"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3147539"><bookmark_value>IMREAL function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_IMREAL" id="bm_id3148596" localize="false"/> +<h2 id="hd_id3147539">IMREAL</h2> + <paragraph xml-lang="en-US" id="par_id3155372" role="paragraph"><ahelp hid="HID_AAI_FUNC_IMREAL">The result is the real coefficient of a complex number.</ahelp></paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph xml-lang="en-US" id="par_id3153927" role="code">IMREAL("ComplexNumber")</paragraph> + <embed href="text/scalc/01/04060116.xhp#complex"/> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph xml-lang="en-US" id="par_id3155986" role="paragraph"> + <item type="input">=IMREAL("1+3j")</item> returns 1.</paragraph> + </section> + <section id="imcsec"> + <h2 id="hd_id882954222038"> + <embedvar href="text/scalc/01/func_imsec.xhp#imsec_head"/> + </h2> + <paragraph id="par_id25971292332203" role="paragraph" localize="false" xml-lang="en-US"> + <embedvar href="text/scalc/01/func_imsec.xhp#imsec_des"/> + </paragraph> + </section> + <section id="imcsech"> + <h2 id="hd_id25480538323169"> + <embedvar href="text/scalc/01/func_imsech.xhp#imsech_head"/> + </h2> + <paragraph id="par_id295081583312989" role="paragraph" localize="false" xml-lang="en-US"> + <embedvar href="text/scalc/01/func_imsech.xhp#imsech_des"/> + </paragraph> + </section> + <section id="imsin"> + <h2 id="hd_id14741462320337"> + <embedvar href="text/scalc/01/func_imsin.xhp#imsin_head"/> + </h2> + <paragraph id="par_id1856698528833" role="paragraph" localize="false" xml-lang="en-US"> + <embedvar href="text/scalc/01/func_imsin.xhp#imsin_des"/> + </paragraph> + </section> + <section id="imsinh"> + <h2 id="hd_id12978120123414"> + <embedvar href="text/scalc/01/func_imsinh.xhp#imsinh_head"/> + </h2> + <paragraph id="par_id21086201967951" role="paragraph" localize="false" xml-lang="en-US"> + <embedvar href="text/scalc/01/func_imsinh.xhp#imsinh_des"/> + </paragraph> + </section> + <section id="imtan"> + <h2 id="hd_id186491693515289"> + <embedvar href="text/scalc/01/func_imtan.xhp#imtan_head"/> + </h2> + <paragraph id="par_id184313129618659" role="paragraph" localize="false" xml-lang="en-US"> + <embedvar href="text/scalc/01/func_imtan.xhp#imtan_des"/> + </paragraph> + </section> + <section id="imsub"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3163826"><bookmark_value>IMSUB function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_IMSUB" id="bm_id3152481" localize="false"/> +<h2 id="hd_id3163826">IMSUB</h2> + <paragraph xml-lang="en-US" id="par_id3149277" role="paragraph"><ahelp hid="HID_AAI_FUNC_IMSUB">The result is the subtraction of two complex numbers.</ahelp></paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph xml-lang="en-US" id="par_id3149710" role="code">IMSUB("ComplexNumber1"; "ComplexNumber2")</paragraph> + <embed href="text/scalc/01/04060116.xhp#complex"/> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph xml-lang="en-US" id="par_id3150963" role="paragraph"> + <item type="input">=IMSUB("13+4j";"5+3j")</item> returns 8+j.</paragraph> + </section> + <section id="imsum"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3156312"><bookmark_value>IMSUM function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_IMSUM" id="bm_id3149454" localize="false"/> +<h2 id="hd_id3156312">IMSUM</h2> + <paragraph xml-lang="en-US" id="par_id3153215" role="paragraph"><ahelp hid="HID_AAI_FUNC_IMSUM">The result is the sum of a set of complex numbers.</ahelp></paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph xml-lang="en-US" id="par_id3152930" role="code">IMSUM(<embedvar href="text/scalc/01/ful_func.xhp#complex255_1" markup="keep"/>)</paragraph> + <embed href="text/scalc/01/ful_func.xhp#complex255"/> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph xml-lang="en-US" id="par_id3147081" role="paragraph"> + <item type="input">=IMSUM("13+4j";"5+3j")</item> returns 18+7j.</paragraph> + </section> + <section id="imsqrt"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3147570"><bookmark_value>IMSQRT function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_IMSQRT" id="bm_id3151189" localize="false"/> +<h2 id="hd_id3147570">IMSQRT</h2> + <paragraph xml-lang="en-US" id="par_id3156131" role="paragraph"><ahelp hid="HID_AAI_FUNC_IMSQRT">The result is the square root of a complex number.</ahelp></paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph xml-lang="en-US" id="par_id3150760" role="code">IMSQRT("ComplexNumber")</paragraph> + <embed href="text/scalc/01/04060116.xhp#complex"/> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph xml-lang="en-US" id="par_id3152807" role="paragraph"> + <item type="input">=IMSQRT("3+4i")</item> returns 2+1i.</paragraph> + </section> + <section id="complexfunc"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3154054"><bookmark_value>COMPLEX function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_COMPLEX" id="bm_id3156116" localize="false"/> +<h2 id="hd_id3154054">COMPLEX</h2> + <paragraph xml-lang="en-US" id="par_id3156111" role="paragraph"><ahelp hid="HID_AAI_FUNC_COMPLEX">The result is a complex number which is returned from a real coefficient and an imaginary coefficient.</ahelp></paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph xml-lang="en-US" id="par_id3155999" role="code">COMPLEX(RealNum; INum [; Suffix])</paragraph> + <paragraph xml-lang="en-US" id="par_id3153626" role="paragraph"> + <emph>RealNum</emph> is the real coefficient of the complex number.</paragraph> + <paragraph xml-lang="en-US" id="par_id3149135" role="paragraph"> + <emph>INum</emph> is the imaginary coefficient of the complex number.</paragraph> + <paragraph xml-lang="en-US" id="par_id3155849" role="paragraph"> + <emph>Suffix</emph> is a list of options, "i" or "j".</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph xml-lang="en-US" id="par_id3143229" role="paragraph"> + <item type="input">=COMPLEX(3;4;"j")</item> returns 3+4j.</paragraph> + </section> + <section id="oct2bin"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3155103"><bookmark_value>OCT2BIN function</bookmark_value> + <bookmark_value>converting;octal numbers, into binary numbers</bookmark_value> +</bookmark><comment>mw added one entry</comment> +<bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_OCT2BIN" id="bm_id3149290" localize="false"/> +<h2 id="hd_id3155103">OCT2BIN</h2> + <paragraph xml-lang="en-US" id="par_id3146898" role="paragraph"><ahelp hid="HID_AAI_FUNC_OCT2BIN">The result is the string representing the number in binary (base-2) form for the octal number string entered.</ahelp></paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph xml-lang="en-US" id="par_id3154303" role="code">OCT2BIN(Number [; Places])</paragraph> + <paragraph xml-lang="en-US" id="par_id3156013" role="paragraph"> + <emph>Number</emph> is a string that represents an octal number. It can have a maximum of 10 places. The most significant bit is the sign bit, the following bits return the value. Negative numbers are entered as two's complement.</paragraph> + <paragraph xml-lang="en-US" id="par_id3153984" role="paragraph"> + <emph>Places</emph> is the number of places to be output.</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph xml-lang="en-US" id="par_id3147260" role="paragraph"> + <item type="input">=OCT2BIN("3";3)</item> returns "011".</paragraph> + </section> + <section id="oct2dec"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3152791"><bookmark_value>OCT2DEC function</bookmark_value> + <bookmark_value>converting;octal numbers, into decimal numbers</bookmark_value> +</bookmark><comment>mw added one entry</comment> +<bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_OCT2DEZ" id="bm_id3151168" localize="false"/> +<h2 id="hd_id3152791">OCT2DEC</h2> + <paragraph xml-lang="en-US" id="par_id3149199" role="paragraph"><ahelp hid="HID_AAI_FUNC_OCT2DEZ">The result is the number for the octal number string entered.</ahelp></paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph xml-lang="en-US" id="par_id3153902" role="code">OCT2DEC(Number)</paragraph> + <paragraph xml-lang="en-US" id="par_id3155326" role="paragraph"> + <emph>Number</emph> is a string that represents an octal number. It can have a maximum of 10 places. The most significant bit is the sign bit, the following bits return the value. Negative numbers are entered as two's complement.</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph xml-lang="en-US" id="par_id3154930" role="paragraph"> + <item type="input">=OCT2DEC("144")</item> returns 100.</paragraph> + </section> + <section id="oct2hex"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3155391"><bookmark_value>OCT2HEX function</bookmark_value> + <bookmark_value>converting;octal numbers, into hexadecimal numbers</bookmark_value> +</bookmark><comment>mw added one entry</comment> +<bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_OCT2HEX" id="bm_id3149904" localize="false"/> +<h2 id="hd_id3155391">OCT2HEX</h2> + <paragraph xml-lang="en-US" id="par_id3148831" role="paragraph"><ahelp hid="HID_AAI_FUNC_OCT2HEX">The result is the string representing the number in hexadecimal form for the octal number string entered.</ahelp></paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph xml-lang="en-US" id="par_id3150523" role="code">OCT2HEX(Number [; Places])</paragraph> + <paragraph xml-lang="en-US" id="par_id3159162" role="paragraph"> + <emph>Number</emph> is a string that represents an octal number. It can have a maximum of 10 places. The most significant bit is the sign bit, the following bits return the value. Negative numbers are entered as two's complement.</paragraph> + <paragraph xml-lang="en-US" id="par_id3145420" role="paragraph"> + <emph>Places</emph> is the number of places to be output.</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph xml-lang="en-US" id="par_id3148802" role="paragraph"> + <item type="input">=OCT2HEX("144";4)</item> returns "0064".</paragraph> + </section> + + <section id="convert"> + <h2 id="hd_id14741462320147" localize="false"> + <embedvar href="text/scalc/01/func_convert.xhp#convert_head"/> + </h2> + <paragraph id="par_id1856698528077" role="paragraph" localize="false" xml-lang="en-US"> + <embedvar href="text/scalc/01/func_convert.xhp#convert_desc"/> + </paragraph> + </section> + + <section id="factdouble"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3147096"><bookmark_value>FACTDOUBLE function</bookmark_value> + <bookmark_value>factorials;numbers with increments of two</bookmark_value> +</bookmark><comment>mw added one entry</comment> +<bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_FACTDOUBLE" id="bm_id3150950" localize="false"/> +<h2 id="hd_id3147096">FACTDOUBLE</h2> + <paragraph xml-lang="en-US" id="par_id3151309" role="paragraph"><ahelp hid="HID_AAI_FUNC_FACTDOUBLE">Returns the double factorial of a number.</ahelp></paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph xml-lang="en-US" id="par_id3155121" role="code">FACTDOUBLE(Number)</paragraph> + <paragraph xml-lang="en-US" id="par_id3158440" role="paragraph">Returns <emph>Number</emph> + <emph>!!</emph>, the double factorial of <emph>Number</emph>, where <emph>Number</emph> is an integer greater than or equal to zero.</paragraph> + <paragraph xml-lang="en-US" id="par_id2480849" role="paragraph">For even numbers FACTDOUBLE(n) returns:</paragraph> + <paragraph xml-lang="en-US" id="par_id4181951" role="paragraph">2*4*6*8* ... *n</paragraph> + <paragraph xml-lang="en-US" id="par_id2927335" role="paragraph">For odd numbers FACTDOUBLE(n) returns:</paragraph> + <paragraph xml-lang="en-US" id="par_id2107303" role="paragraph">1*3*5*7* ... *n</paragraph> + <paragraph xml-lang="en-US" id="par_id4071779" role="paragraph">FACTDOUBLE(0) returns 1 by definition.</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph xml-lang="en-US" id="par_id7844477" role="paragraph"> + <item type="input">=FACTDOUBLE(5)</item> returns 15.</paragraph> + <paragraph xml-lang="en-US" id="par_id3154116" role="paragraph"> + <item type="input">=FACTDOUBLE(6)</item> returns 48.</paragraph> + <paragraph xml-lang="en-US" id="par_id6478469" role="paragraph"> + <item type="input">=FACTDOUBLE(0)</item> returns 1.</paragraph><comment>see also FACT, MULTINOMIAL, PRODUCT </comment> +</section> +</sort> +<section id="relatedtopics"> + <paragraph xml-lang="en-US" id="par_id3147072" role="paragraph" localize="false"><embedvar href="text/scalc/01/04060111.xhp#head_addin"/></paragraph> + <paragraph xml-lang="en-US" id="par_id3148869" role="paragraph" localize="false"><embedvar href="text/scalc/01/04060115.xhp#head_addin_analysis_one"/></paragraph> + <paragraph xml-lang="en-US" id="par_id3151242" role="paragraph" localize="false"><embedvar href="text/scalc/01/04060108.xhp#head_statistic"/></paragraph> + <paragraph id="par_id260920161704025898" role="paragraph" localize="false" xml-lang="en-US"><embedvar href="text/scalc/01/04060100.xhp#drking"/></paragraph> +</section> + </body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/04060118.xhp b/helpcontent2/source/text/scalc/01/04060118.xhp new file mode 100644 index 000000000..f2f89d146 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/04060118.xhp @@ -0,0 +1,606 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . +--> + +<meta> + <topic id="textscalc0104060118xml" indexer="include"> + <title id="tit" xml-lang="en-US">Financial Functions Part Three</title> + <filename>/text/scalc/01/04060118.xhp</filename> + </topic> +</meta> + +<body> + + +<h1 id="hd_id3146780">Financial Functions Part Three</h1> +<sort order="asc" descendant="h2"> + + +<section id="oddfprice"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3145112"> + <bookmark_value>ODDFPRICE function</bookmark_value> + <bookmark_value>prices;securities with irregular first interest date</bookmark_value> +</bookmark> +<comment>mw added one entry</comment> +<bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_ODDFPRICE" id="bm_id3146107" localize="false"/> + +<h2 id="hd_id3145112">ODDFPRICE</h2> +<paragraph id="par_id3147250" role="paragraph" xml-lang="en-US"><ahelp hid="HID_AAI_FUNC_ODDFPRICE">Calculates the price per 100 currency units par value of a security, if the first interest date falls irregularly.</ahelp></paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3146098" role="code" xml-lang="en-US">ODDFPRICE(Settlement; Maturity; Issue; FirstCoupon; Rate; Yield; Redemption; Frequency [; Basis])</paragraph> +<paragraph id="par_id3153337" role="paragraph" xml-lang="en-US"><emph>Settlement</emph> is the date of purchase of the security.</paragraph> +<paragraph id="par_id3149051" role="paragraph" xml-lang="en-US"><emph>Maturity</emph> is the date on which the security matures (expires).</paragraph> +<paragraph id="par_id3147297" role="paragraph" xml-lang="en-US"><emph>Issue</emph> is the date of issue of the security.</paragraph> +<paragraph id="par_id3150393" role="paragraph" xml-lang="en-US"><emph>FirstCoupon</emph> is the first interest date of the security.</paragraph> +<paragraph id="par_id3147402" role="paragraph" xml-lang="en-US"><emph>Rate</emph> is the annual rate of interest.</paragraph> +<paragraph id="par_id3151387" role="paragraph" xml-lang="en-US"><emph>Yield</emph> is the annual yield of the security.</paragraph> +<paragraph id="par_id3153023" role="paragraph" xml-lang="en-US"><emph>Redemption</emph> is the redemption value per 100 currency units of par value.</paragraph> +<paragraph id="par_id3150539" role="paragraph" xml-lang="en-US"><emph>Frequency</emph> is number of interest payments per year (1, 2 or 4).</paragraph> +<embed href="text/scalc/01/func_yearfrac.xhp#basis"/> +</section> + +<section id="oddfyield"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3157871"> + <bookmark_value>ODDFYIELD function</bookmark_value> +</bookmark> + +<bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_ODDFYIELD" id="bm_id3149723" localize="false"/> + +<h2 id="hd_id3157871">ODDFYIELD</h2> +<paragraph id="par_id3147414" role="paragraph" xml-lang="en-US"><ahelp hid="HID_AAI_FUNC_ODDFYIELD">Calculates the yield of a security if the first interest date falls irregularly.</ahelp></paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3152982" role="code" xml-lang="en-US">ODDFYIELD(Settlement; Maturity; Issue; FirstCoupon; Rate; Price; Redemption; Frequency [; Basis])</paragraph> +<paragraph id="par_id3157906" role="paragraph" xml-lang="en-US"><emph>Settlement</emph> is the date of purchase of the security.</paragraph> +<paragraph id="par_id3150026" role="paragraph" xml-lang="en-US"><emph>Maturity</emph> is the date on which the security matures (expires).</paragraph> +<paragraph id="par_id3149012" role="paragraph" xml-lang="en-US"><emph>Issue</emph> is the date of issue of the security.</paragraph> +<paragraph id="par_id3148725" role="paragraph" xml-lang="en-US"><emph>FirstCoupon</emph> is the first interest period of the security.</paragraph> +<paragraph id="par_id3150465" role="paragraph" xml-lang="en-US"><emph>Rate</emph> is the annual rate of interest.</paragraph> +<paragraph id="par_id3146940" role="paragraph" xml-lang="en-US"><emph>Price</emph> is the price of the security.</paragraph> +<paragraph id="par_id3149893" role="paragraph" xml-lang="en-US"><emph>Redemption</emph> is the redemption value per 100 currency units of par value.</paragraph> +<paragraph id="par_id3148888" role="paragraph" xml-lang="en-US"><emph>Frequency</emph> is number of interest payments per year (1, 2 or 4).</paragraph> +<embed href="text/scalc/01/func_yearfrac.xhp#basis"/> +</section> + +<section id="oddlprice"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3153933"> + <bookmark_value>ODDLPRICE function</bookmark_value> +</bookmark> + +<bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_ODDLPRICE" id="bm_id3145596" localize="false"/> + +<h2 id="hd_id3153933">ODDLPRICE</h2> +<paragraph id="par_id3145145" role="paragraph" xml-lang="en-US"><ahelp hid="HID_AAI_FUNC_ODDLPRICE">Calculates the price per 100 currency units par value of a security, if the last interest date falls irregularly.</ahelp></paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3155262" role="code" xml-lang="en-US">ODDLPRICE(Settlement; Maturity; LastInterest; Rate; Yield; Redemption; Frequency [; Basis])</paragraph> +<paragraph id="par_id3149689" role="paragraph" xml-lang="en-US"><emph>Settlement</emph> is the date of purchase of the security.</paragraph> +<paragraph id="par_id3148753" role="paragraph" xml-lang="en-US"><emph>Maturity</emph> is the date on which the security matures (expires).</paragraph> +<paragraph id="par_id3150861" role="paragraph" xml-lang="en-US"><emph>LastInterest</emph> is the last interest date of the security.</paragraph> +<paragraph id="par_id3155831" role="paragraph" xml-lang="en-US"><emph>Rate</emph> is the annual rate of interest.</paragraph> +<paragraph id="par_id3153328" role="paragraph" xml-lang="en-US"><emph>Yield</emph> is the annual yield of the security.</paragraph> +<paragraph id="par_id3149186" role="paragraph" xml-lang="en-US"><emph>Redemption</emph> is the redemption value per 100 currency units of par value.</paragraph> +<paragraph id="par_id3149726" role="paragraph" xml-lang="en-US"><emph>Frequency</emph> is number of interest payments per year (1, 2 or 4).</paragraph> +<embed href="text/scalc/01/func_yearfrac.xhp#basis"/> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3152999" role="paragraph" xml-lang="en-US">Settlement date: February 7 1999, maturity date: June 15 1999, last interest: October 15 1998. Interest rate: 3.75 per cent, yield: 4.05 per cent, redemption value: 100 currency units, frequency of payments: half-yearly = 2, basis: = 0</paragraph> +<paragraph id="par_id3148567" role="paragraph" xml-lang="en-US">The price per 100 currency units per value of a security, which has an irregular last interest date, is calculated as follows:</paragraph> +<paragraph id="par_id3150332" role="paragraph" xml-lang="en-US">=ODDLPRICE("1999-02-07";"1999-06-15";"1998-10-15"; 0.0375; 0.0405;100;2;0) returns 99.87829.</paragraph> +</section> + +<section id="oddlyield"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3153564"> + <bookmark_value>ODDLYIELD function</bookmark_value> +</bookmark> + +<bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_ODDLYIELD" id="bm_id3153732" localize="false"/> + +<h2 id="hd_id3153564">ODDLYIELD</h2> +<paragraph id="par_id3158002" role="paragraph" xml-lang="en-US"><ahelp hid="HID_AAI_FUNC_ODDLYIELD">Calculates the yield of a security if the last interest date falls irregularly.</ahelp></paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3150018" role="code" xml-lang="en-US">ODDLYIELD(Settlement; Maturity; LastInterest; Rate; Price; Redemption; Frequency [; Basis])</paragraph> +<paragraph id="par_id3159132" role="paragraph" xml-lang="en-US"><emph>Settlement</emph> is the date of purchase of the security.</paragraph> +<paragraph id="par_id3150134" role="paragraph" xml-lang="en-US"><emph>Maturity</emph> is the date on which the security matures (expires).</paragraph> +<paragraph id="par_id3145245" role="paragraph" xml-lang="en-US"><emph>LastInterest</emph> is the last interest date of the security.</paragraph> +<paragraph id="par_id3151014" role="paragraph" xml-lang="en-US"><emph>Rate</emph> is the annual rate of interest.</paragraph> +<paragraph id="par_id3149003" role="paragraph" xml-lang="en-US"><emph>Price</emph> is the price of the security.</paragraph> +<paragraph id="par_id3148880" role="paragraph" xml-lang="en-US"><emph>Redemption</emph> is the redemption value per 100 currency units of par value.</paragraph> +<paragraph id="par_id3155622" role="paragraph" xml-lang="en-US"><emph>Frequency</emph> is number of interest payments per year (1, 2 or 4).</paragraph> +<embed href="text/scalc/01/func_yearfrac.xhp#basis"/> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3145350" role="paragraph" xml-lang="en-US">Settlement date: April 20 1999, maturity date: June 15 1999, last interest: October 15 1998. Interest rate: 3.75 per cent, price: 99.875 currency units, redemption value: 100 currency units, frequency of payments: half-yearly = 2, basis: = 0</paragraph> +<paragraph id="par_id3157990" role="paragraph" xml-lang="en-US">The yield of the security, that has an irregular last interest date, is calculated as follows:</paragraph> +<paragraph id="par_id3150572" role="paragraph" xml-lang="en-US">=ODDLYIELD("1999-04-20";"1999-06-15"; "1998-10-15"; 0.0375; 99.875; 100;2;0) returns 0.044873 or 4.4873%.</paragraph> +</section> + +<section id="vdb"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3148768"> + <bookmark_value>calculating;variable declining depreciations</bookmark_value> + <bookmark_value>depreciations;variable declining</bookmark_value> + <bookmark_value>VDB function</bookmark_value> +</bookmark> + +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_VDB" id="bm_id3145624" localize="false"/> + +<h2 id="hd_id3148768">VDB</h2> +<paragraph id="par_id3154636" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_VDB">Returns the depreciation of an asset for a specified or partial period using a variable declining balance method.</ahelp></paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3149025" role="code" xml-lang="en-US">VDB(Cost; Salvage; Life; Start; End [; Factor [; NoSwitch]])</paragraph> +<paragraph id="par_id3150692" role="paragraph" xml-lang="en-US"><emph>Cost</emph> is the initial value of an asset.</paragraph> +<paragraph id="par_id3155369" role="paragraph" xml-lang="en-US"><emph>Salvage</emph> is the value of an asset at the end of the depreciation.</paragraph> +<paragraph id="par_id3154954" role="paragraph" xml-lang="en-US"><emph>Life</emph> is the depreciation duration of the asset.</paragraph> +<paragraph id="par_id3152817" role="paragraph" xml-lang="en-US"><emph>S</emph> is the start of the depreciation. A must be entered in the same date unit as the duration.</paragraph> +<paragraph id="par_id3153221" role="paragraph" xml-lang="en-US"><emph>End</emph> is the end of the depreciation.</paragraph> +<paragraph id="par_id3147536" role="paragraph" xml-lang="en-US"><emph>Factor</emph> (optional) is the depreciation factor. Factor = 2 is double rate depreciation.</paragraph> +<paragraph id="par_id3154865" role="paragraph" xml-lang="en-US"><emph>NoSwitch</emph>is an optional parameter. NoSwitch = 0 (default) means a switch to linear depreciation. In NoSwitch = 1 no switch is made.</paragraph> +<paragraph id="par_idN10A0D" role="paragraph" localize="false" xml-lang="en-US"><embedvar href="text/scalc/00/00000004.xhp#optional"/></paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3153927" role="paragraph" xml-lang="en-US">What is the declining-balance double-rate depreciation for a period if the initial cost is 35,000 currency units and the value at the end of the depreciation is 7,500 currency units. The depreciation period is 3 years. The depreciation from the 10th to the 20th period is calculated.</paragraph> +<paragraph id="par_id3155991" role="paragraph" xml-lang="en-US"><item type="input">=VDB(35000;7500;36;10;20;2)</item> = 8603.80 currency units. The depreciation during the period between the 10th and the 20th period is 8,603.80 currency units.</paragraph> +</section> + +<section id="xirr"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3147485"> + <bookmark_value>calculating;internal rates of return, irregular payments</bookmark_value> + <bookmark_value>internal rates of return;irregular payments</bookmark_value> + <bookmark_value>XIRR function</bookmark_value> +</bookmark> +<comment>mw changed "calculating;..." and "internal rates of return"</comment> +<bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_XIRR" id="bm_id3083443" localize="false"/> + +<h2 id="hd_id3147485">XIRR</h2> +<paragraph id="par_id3145614" role="paragraph" xml-lang="en-US"><ahelp hid="HID_AAI_FUNC_XIRR">Calculates the internal rate of return for a list of payments which take place on different dates.</ahelp> The calculation is based on a 365 days per year basis, ignoring leap years.</paragraph> +<paragraph id="par_idN10E62" role="paragraph" xml-lang="en-US">If the payments take place at regular intervals, use the <link href="text/scalc/01/04060103.xhp#irr" name="IRR">IRR</link> function.</paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3149826" role="code" xml-lang="en-US">XIRR(Values; Dates [; Guess])</paragraph> +<paragraph id="par_id3163821" role="paragraph" xml-lang="en-US"><emph>Values</emph> and <emph>Dates</emph> refer to a series of payments and the series of associated date values. The first pair of dates defines the start of the payment plan. All other date values must be later, but need not be in any order. The series of values must contain at least one negative and one positive value (receipts and deposits).</paragraph> +<paragraph id="par_id3149708" role="paragraph" xml-lang="en-US"><emph>Guess</emph> (optional) is a guess that can be input for the internal rate of return. The default is 10%.</paragraph> +<embed href="text/scalc/01/common_func.xhp#datenumbersequencenote"/> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3149273" role="paragraph" xml-lang="en-US">Calculation of the internal rate of return for the following five payments (dates are in ISO 8601 format):</paragraph> + +<table id="tbl_id3152970"> + <tablerow> + <tablecell> + </tablecell> + <tablecell> + <paragraph id="par_id3155838" role="tablehead" xml-lang="en-US" localize="false">A</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3152934" role="tablehead" xml-lang="en-US" localize="false">B</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3154638" role="tablehead" xml-lang="en-US" localize="false">C</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id3147083" role="tablehead" xml-lang="en-US" localize="false">1</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3151187" role="paragraph" xml-lang="en-US" localize="false">2001-01-01</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3145212" role="paragraph" xml-lang="en-US" localize="false">-10000</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3146856" role="paragraph" xml-lang="en-US">Received</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id3153277" role="tablehead" xml-lang="en-US" localize="false">2</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3154052" role="paragraph" xml-lang="en-US" localize="false">2001-02-01</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3151297" role="paragraph" xml-lang="en-US" localize="false">2000</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3149985" role="paragraph" xml-lang="en-US">Deposited</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id3154744" role="tablehead" xml-lang="en-US" localize="false">3</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3153151" role="paragraph" xml-lang="en-US" localize="false">2001-03-15</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3145657" role="paragraph" xml-lang="en-US" localize="false">2500</paragraph> + </tablecell> + <tablecell> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id3155101" role="tablehead" xml-lang="en-US" localize="false">4</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3146894" role="paragraph" xml-lang="en-US" localize="false">2001-05-12</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3143231" role="paragraph" xml-lang="en-US" localize="false">5000</paragraph> + </tablecell> + <tablecell> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id3156012" role="tablehead" xml-lang="en-US" localize="false">5</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3149758" role="paragraph" xml-lang="en-US" localize="false">2001-08-10</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3147495" role="paragraph" xml-lang="en-US" localize="false">1000</paragraph> + </tablecell> + <tablecell> + </tablecell> + </tablerow> +</table> + +<paragraph id="par_id3152793" role="paragraph" xml-lang="en-US"><input>=XIRR(B1:B5; A1:A5; 0.1)</input> returns 0.1828 or 18.28%.</paragraph> +</section> + +<section id="xnpv"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3149198"> + <bookmark_value>XNPV function</bookmark_value> +</bookmark> + +<bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_XNPV" id="bm_id3151172" localize="false"/> + +<h2 id="hd_id3149198">XNPV</h2> +<paragraph id="par_id3153904" role="paragraph" xml-lang="en-US"><ahelp hid="HID_AAI_FUNC_XNPV">Calculates the capital value (net present value) for a list of payments which take place on different dates.</ahelp> The calculation is based on a 365 days per year basis, ignoring leap years.</paragraph> +<paragraph id="par_idN11138" role="paragraph" xml-lang="en-US">If the payments take place at regular intervals, use the <link href="text/scalc/01/04060119.xhp#npv" name="NPV">NPV</link> function.</paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3150117" role="code" xml-lang="en-US">XNPV(Rate; Values; Dates)</paragraph> +<paragraph id="par_id3153100" role="paragraph" xml-lang="en-US"><emph>Rate</emph> is the internal rate of return for the payments.</paragraph> +<paragraph id="par_id3155395" role="paragraph" xml-lang="en-US"><emph>Values</emph> and <emph>Dates</emph> refer to a series of payments and the series of associated date values. The first pair of dates defines the start of the payment plan. All other date values must be later, but need not be in any order. The series of values must contain at least one negative and one positive value (receipts and deposits)</paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3150525" role="paragraph" xml-lang="en-US">Calculation of the net present value for the above-mentioned five payments for a national internal rate of return of 6%.</paragraph> +<paragraph id="par_id3149910" role="paragraph" xml-lang="en-US"><item type="input">=XNPV(0.06;B1:B5;A1:A5)</item> returns 323.02.</paragraph> +</section> + +<section id="rri"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3148822"> + <bookmark_value>calculating;rates of return</bookmark_value> + <bookmark_value>RRI function</bookmark_value> +</bookmark> + +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_ZGZ" id="bm_id3146996" localize="false"/> + +<h2 id="hd_id3148822">RRI</h2> +<paragraph id="par_id3154293" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_ZGZ">Calculates the interest rate resulting from the profit (return) of an investment.</ahelp></paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3148804" role="code" xml-lang="en-US">RRI(P; PV; FV)</paragraph> +<paragraph id="par_id3154901" role="paragraph" xml-lang="en-US"><emph>P</emph> is the number of periods needed for calculating the interest rate.</paragraph> +<paragraph id="par_id3159149" role="paragraph" xml-lang="en-US"><emph>PV</emph> is the present (current) value. The cash value is the deposit of cash or the current cash value of an allowance in kind. As a deposit value a positive value must be entered; the deposit must not be 0 or <0.</paragraph> +<paragraph id="par_id3149771" role="paragraph" xml-lang="en-US"><emph>FV</emph> determines what is desired as the cash value of the deposit.</paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3154212" role="paragraph" xml-lang="en-US">For four periods (years) and a cash value of 7,500 currency units, the interest rate of the return is to be calculated if the future value is 10,000 currency units.</paragraph> +<paragraph id="par_id3150775" role="paragraph" xml-lang="en-US"><item type="input">=RRI(4;7500;10000)</item> = 7.46 %</paragraph> +<paragraph id="par_id3145413" role="paragraph" xml-lang="en-US">The interest rate must be 7.46 % so that 7,500 currency units will become 10,000 currency units.</paragraph> +</section> + +<section id="rate"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3154267"> + <bookmark_value>calculating;constant interest rates</bookmark_value> + <bookmark_value>constant interest rates</bookmark_value> + <bookmark_value>RATE function</bookmark_value> +</bookmark> + +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_ZINS" id="bm_id3153581" localize="false"/> + +<h2 id="hd_id3154267">RATE</h2> +<paragraph id="par_id3151052" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_ZINS">Returns the constant interest rate per period of an annuity.</ahelp></paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3158423" role="code" xml-lang="en-US">RATE(NPer; Pmt; PV [ ; [ FV ] [ ; [ Type ] [ ; Guess ] ] ])</paragraph> +<paragraph id="par_id3148910" role="paragraph" xml-lang="en-US"><emph>NPer</emph> is the total number of periods, during which payments are made (payment period).</paragraph> +<paragraph id="par_id3148925" role="paragraph" xml-lang="en-US"><emph>Pmt</emph> is the constant payment (annuity) paid during each period.</paragraph> +<paragraph id="par_id3149160" role="paragraph" xml-lang="en-US"><emph>PV</emph> is the cash value in the sequence of payments.</paragraph> +<paragraph id="par_id3166456" role="paragraph" xml-lang="en-US"><emph>FV</emph> (optional) is the future value, which is reached at the end of the periodic payments.</paragraph> +<paragraph id="par_id3153243" role="paragraph" xml-lang="en-US"><emph>Type</emph> (optional) is the due date of the periodic payment, either at the beginning or at the end of a period.</paragraph> +<paragraph id="par_id3146949" role="paragraph" xml-lang="en-US"><emph>Guess</emph> (optional) determines the estimated value of the interest with iterative calculation.</paragraph> +<paragraph id="par_idN10E2A" role="paragraph" localize="false" xml-lang="en-US"><embedvar href="text/scalc/00/00000004.xhp#optional"/></paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3150706" role="paragraph" xml-lang="en-US">What is the constant interest rate for a payment period of 3 periods if 10 currency units are paid regularly and the present cash value is 900 currency units.</paragraph> +<paragraph id="par_id3155586" role="paragraph" xml-lang="en-US"><item type="input">=RATE(3;-10;900)</item> = -75.63% The interest rate is therefore 75.63%.</paragraph> +</section> + +<section id="intrate"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3149106"> + <bookmark_value>INTRATE function</bookmark_value> +</bookmark> + +<bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_INTRATE" id="bm_id3152944" localize="false"/> + +<h2 id="hd_id3149106">INTRATE</h2> +<paragraph id="par_id3149918" role="paragraph" xml-lang="en-US"><ahelp hid="HID_AAI_FUNC_INTRATE">Calculates the annual interest rate that results when a security (or other item) is purchased at an investment value and sold at a redemption value. No interest is paid.</ahelp></paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3149800" role="code" xml-lang="en-US">INTRATE(Settlement; Maturity; Investment; Redemption [; Basis])</paragraph> +<paragraph id="par_id3148618" role="paragraph" xml-lang="en-US"><emph>Settlement</emph> is the date of purchase of the security.</paragraph> +<paragraph id="par_id3148988" role="paragraph" xml-lang="en-US"><emph>Maturity</emph> is the date on which the security is sold.</paragraph> +<paragraph id="par_id3154604" role="paragraph" xml-lang="en-US"><emph>Investment</emph> is the purchase price.</paragraph> +<paragraph id="par_id3154337" role="paragraph" xml-lang="en-US"><emph>Redemption</emph> is the selling price.</paragraph> +<embed href="text/scalc/01/func_yearfrac.xhp#basis"/> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3149426" role="paragraph" xml-lang="en-US">A painting is bought on 1990-01-15 for 1 million and sold on 2002-05-05 for 2 million. The basis is daily balance calculation (basis = 3). What is the average annual level of interest?</paragraph> +<paragraph id="par_id3151125" role="paragraph" xml-lang="en-US">=INTRATE("1990-01-15"; "2002-05-05"; 1000000; 2000000; 3) returns 8.12%.</paragraph> +</section> + +<section id="coupncd"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3148654"> + <bookmark_value>COUPNCD function</bookmark_value> +</bookmark> + +<bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_COUPNCD" id="bm_id3148413" localize="false"/> + +<h2 id="hd_id3148654">COUPNCD</h2> +<paragraph id="par_id3149927" role="paragraph" xml-lang="en-US"><ahelp hid="HID_AAI_FUNC_COUPNCD">Returns the date of the first interest date after the settlement date. Format the result as a date.</ahelp></paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3150423" role="code" xml-lang="en-US">COUPNCD(Settlement; Maturity; Frequency [; Basis])</paragraph> +<paragraph id="par_id3150628" role="paragraph" xml-lang="en-US"><emph>Settlement</emph> is the date of purchase of the security.</paragraph> +<paragraph id="par_id3153536" role="paragraph" xml-lang="en-US"><emph>Maturity</emph> is the date on which the security matures (expires).</paragraph> +<paragraph id="par_id3145313" role="paragraph" xml-lang="en-US"><emph>Frequency</emph> is number of interest payments per year (1, 2 or 4).</paragraph> +<embed href="text/scalc/01/func_yearfrac.xhp#basis"/> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3154794" role="paragraph" xml-lang="en-US">A security is purchased on 2001-01-25; the date of maturity is 2001-11-15. Interest is paid half-yearly (frequency is 2). Using daily balance interest calculation (basis 3) when is the next interest date?</paragraph> +<paragraph id="par_id3159251" role="paragraph" xml-lang="en-US">=COUPNCD("2001-01-25"; "2001-11-15"; 2; 3) returns 2001-05-15.</paragraph> +</section> + +<section id="coupdays"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3143281"> + <bookmark_value>COUPDAYS function</bookmark_value> +</bookmark> + +<bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_COUPDAYS" id="bm_id3144759" localize="false"/> + +<h2 id="hd_id3143281">COUPDAYS</h2> +<paragraph id="par_id3149488" role="paragraph" xml-lang="en-US"><ahelp hid="HID_AAI_FUNC_COUPDAYS">Returns the number of days in the current interest period in which the settlement date falls.</ahelp></paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3149585" role="code" xml-lang="en-US">COUPDAYS(Settlement; Maturity; Frequency [; Basis])</paragraph> +<paragraph id="par_id3152767" role="paragraph" xml-lang="en-US"><emph>Settlement</emph> is the date of purchase of the security.</paragraph> +<paragraph id="par_id3151250" role="paragraph" xml-lang="en-US"><emph>Maturity</emph> is the date on which the security matures (expires).</paragraph> +<paragraph id="par_id3146126" role="paragraph" xml-lang="en-US"><emph>Frequency</emph> is number of interest payments per year (1, 2 or 4).</paragraph> +<embed href="text/scalc/01/func_yearfrac.xhp#basis"/> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3147530" role="paragraph" xml-lang="en-US">A security is purchased on 2001-01-25; the date of maturity is 2001-11-15. Interest is paid half-yearly (frequency is 2). Using daily balance interest calculation (basis 3) how many days are there in the interest period in which the settlement date falls?</paragraph> +<paragraph id="par_id3156338" role="paragraph" xml-lang="en-US">=COUPDAYS("2001-01-25"; "2001-11-15"; 2; 3) returns 181.</paragraph> +</section> + +<section id="coupdaysnc"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3154832"> + <bookmark_value>COUPDAYSNC function</bookmark_value> +</bookmark> + +<bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_COUPDAYSNC" id="bm_id3150941" localize="false"/> + +<h2 id="hd_id3154832">COUPDAYSNC</h2> +<paragraph id="par_id3147100" role="paragraph" xml-lang="en-US"><ahelp hid="HID_AAI_FUNC_COUPDAYSNC">Returns the number of days from the settlement date until the next interest date.</ahelp></paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3155121" role="code" xml-lang="en-US">COUPDAYSNC(Settlement; Maturity; Frequency [; Basis])</paragraph> +<paragraph id="par_id3158440" role="paragraph" xml-lang="en-US"><emph>Settlement</emph> is the date of purchase of the security.</paragraph> +<paragraph id="par_id3146075" role="paragraph" xml-lang="en-US"><emph>Maturity</emph> is the date on which the security matures (expires).</paragraph> +<paragraph id="par_id3154620" role="paragraph" xml-lang="en-US"><emph>Frequency </emph>is number of interest payments per year (1, 2 or 4).</paragraph> +<embed href="text/scalc/01/func_yearfrac.xhp#basis"/> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3148671" role="paragraph" xml-lang="en-US">A security is purchased on 2001-01-25; the date of maturity is 2001-11-15. Interest is paid half-yearly (frequency is 2). Using daily balance interest calculation (basis 3) how many days are there until the next interest payment?</paragraph> +<paragraph id="par_id3156158" role="paragraph" xml-lang="en-US">=COUPDAYSNC("2001-01-25"; "2001-11-15"; 2; 3) returns 110.</paragraph> +</section> + +<section id="coupdaybs"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3150408"> + <bookmark_value>COUPDAYBS function</bookmark_value> + <bookmark_value>durations;first interest payment until settlement date</bookmark_value> + <bookmark_value>securities;first interest payment until settlement date</bookmark_value> +</bookmark> +<comment>mw added "durations;" and "securities;"</comment> +<bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_COUPDAYBS" id="bm_id3153775" localize="false"/> + +<h2 id="hd_id3150408">COUPDAYBS</h2> +<paragraph id="par_id3146795" role="paragraph" xml-lang="en-US"><ahelp hid="HID_AAI_FUNC_COUPDAYBS">Returns the number of days from the first day of interest payment on a security until the settlement date.</ahelp></paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3159083" role="code" xml-lang="en-US">COUPDAYBS(Settlement; Maturity; Frequency [; Basis])</paragraph> +<paragraph id="par_id3146907" role="paragraph" xml-lang="en-US"><emph>Settlement</emph> is the date of purchase of the security.</paragraph> +<paragraph id="par_id3159390" role="paragraph" xml-lang="en-US"><emph>Maturity</emph> is the date on which the security matures (expires).</paragraph> +<paragraph id="par_id3154414" role="paragraph" xml-lang="en-US"><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"/> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3150592" role="paragraph" xml-lang="en-US">A security is purchased on 2001-01-25; the date of maturity is 2001-11-15. Interest is paid half-yearly (frequency is 2). Using daily balance interest calculation (basis 3) how many days is this?</paragraph> +<paragraph id="par_id3151103" role="paragraph" xml-lang="en-US">=COUPDAYBS("2001-01-25"; "2001-11-15"; 2; 3) returns 71.</paragraph> +</section> + +<section id="couppcd"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3152957"> + <bookmark_value>COUPPCD function</bookmark_value> + <bookmark_value>dates;interest date prior to settlement date</bookmark_value> +</bookmark> +<comment>mw added "dates;"</comment> +<bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_COUPPCD" id="bm_id3149553" localize="false"/> + +<h2 id="hd_id3152957">COUPPCD</h2> +<paragraph id="par_id3153678" role="paragraph" xml-lang="en-US"><ahelp hid="HID_AAI_FUNC_COUPPCD">Returns the date of the interest date prior to the settlement date. Format the result as a date.</ahelp></paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3153790" role="code" xml-lang="en-US">COUPPCD(Settlement; Maturity; Frequency [; Basis])</paragraph> +<paragraph id="par_id3150989" role="paragraph" xml-lang="en-US"><emph>Settlement</emph> is the date of purchase of the security.</paragraph> +<paragraph id="par_id3154667" role="paragraph" xml-lang="en-US"><emph>Maturity</emph> is the date on which the security matures (expires).</paragraph> +<paragraph id="par_id3154569" role="paragraph" xml-lang="en-US"><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"/> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3148968" role="paragraph" xml-lang="en-US">A security is purchased on 2001-01-25; the date of maturity is 2001-11-15. Interest is paid half-yearly (frequency is 2). Using daily balance interest calculation (basis 3) what was the interest date prior to purchase?</paragraph> +<paragraph id="par_id3149992" role="paragraph" xml-lang="en-US">=COUPPCD("2001-01-25"; "2001-11-15"; 2; 3) returns 2000-15-11.</paragraph> +</section> + +<section id="coupnum"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3150673"> + <bookmark_value>COUPNUM function</bookmark_value> + <bookmark_value>number of coupons</bookmark_value> +</bookmark> +<comment>mw added "number..."</comment> +<bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_COUPNUM" id="bm_id3153348" localize="false"/> + +<h2 id="hd_id3150673">COUPNUM</h2> +<paragraph id="par_id3154350" role="paragraph" xml-lang="en-US"><ahelp hid="HID_AAI_FUNC_COUPNUM">Returns the number of coupons (interest payments) between the settlement date and the maturity date.</ahelp></paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3153200" role="code" xml-lang="en-US">COUPNUM(Settlement; Maturity; Frequency [; Basis])</paragraph> +<paragraph id="par_id3159406" role="paragraph" xml-lang="en-US"><emph>Settlement</emph> is the date of purchase of the security.</paragraph> +<paragraph id="par_id3155864" role="paragraph" xml-lang="en-US"><emph>Maturity</emph> is the date on which the security matures (expires).</paragraph> +<paragraph id="par_id3154720" role="paragraph" xml-lang="en-US"><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"/> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3152460" role="paragraph" xml-lang="en-US">A security is purchased on 2001-01-25; the date of maturity is 2001-11-15. Interest is paid half-yearly (frequency is 2). Using daily balance interest calculation (basis 3) how many interest dates are there?</paragraph> +<paragraph id="par_id3150640" role="paragraph" xml-lang="en-US">=COUPNUM("2001-01-25"; "2001-11-15"; 2; 3) returns 2.</paragraph> +</section> + +<section id="ipmt"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3149339"> + <bookmark_value>IPMT function</bookmark_value> + <bookmark_value>periodic amortizement rates</bookmark_value> +</bookmark> +<comment>mw added "periodic..."</comment> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_ZINSZ" id="bm_id3149737" localize="false"/> + +<h2 id="hd_id3149339">IPMT</h2> +<paragraph id="par_id3154522" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_ZINSZ">Calculates the periodic amortizement for an investment with regular payments and a constant interest rate.</ahelp></paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3151283" role="code" xml-lang="en-US">IPMT(Rate; Period; NPer; PV [; FV [; Type]])</paragraph> +<paragraph id="par_id3147313" role="paragraph" xml-lang="en-US"><emph>Rate</emph> is the periodic interest rate.</paragraph> +<paragraph id="par_id3145158" role="paragraph" xml-lang="en-US"><emph>Period</emph> is the period, for which the compound interest is calculated. Period=NPER if compound interest for the last period is calculated.</paragraph> +<paragraph id="par_id3147577" role="paragraph" xml-lang="en-US"><emph>NPer</emph> is the total number of periods, during which annuity is paid.</paragraph> +<paragraph id="par_id3156211" role="paragraph" xml-lang="en-US"><emph>PV</emph> is the present cash value in sequence of payments.</paragraph> +<paragraph id="par_id3151213" role="paragraph" xml-lang="en-US"><emph>FV</emph> (optional) is the desired value (future value) at the end of the periods.</paragraph> +<paragraph id="par_id3154195" role="paragraph" xml-lang="en-US"><emph>Type</emph> is the due date for the periodic payments.</paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3149438" role="paragraph" xml-lang="en-US">What is the interest rate during the fifth period (year) if the constant interest rate is 5% and the cash value is 15,000 currency units? The periodic payment is seven years.</paragraph> +<paragraph id="par_id3150496" role="paragraph" xml-lang="en-US"><item type="input">=IPMT(5%;5;7;15000)</item> = -352.97 currency units. The compound interest during the fifth period (year) is 352.97 currency units.</paragraph> +</section> + +<section id="fv"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3151205"> + <bookmark_value>calculating;future values</bookmark_value> + <bookmark_value>future values;constant interest rates</bookmark_value> + <bookmark_value>FV function</bookmark_value> +</bookmark> +<comment>mw made "future values..." a two level entry</comment> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_ZW" id="bm_id3156049" localize="false"/> + +<h2 id="hd_id3151205">FV</h2> +<paragraph id="par_id3154140" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_ZW">Returns the future value of an investment based on periodic, constant payments and a constant interest rate (Future Value).</ahelp></paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3145215" role="code" xml-lang="en-US">FV(Rate; NPer; Pmt [ ; [ PV ] [ ; Type ] ])</paragraph> +<paragraph id="par_id3155136" role="paragraph" xml-lang="en-US"><emph>Rate</emph> is the periodic interest rate.</paragraph> +<paragraph id="par_id3156029" role="paragraph" xml-lang="en-US"><emph>NPer</emph> is the total number of periods (payment period).</paragraph> +<paragraph id="par_id3151322" role="paragraph" xml-lang="en-US"><emph>Pmt</emph> is the annuity paid regularly per period.</paragraph> +<paragraph id="par_id3145256" role="paragraph" xml-lang="en-US"><emph>PV</emph> (optional) is the (present) cash value of an investment.</paragraph> +<paragraph id="par_id3150999" role="paragraph" xml-lang="en-US"><emph>Type</emph> (optional) defines whether the payment is due at the beginning or the end of a period.</paragraph> +<paragraph id="par_idN114D8" role="paragraph" localize="false" xml-lang="en-US"><embedvar href="text/scalc/00/00000004.xhp#optional"/></paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3146813" role="paragraph" xml-lang="en-US">What is the value at the end of an investment if the interest rate is 4% and the payment period is two years, with a periodic payment of 750 currency units. The investment has a present value of 2,500 currency units.</paragraph> +<paragraph id="par_id3149302" role="paragraph" xml-lang="en-US"><item type="input">=FV(4%;2;750;2500) </item>= -4234.00 currency units. The value at the end of the investment is 4234.00 currency units.</paragraph> +</section> + +<section id="fvschedule"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3155912"> + <bookmark_value>FVSCHEDULE function</bookmark_value> + <bookmark_value>future values;varying interest rates</bookmark_value> +</bookmark> +<comment>mw added "future values"</comment> +<bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_FVSCHEDULE" id="bm_id3155341" localize="false"/> + +<h2 id="hd_id3155912">FVSCHEDULE</h2> +<paragraph id="par_id3163726" role="paragraph" xml-lang="en-US"><ahelp hid="HID_AAI_FUNC_FVSCHEDULE">Calculates the accumulated value of the starting capital for a series of periodically varying interest rates.</ahelp></paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3148891" role="code" xml-lang="en-US">FVSCHEDULE(Principal; Schedule)</paragraph> +<paragraph id="par_id3148904" role="paragraph" xml-lang="en-US"><emph>Principal</emph> is the starting capital.</paragraph> +<paragraph id="par_id3148562" role="paragraph" xml-lang="en-US"><emph>Schedule</emph> is a series of interest rates, for example, as a range H3:H5 or as a (List) (see example).</paragraph> +<embed href="text/scalc/01/common_func.xhp#datenumbersequencenote"/> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3148638" role="paragraph" xml-lang="en-US">1000 currency units have been invested in for three years. The interest rates were 3%, 4% and 5% per annum. What is the value after three years?</paragraph> +<paragraph id="par_id3156358" role="paragraph" xml-lang="en-US"><item type="input">=FVSCHEDULE(1000;{0.03;0.04;0.05})</item> returns 1124.76.</paragraph> +</section> + +<section id="nper"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3156435"> + <bookmark_value>calculating;number of payment periods</bookmark_value> + <bookmark_value>payment periods;number of</bookmark_value> + <bookmark_value>number of payment periods</bookmark_value> + <bookmark_value>NPER function</bookmark_value> +</bookmark> + +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_ZZR" id="bm_id3154917" localize="false"/> + +<h2 id="hd_id3156435">NPER</h2> +<paragraph id="par_id3152363" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_ZZR">Returns the number of periods for an investment based on periodic, constant payments and a constant interest rate.</ahelp></paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3155934" role="code" xml-lang="en-US">NPER(Rate; Pmt; PV [ ; [ FV ] [ ; Type ] ])</paragraph> +<paragraph id="par_id3155946" role="paragraph" xml-lang="en-US"><emph>Rate</emph> is the periodic interest rate.</paragraph> +<paragraph id="par_id3149042" role="paragraph" xml-lang="en-US"><emph>Pmt</emph> is the constant annuity paid in each period.</paragraph> +<paragraph id="par_id3153134" role="paragraph" xml-lang="en-US"><emph>PV</emph> is the present value (cash value) in a sequence of payments.</paragraph> +<paragraph id="par_id3154398" role="paragraph" xml-lang="en-US"><emph>FV</emph> (optional) is the future value, which is reached at the end of the last period.</paragraph> +<paragraph id="par_id3145127" role="paragraph" xml-lang="en-US"><emph>Type</emph> (optional) is the due date of the payment at the beginning or at the end of the period.</paragraph> +<paragraph id="par_idN1166C" role="paragraph" localize="false" xml-lang="en-US"><embedvar href="text/scalc/00/00000004.xhp#optional"/></paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3147378" role="paragraph" xml-lang="en-US">How many payment periods does a payment period cover with a periodic interest rate of 6%, a periodic payment of 153.75 currency units and a present cash value of 2.600 currency units.</paragraph> +<paragraph id="par_id3156171" role="paragraph" xml-lang="en-US"><item type="input">=NPER(6%;153.75;2600)</item> = -12,02. The payment period covers 12.02 periods.</paragraph> +</section> +</sort> +<paragraph id="par_id3150309" role="paragraph" xml-lang="en-US"><link href="text/scalc/01/04060103.xhp" name="Back to Financial Functions Part One">Back to Financial Functions Part One</link></paragraph> +<paragraph id="par_id3153163" role="paragraph" xml-lang="en-US"><link href="text/scalc/01/04060119.xhp" name="Back to Financial Functions Part Two">Back to Financial Functions Part Two</link></paragraph> +<embed href="text/scalc/01/04060100.xhp#drking"/> +</body> + +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/04060119.xhp b/helpcontent2/source/text/scalc/01/04060119.xhp new file mode 100644 index 000000000..ccf3e35ad --- /dev/null +++ b/helpcontent2/source/text/scalc/01/04060119.xhp @@ -0,0 +1,611 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> + +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . + --> + + +<meta> +<topic id="textscalc0104060119xml" indexer="include"> +<title id="tit" xml-lang="en-US">Financial Functions Part Two</title> +<filename>/text/scalc/01/04060119.xhp</filename> +</topic> +</meta> +<body> +<h1 id="hd_id3149052">Financial Functions Part Two</h1> +<section id="howtoget"> +<embed href="text/scalc/00/00000404.xhp#eikafi"/> +</section> +<paragraph role="paragraph" id="par_id3148742" xml-lang="en-US"><link href="text/scalc/01/04060103.xhp" name="Back to Financial Functions Part One">Back to Financial Functions Part One</link></paragraph> +<paragraph role="paragraph" id="par_id3151341" xml-lang="en-US"><link href="text/scalc/01/04060118.xhp" name="Forward to Financial Functions Part Three">Forward to Financial Functions Part Three</link></paragraph> +<sort order="asc" descendant="h2"> +<section id="ppmt"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3150026"><bookmark_value>PPMT function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_KAPZ" id="bm_id3145827" localize="false"/> +<h2 id="hd_id3150026">PPMT</h2> +<paragraph role="paragraph" id="par_id3146942" xml-lang="en-US"><ahelp hid="HID_FUNC_KAPZ">Returns for a given period the payment on the principal for an investment that is based on periodic and constant payments and a constant interest rate.</ahelp></paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph role="code" id="par_id3146878" xml-lang="en-US">PPMT(Rate; Period; NPer; PV [ ; FV [ ; Type ] ])</paragraph> +<paragraph role="paragraph" id="par_id3151228" xml-lang="en-US"> +<emph>Rate</emph> is the periodic interest rate.</paragraph> +<paragraph role="paragraph" id="par_id3148887" xml-lang="en-US"> +<emph>Period</emph> is the amortizement period. P = 1 for the first and P = NPer for the last period.</paragraph> +<paragraph role="paragraph" id="par_id3148436" xml-lang="en-US"> +<emph>NPer</emph> is the total number of periods during which annuity is paid.</paragraph> +<paragraph role="paragraph" id="par_id3153035" xml-lang="en-US"> +<emph>PV</emph> is the present value in the sequence of payments.</paragraph> +<paragraph role="paragraph" id="par_id3147474" xml-lang="en-US"> +<emph>FV</emph> (optional) is the desired (future) value.</paragraph> +<paragraph role="paragraph" id="par_id3144744" xml-lang="en-US"> +<emph>Type</emph> (optional) defines the due date. F = 1 for payment at the beginning of a period and F = 0 for payment at the end of a period.</paragraph> +<paragraph role="paragraph" id="par_idN1067C" xml-lang="en-US" localize="false"> + <embedvar href="text/scalc/00/00000004.xhp#optional"/> +</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph role="paragraph" id="par_id3154811" xml-lang="en-US">How high is the periodic monthly payment at an annual interest rate of 8.75% over a period of 3 years? The cash value is 5,000 currency units and is always paid at the beginning of a period. The future value is 8,000 currency units.</paragraph> +<paragraph role="paragraph" id="par_id3149246" xml-lang="en-US"> +<item type="input">=PPMT(8.75%/12;1;36;5000;8000;1)</item> = -350.99 currency units.</paragraph> +</section> +<section id="cumprinc"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3146139"><bookmark_value>calculating; total amortizement rates</bookmark_value> +<bookmark_value>total amortizement rates</bookmark_value> +<bookmark_value>amortization installment</bookmark_value> +<bookmark_value>repayment installment</bookmark_value> +<bookmark_value>CUMPRINC function</bookmark_value> +</bookmark><comment>mw added two entries</comment> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_KUMKAPITAL" id="bm_id3148754" localize="false"/> +<h2 id="hd_id3146139">CUMPRINC</h2> +<paragraph role="paragraph" id="par_id3150140" xml-lang="en-US"><ahelp hid="HID_FUNC_KUMKAPITAL">Returns the cumulative interest paid for an investment period with a constant interest rate.</ahelp></paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph role="code" id="par_id3148733" xml-lang="en-US">CUMPRINC(Rate; NPer; PV; S; E; Type)</paragraph> +<paragraph role="paragraph" id="par_id3150864" xml-lang="en-US"> +<emph>Rate</emph> is the periodic interest rate.</paragraph> +<paragraph role="paragraph" id="par_id3166052" xml-lang="en-US"> +<emph>NPer</emph> is the payment period with the total number of periods. NPER can also be a non-integer value.</paragraph> +<paragraph role="paragraph" id="par_id3150007" xml-lang="en-US"> +<emph>PV</emph> is the current value in the sequence of payments.</paragraph> +<paragraph role="paragraph" id="par_id3153112" xml-lang="en-US"> +<emph>S</emph> is the first period.</paragraph> +<paragraph role="paragraph" id="par_id3146847" xml-lang="en-US"> +<emph>E</emph> is the last period.</paragraph> +<paragraph role="paragraph" id="par_id3145167" xml-lang="en-US"> +<emph>Type</emph> is the due date of the payment at the beginning or end of each period.</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph role="paragraph" id="par_id3153570" xml-lang="en-US">What are the payoff amounts if the yearly interest rate is 5.5% for 36 months? The cash value is 15,000 currency units. The payoff amount is calculated between the 10th and 18th period. The due date is at the end of the period.</paragraph> +<paragraph role="paragraph" id="par_id3149884" xml-lang="en-US"> +<item type="input">=CUMPRINC(5.5%/12;36;15000;10;18;0)</item> = -3669.74 currency units. The payoff amount between the 10th and 18th period is 3669.74 currency units.</paragraph> +</section> +<section id="cumprinc_add"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3150019"><bookmark_value>CUMPRINC_ADD function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_CUMPRINC" id="bm_id3154330" localize="false"/> +<h2 id="hd_id3150019">CUMPRINC_ADD</h2> +<paragraph role="paragraph" id="par_id3145246" xml-lang="en-US"><ahelp hid="HID_AAI_FUNC_CUMPRINC"> Calculates the cumulative redemption of a loan in a period.</ahelp></paragraph> +<embed href="text/scalc/01/04060102.xhp#ADD_note"/> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph role="code" id="par_id3157970" xml-lang="en-US">CUMPRINC_ADD(Rate; NPer; PV; StartPeriod; EndPeriod; Type)</paragraph> +<paragraph role="paragraph" id="par_id3145302" xml-lang="en-US"> +<emph>Rate</emph> is the interest rate for each period.</paragraph> +<paragraph role="paragraph" id="par_id3151017" xml-lang="en-US"> +<emph>NPer</emph> is the total number of payment periods. The rate and NPER must refer to the same unit, and thus both be calculated annually or monthly.</paragraph> +<paragraph role="paragraph" id="par_id3155620" xml-lang="en-US"> +<emph>PV</emph> is the current value.</paragraph> +<paragraph role="paragraph" id="par_id3145352" xml-lang="en-US"> +<emph>StartPeriod</emph> is the first payment period for the calculation.</paragraph> +<paragraph role="paragraph" id="par_id3157986" xml-lang="en-US"> +<emph>EndPeriod</emph> is the last payment period for the calculation.</paragraph> +<paragraph role="paragraph" id="par_id3150570" xml-lang="en-US"> +<emph>Type</emph> is the maturity of a payment at the end of each period (Type = 0) or at the start of the period (Type = 1).</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph role="paragraph" id="par_id3148774" xml-lang="en-US">The following mortgage loan is taken out on a house:</paragraph> +<paragraph role="paragraph" id="par_id3150661" xml-lang="en-US">Rate: 9.00 per cent per annum (9% / 12 = 0.0075), Duration: 30 years (payment periods = 30 * 12 = 360), NPV: 125000 currency units.</paragraph> +<paragraph role="paragraph" id="par_id3155512" xml-lang="en-US">How much will you repay in the second year of the mortgage (thus from periods 13 to 24)?</paragraph> +<paragraph role="paragraph" id="par_id3149394" xml-lang="en-US"> +<item type="input">=CUMPRINC_ADD(0.0075;360;125000;13;24;0)</item> returns -934.1071</paragraph> +<paragraph role="paragraph" id="par_id3149026" xml-lang="en-US">In the first month you will be repaying the following amount:</paragraph> +<paragraph role="paragraph" id="par_id3154636" xml-lang="en-US"> +<item type="input">=CUMPRINC_ADD(0.0075;360;125000;1;1;0)</item> returns -68.27827</paragraph> +</section> +<section id="cumipmt"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3155370"><bookmark_value>calculating; accumulated interests</bookmark_value> +<bookmark_value>accumulated interests</bookmark_value> +<bookmark_value>CUMIPMT function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_KUMZINSZ" id="bm_id3148593" localize="false"/> +<h2 id="hd_id3155370">CUMIPMT</h2> +<paragraph role="paragraph" id="par_id3158411" xml-lang="en-US"><ahelp hid="HID_FUNC_KUMZINSZ">Calculates the cumulative interest payments, that is, the total interest, for an investment based on a constant interest rate.</ahelp></paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph role="code" id="par_id3147536" xml-lang="en-US">CUMIPMT(Rate; NPer; PV; S; E; Type)</paragraph> +<paragraph role="paragraph" id="par_id3150475" xml-lang="en-US"> +<emph>Rate</emph> is the periodic interest rate.</paragraph> +<paragraph role="paragraph" id="par_id3153921" xml-lang="en-US"> +<emph>NPer</emph> is the payment period with the total number of periods. NPER can also be a non-integer value.</paragraph> +<paragraph role="paragraph" id="par_id3153186" xml-lang="en-US"> +<emph>PV</emph> is the current value in the sequence of payments.</paragraph> +<paragraph role="paragraph" id="par_id3156259" xml-lang="en-US"> +<emph>S</emph> is the first period.</paragraph> +<paragraph role="paragraph" id="par_id3155990" xml-lang="en-US"> +<emph>E</emph> is the last period.</paragraph> +<paragraph role="paragraph" id="par_id3149777" xml-lang="en-US"> +<emph>Type</emph> is the due date of the payment at the beginning or end of each period.</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph role="paragraph" id="par_id3147478" xml-lang="en-US">What are the interest payments at a yearly interest rate of 5.5 %, a payment period of monthly payments for 2 years and a current cash value of 5,000 currency units? The start period is the 4th and the end period is the 6th period. The payment is due at the beginning of each period.</paragraph> +<paragraph role="paragraph" id="par_id3149819" xml-lang="en-US"> +<item type="input">=CUMIPMT(5.5%/12;24;5000;4;6;1)</item> = -57.54 currency units. The interest payments for between the 4th and 6th period are 57.54 currency units.</paragraph> +</section> +<section id="cumipmt_add"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3083280"><bookmark_value>CUMIPMT_ADD function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_CUMIPMT" id="bm_id3154312" localize="false"/> +<h2 id="hd_id3083280">CUMIPMT_ADD</h2> +<paragraph role="paragraph" id="par_id3152482" xml-lang="en-US"><ahelp hid="HID_AAI_FUNC_CUMIPMT">Calculates the accumulated interest for a period.</ahelp></paragraph> +<embed href="text/scalc/01/04060102.xhp#ADD_note"/> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph role="code" id="par_id3145087" xml-lang="en-US">CUMIPMT_ADD(Rate; NPer; PV; StartPeriod; EndPeriod; Type)</paragraph> +<paragraph role="paragraph" id="par_id3149277" xml-lang="en-US"> +<emph>Rate</emph> is the interest rate for each period.</paragraph> +<paragraph role="paragraph" id="par_id3149270" xml-lang="en-US"> +<emph>NPer</emph> is the total number of payment periods. The rate and NPER must refer to the same unit, and thus both be calculated annually or monthly.</paragraph> +<paragraph role="paragraph" id="par_id3152967" xml-lang="en-US"> +<emph>PV</emph> is the current value.</paragraph> +<paragraph role="paragraph" id="par_id3156308" xml-lang="en-US"> +<emph>StartPeriod</emph> is the first payment period for the calculation.</paragraph> +<paragraph role="paragraph" id="par_id3149453" xml-lang="en-US"> +<emph>EndPeriod</emph> is the last payment period for the calculation.</paragraph> +<paragraph role="paragraph" id="par_id3150962" xml-lang="en-US"> +<emph>Type</emph> is the maturity of a payment at the end of each period (Type = 0) or at the start of the period (Type = 1).</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph role="paragraph" id="par_id3156324" xml-lang="en-US">The following mortgage loan is taken out on a house:</paragraph> +<paragraph role="paragraph" id="par_id3147566" xml-lang="en-US">Rate: 9.00 per cent per annum (9% / 12 = 0.0075), Duration: 30 years (NPER = 30 * 12 = 360), Pv: 125000 currency units.</paragraph> +<paragraph role="paragraph" id="par_id3151272" xml-lang="en-US">How much interest must you pay in the second year of the mortgage (thus from periods 13 to 24)?</paragraph> +<paragraph role="paragraph" id="par_id3156130" xml-lang="en-US"> +<item type="input">=CUMIPMT_ADD(0.0075;360;125000;13;24;0)</item> returns -11135.23.</paragraph> +<paragraph role="paragraph" id="par_id3150764" xml-lang="en-US">How much interest must you pay in the first month?</paragraph> +<paragraph role="paragraph" id="par_id3146857" xml-lang="en-US"> +<item type="input">=CUMIPMT_ADD(0.0075;360;125000;1;1;0)</item> returns -937.50.</paragraph> +</section> +<section id="price"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3150878"><bookmark_value>PRICE function</bookmark_value> +<bookmark_value>prices; fixed interest securities</bookmark_value> +<bookmark_value>sales values;fixed interest securities</bookmark_value> +</bookmark><comment>mw added two entries</comment> +<bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_PRICE" id="bm_id3153279" localize="false"/> +<h2 id="hd_id3150878">PRICE</h2> +<paragraph role="paragraph" id="par_id3153210" xml-lang="en-US"><ahelp hid="HID_AAI_FUNC_PRICE">Calculates the market value of a fixed interest security with a par value of 100 currency units as a function of the forecast yield.</ahelp></paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph role="code" id="par_id3152804" xml-lang="en-US">PRICE(Settlement; Maturity; Rate; Yield; Redemption; Frequency [; Basis])</paragraph> +<paragraph role="paragraph" id="par_id3156121" xml-lang="en-US"> +<emph>Settlement</emph> is the date of purchase of the security.</paragraph> +<paragraph role="paragraph" id="par_id3149983" xml-lang="en-US"> +<emph>Maturity</emph> is the date on which the security matures (expires).</paragraph> +<paragraph role="paragraph" id="par_id3153755" xml-lang="en-US"> +<emph>Rate</emph> is the annual nominal rate of interest (coupon interest rate)</paragraph> +<paragraph role="paragraph" id="par_id3155999" xml-lang="en-US"> +<emph>Yield</emph> is the annual yield of the security.</paragraph> +<paragraph role="paragraph" id="par_id3156114" xml-lang="en-US"> +<emph>Redemption</emph> is the redemption value per 100 currency units of par value.</paragraph> +<paragraph role="paragraph" id="par_id3155846" xml-lang="en-US"> +<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"/> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph role="paragraph" id="par_id3150260" xml-lang="en-US">A security is purchased on 1999-02-15; the maturity date is 2007-11-15. The nominal rate of interest is 5.75%. The yield is 6.5%. The redemption value is 100 currency units. Interest is paid half-yearly (frequency is 2). With calculation on basis 0, the price is as follows:</paragraph> +<paragraph role="paragraph" id="par_id3147273" xml-lang="en-US"><input>=PRICE("1999-02-15"; "2007-11-15"; 0.0575; 0.065; 100; 2; 0)</input> returns 95.04287.</paragraph> +</section> +<section id="pricedisc"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3151297"><bookmark_value>PRICEDISC function</bookmark_value> +<bookmark_value>prices;non-interest-bearing securities</bookmark_value> +<bookmark_value>sales values;non-interest-bearing securities</bookmark_value> +</bookmark><comment>mw added two entries</comment> +<bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_PRICEDISC" id="bm_id3143236" localize="false"/> +<h2 id="hd_id3151297">PRICEDISC</h2> +<paragraph role="paragraph" id="par_id3155100" xml-lang="en-US"><ahelp hid="HID_AAI_FUNC_PRICEDISC">Calculates the price per 100 currency units of par value of a non-interest- bearing security.</ahelp></paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph role="code" id="par_id3146084" xml-lang="en-US">PRICEDISC(Settlement; Maturity; Discount; Redemption [; Basis])</paragraph> +<paragraph role="paragraph" id="par_id3159179" xml-lang="en-US"> +<emph>Settlement</emph> is the date of purchase of the security.</paragraph> +<paragraph role="paragraph" id="par_id3154304" xml-lang="en-US"> +<emph>Maturity</emph> is the date on which the security matures (expires).</paragraph> +<paragraph role="paragraph" id="par_id3156014" xml-lang="en-US"> +<emph>Discount</emph> is the discount of a security as a percentage.</paragraph> +<paragraph role="paragraph" id="par_id3147489" xml-lang="en-US"> +<emph>Redemption</emph> is the redemption value per 100 currency units of par value.</paragraph> +<embed href="text/scalc/01/func_yearfrac.xhp#basis"/> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph role="paragraph" id="par_id3149198" xml-lang="en-US">A security is purchased on 1999-02-15; the maturity date is 1999-03-01. Discount in per cent is 5.25%. The redemption value is 100. When calculating on basis 2 the price discount is as follows:</paragraph> +<paragraph role="paragraph" id="par_id3151178" xml-lang="en-US"><input>=PRICEDISC("1999-02-15"; "1999-03-01"; 0.0525; 100; 2)</input> returns 99.79583.</paragraph> +</section> +<section id="pricemat"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3154693"><bookmark_value>PRICEMAT function</bookmark_value> +<bookmark_value>prices;interest-bearing securities</bookmark_value> +</bookmark><comment>mw added one entry</comment> +<bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_PRICEMAT" id="bm_id3150118" localize="false"/> +<h2 id="hd_id3154693">PRICEMAT</h2> +<paragraph role="paragraph" id="par_id3153906" xml-lang="en-US"><ahelp hid="HID_AAI_FUNC_PRICEMAT">Calculates the price per 100 currency units of par value of a security, that pays interest on the maturity date.</ahelp></paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph role="code" id="par_id3155393" xml-lang="en-US">PRICEMAT(Settlement; Maturity; Issue; Rate; Yield [; Basis])</paragraph> +<paragraph role="paragraph" id="par_id3153102" xml-lang="en-US"> +<emph>Settlement</emph> is the date of purchase of the security.</paragraph> +<paragraph role="paragraph" id="par_id3150530" xml-lang="en-US"> +<emph>Maturity</emph> is the date on which the security matures (expires).</paragraph> +<paragraph role="paragraph" id="par_id3149903" xml-lang="en-US"> +<emph>Issue</emph> is the date of issue of the security.</paragraph> +<paragraph role="paragraph" id="par_id3148828" xml-lang="en-US"> +<emph>Rate</emph> is the interest rate of the security on the issue date.</paragraph> +<paragraph role="paragraph" id="par_id3146993" xml-lang="en-US"> +<emph>Yield</emph> is the annual yield of the security.</paragraph> +<embed href="text/scalc/01/func_yearfrac.xhp#basis"/> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph role="paragraph" id="par_id3154289" xml-lang="en-US">Settlement date: February 15 1999, maturity date: April 13 1999, issue date: November 11 1998. Interest rate: 6.1 per cent, yield: 6.1 per cent, basis: 30/360 = 0.</paragraph> +<paragraph role="paragraph" id="par_id3154905" xml-lang="en-US">The price is calculated as follows:</paragraph> +<paragraph role="paragraph" id="par_id3158409" xml-lang="en-US"><input>=PRICEMAT("1999-02-15";"1999-04-13";"1998-11-11"; 0.061; 0.061;0)</input> returns 99.98449888.</paragraph> +</section> +<section id="pduration"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3148448"><bookmark_value>calculating; durations</bookmark_value> +<bookmark_value>durations;calculating</bookmark_value> +<bookmark_value>PDURATION function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_LAUFZEIT" id="bm_id3154208" localize="false"/> +<h2 id="hd_id3148448">PDURATION</h2> +<paragraph role="paragraph" id="par_id3153056" xml-lang="en-US"><ahelp hid="HID_FUNC_LAUFZEIT">Calculates the number of periods required by an investment to attain the desired value.</ahelp></paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph role="code" id="par_id3148933" xml-lang="en-US">PDURATION(Rate; PV; FV)</paragraph> +<paragraph role="paragraph" id="par_id3148801" xml-lang="en-US"> +<emph>Rate</emph> is a constant. The interest rate is to be calculated for the entire duration (duration period). The interest rate per period is calculated by dividing the interest rate by the calculated duration. The internal rate for an annuity is to be entered as Rate/12.</paragraph> +<paragraph role="paragraph" id="par_id3147239" xml-lang="en-US"> +<emph>PV</emph> is the present (current) value. The cash value is the deposit of cash or the current cash value of an allowance in kind. As a deposit value a positive value must be entered; the deposit must not be 0 or <0.</paragraph> +<paragraph role="paragraph" id="par_id3147515" xml-lang="en-US"> +<emph>FV</emph> is the expected value. The future value determines the desired (future) value of the deposit.</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph role="paragraph" id="par_id3148480" xml-lang="en-US">At an interest rate of 4.75%, a cash value of 25,000 currency units and a future value of 1,000,000 currency units, a duration of 79.49 payment periods is returned. The periodic payment is the resulting quotient from the future value and the duration, in this case 1,000,000/79.49=12,850.20.</paragraph> +</section> +<section id="sln"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3148912"><bookmark_value>calculating;linear depreciations</bookmark_value> +<bookmark_value>depreciations;linear</bookmark_value> +<bookmark_value>linear depreciations</bookmark_value> +<bookmark_value>straight-line depreciations</bookmark_value> +<bookmark_value>SLN function</bookmark_value> +</bookmark><comment>mw added one entry</comment> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_LIA" id="bm_id3154275" localize="false"/> +<h2 id="hd_id3148912">SLN</h2> +<paragraph role="paragraph" id="par_id3149154" xml-lang="en-US"><ahelp hid="HID_FUNC_LIA">Returns the straight-line depreciation of an asset for one period.</ahelp> The amount of the depreciation is constant during the depreciation period.</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph role="code" id="par_id3166456" xml-lang="en-US">SLN(Cost; Salvage; Life)</paragraph> +<paragraph role="paragraph" id="par_id3146955" xml-lang="en-US"> +<emph>Cost</emph> is the initial cost of an asset.</paragraph> +<paragraph role="paragraph" id="par_id3149796" xml-lang="en-US"> +<emph>Salvage</emph> is the value of an asset at the end of the depreciation.</paragraph> +<paragraph role="paragraph" id="par_id3166444" xml-lang="en-US"> +<emph>Life</emph> is the depreciation period determining the number of periods in the depreciation of the asset.</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph role="paragraph" id="par_id3154098" xml-lang="en-US">Office equipment with an initial cost of 50,000 currency units is to be depreciated over 7 years. The value at the end of the depreciation is to be 3,500 currency units.</paragraph> +<paragraph role="paragraph" id="par_id3153390" xml-lang="en-US"> +<item type="input">=SLN(50000;3,500;84)</item> = 553.57 currency units. The periodic monthly depreciation of the office equipment is 553.57 currency units.</paragraph> +</section> +<section id="mduration"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3153739"><bookmark_value>MDURATION function</bookmark_value> +<bookmark_value>Macauley duration</bookmark_value> +</bookmark><comment>mw added one entry</comment> +<bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_MDURATION" id="bm_id3153750" localize="false"/> +<h2 id="hd_id3153739">MDURATION</h2> +<paragraph role="paragraph" id="par_id3149923" xml-lang="en-US"><ahelp hid="HID_AAI_FUNC_MDURATION">Calculates the modified Macauley duration of a fixed interest security in years.</ahelp></paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph role="code" id="par_id3148987" xml-lang="en-US">MDURATION(Settlement; Maturity; Coupon; Yield; Frequency [; Basis])</paragraph> +<paragraph role="paragraph" id="par_id3148619" xml-lang="en-US"> +<emph>Settlement</emph> is the date of purchase of the security.</paragraph> +<paragraph role="paragraph" id="par_id3149805" xml-lang="en-US"> +<emph>Maturity</emph> is the date on which the security matures (expires).</paragraph> +<paragraph role="paragraph" id="par_id3154338" xml-lang="en-US"> +<emph>Coupon</emph> is the annual nominal rate of interest (coupon interest rate)</paragraph> +<paragraph role="paragraph" id="par_id3148466" xml-lang="en-US"> +<emph>Yield</emph> is the annual yield of the security.</paragraph> +<paragraph role="paragraph" id="par_id3149423" xml-lang="en-US"> +<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"/> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph role="paragraph" id="par_id3148652" xml-lang="en-US">A security is purchased on 2001-01-01; the maturity date is 2006-01-01. The nominal 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 modified duration?</paragraph> +<paragraph role="paragraph" id="par_id3145378" xml-lang="en-US"><input>=MDURATION("2001-01-01"; "2006-01-01"; 0.08; 0.09; 2; 3)</input> returns 4.02 years.</paragraph> +</section> +<section id="npv"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3149242"><bookmark_value>calculating;net present values</bookmark_value> +<bookmark_value>net present values</bookmark_value> +<bookmark_value>NPV function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_NBW" id="bm_id3148417" localize="false"/> +<h2 id="hd_id3149242">NPV</h2> +<paragraph role="paragraph" id="par_id3145308" xml-lang="en-US"><ahelp hid="HID_FUNC_NBW">Returns the present value of an investment based on a series of periodic cash flows and a discount rate. To get the net present value, subtract the cost of the project (the initial cash flow at time zero) from the returned value.</ahelp></paragraph> +<paragraph id="par_idN111381" role="paragraph" xml-lang="en-US">If the payments take place at irregular intervals, use the <link href="text/scalc/01/04060118.xhp#xnpv" name="XNPV">XNPV</link> function.</paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + +<paragraph role="code" id="par_id3153321" xml-lang="en-US">NPV(Rate; <embedvar href="text/scalc/01/ful_func.xhp#number254_1" markup="keep"/>)</paragraph> +<paragraph role="paragraph" id="par_id3150630" xml-lang="en-US"><emph>Rate</emph> is the discount rate for a period.</paragraph> +<embed href="text/scalc/01/ful_func.xhp#number254"/> +<embed href="text/scalc/01/common_func.xhp#datenumbersequencenote"/> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph role="paragraph" id="par_id3154800" xml-lang="en-US">What is the net present value of periodic payments of 10, 20 and 30 currency units with a discount rate of 8.75%. At time zero the costs were paid as -40 currency units.</paragraph> +<paragraph role="paragraph" id="par_id3143270" xml-lang="en-US"> +<item type="input">=NPV(8.75%;10;20;30)</item> = 49.43 currency units. The net present value is the returned value minus the initial costs of 40 currency units, therefore 9.43 currency units.</paragraph> +</section> +<section id="nominal"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3149484"><bookmark_value>calculating;nominal interest rates</bookmark_value> +<bookmark_value>nominal interest rates</bookmark_value> +<bookmark_value>NOMINAL function</bookmark_value> +</bookmark><comment>mw made "nominal interest rates;..." a one level entry</comment> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_NOMINAL" id="bm_id3145600" localize="false"/> +<h2 id="hd_id3149484">NOMINAL</h2> +<paragraph role="paragraph" id="par_id3149596" xml-lang="en-US"><ahelp hid="HID_FUNC_NOMINAL">Calculates the yearly nominal interest rate, given the effective rate and the number of compounding periods per year.</ahelp></paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph role="code" id="par_id3152769" xml-lang="en-US">NOMINAL(EffectiveRate; NPerY)</paragraph> +<paragraph role="paragraph" id="par_id3147521" xml-lang="en-US"> +<emph>EffectiveRate</emph> is the effective interest rate</paragraph> +<paragraph role="paragraph" id="par_id3156334" xml-lang="en-US"> +<emph>NPerY</emph> is the number of periodic interest payments per year.</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph role="paragraph" id="par_id3147091" xml-lang="en-US">What is the nominal interest per year for an effective interest rate of 13.5% if twelve payments are made per year.</paragraph> +<paragraph role="paragraph" id="par_id3154831" xml-lang="en-US"> +<item type="input">=NOMINAL(13.5%;12)</item> = 12.73%. The nominal interest rate per year is 12.73%.</paragraph> +</section> +<section id="nominal_add"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3155123"><bookmark_value>NOMINAL_ADD function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_NOMINAL" id="bm_id3158439" localize="false"/> +<h2 id="hd_id3155123">NOMINAL_ADD</h2> +<paragraph role="paragraph" id="par_id3148671" xml-lang="en-US"><ahelp hid="HID_AAI_FUNC_NOMINAL">Calculates the annual nominal rate of interest on the basis of the effective rate and the number of interest payments per annum.</ahelp></paragraph> +<embed href="text/scalc/01/04060102.xhp#ADD_note"/> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph role="code" id="par_id3156157" xml-lang="en-US">NOMINAL_ADD(EffectiveRate; NPerY)</paragraph> +<paragraph role="paragraph" id="par_id3153777" xml-lang="en-US"> +<emph>EffectiveRate</emph> is the effective annual rate of interest.</paragraph> +<paragraph role="paragraph" id="par_id3150409" xml-lang="en-US"> +<emph>NPerY</emph> the number of interest payments per year.</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph role="paragraph" id="par_id3145777" xml-lang="en-US">What is the nominal rate of interest for a 5.3543% effective rate of interest and quarterly payment.</paragraph> +<paragraph role="paragraph" id="par_id3156146" xml-lang="en-US"> +<item type="input">=NOMINAL_ADD(5.3543%;4)</item> returns 0.0525 or 5.25%.</paragraph> +</section> +<section id="dollarfr"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3159087"><bookmark_value>DOLLARFR function</bookmark_value> +<bookmark_value>converting;decimal fractions, into mixed decimal fractions</bookmark_value> +</bookmark><comment>mw added one entry</comment> +<bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_DOLLARFR" id="bm_id3146907" localize="false"/> +<h2 id="hd_id3159087">DOLLARFR</h2> +<paragraph role="paragraph" id="par_id3150593" xml-lang="en-US"><ahelp hid="HID_AAI_FUNC_DOLLARFR">Converts a quotation that has been given as a decimal number into a mixed decimal fraction.</ahelp></paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph role="code" id="par_id3152959" xml-lang="en-US">DOLLARFR(DecimalDollar; Fraction)</paragraph> +<paragraph role="paragraph" id="par_id3149558" xml-lang="en-US"> +<emph>DecimalDollar</emph> is a decimal number.</paragraph> +<paragraph role="paragraph" id="par_id3153672" xml-lang="en-US"> +<emph>Fraction</emph> is a whole number that is used as the denominator of the decimal fraction.</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph role="paragraph" id="par_id3153795" xml-lang="en-US"> +<item type="input">=DOLLARFR(1.125;16)</item> converts into sixteenths. The result is 1.02 for 1 plus 2/16.</paragraph> +<paragraph role="paragraph" id="par_id3150995" xml-lang="en-US"> +<item type="input">=DOLLARFR(1.125;8)</item> converts into eighths. The result is 1.1 for 1 plus 1/8.</paragraph> +</section> +<section id="dollarde"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3154671"><bookmark_value>fractions; converting</bookmark_value> +<bookmark_value>converting;decimal fractions, into decimal numbers</bookmark_value> +<bookmark_value>DOLLARDE function</bookmark_value> +</bookmark><comment>mw added one entry</comment> +<bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_DOLLARDE" id="bm_id3154569" localize="false"/> +<h2 id="hd_id3154671">DOLLARDE</h2> +<paragraph role="paragraph" id="par_id3154418" xml-lang="en-US"><ahelp hid="HID_AAI_FUNC_DOLLARDE">Converts a quotation that has been given as a decimal fraction into a decimal number.</ahelp></paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph role="code" id="par_id3150348" xml-lang="en-US">DOLLARDE(FractionalDollar; Fraction)</paragraph> +<paragraph role="paragraph" id="par_id3154111" xml-lang="en-US"> +<emph>FractionalDollar</emph> is a number given as a decimal fraction.</paragraph> +<paragraph role="paragraph" id="par_id3153695" xml-lang="en-US"> +<emph>Fraction</emph> is a whole number that is used as the denominator of the decimal fraction.</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph role="paragraph" id="par_id3150941" xml-lang="en-US"> +<item type="input">=DOLLARDE(1.02;16)</item> stands for 1 and 2/16. This returns 1.125.</paragraph> +<paragraph role="paragraph" id="par_id3150830" xml-lang="en-US"> +<item type="input">=DOLLARDE(1.1;8)</item> stands for 1 and 1/8. This returns 1.125.</paragraph> +</section> +<section id="mirr"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3148974"><bookmark_value>calculating;modified internal rates of return</bookmark_value> +<bookmark_value>modified internal rates of return</bookmark_value> +<bookmark_value>MIRR function</bookmark_value> +<bookmark_value>internal rates of return;modified</bookmark_value> +</bookmark><comment>mw added "internal rates of return;..."</comment> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_QIKV" id="bm_id3150670" localize="false"/> +<h2 id="hd_id3148974">MIRR</h2> +<paragraph role="paragraph" id="par_id3155497" xml-lang="en-US"><ahelp hid="HID_FUNC_QIKV">Calculates the modified internal rate of return of a series of investments.</ahelp></paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph role="code" id="par_id3148399" xml-lang="en-US">MIRR(Values; Investment; ReinvestRate)</paragraph> +<paragraph role="paragraph" id="par_id3155896" xml-lang="en-US"> +<emph>Values</emph> corresponds to the array or the cell reference for cells whose content corresponds to the payments.</paragraph> +<paragraph role="paragraph" id="par_id3149998" xml-lang="en-US"> +<emph>Investment</emph> is the rate of interest of the investments (the negative values of the array)</paragraph> +<paragraph role="paragraph" id="par_id3159408" xml-lang="en-US"> +<emph>ReinvestRate</emph>:the rate of interest of the reinvestment (the positive values of the array)</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph role="paragraph" id="par_id3147352" xml-lang="en-US">Assuming a cell content of A1 = <item type="input">-5</item>, A2 = <item type="input">10</item>, A3 = <item type="input">15</item>, and A4 = <item type="input">8</item>, and an investment value of 0.5 and a reinvestment value of 0.1, the result is 94.16%.</paragraph> +</section> +<section id="yield"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3149323"><bookmark_value>YIELD function</bookmark_value> +<bookmark_value>rates of return;securities</bookmark_value> +<bookmark_value>yields, see also rates of return</bookmark_value> +</bookmark><comment>mw added two entries</comment> +<bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_YIELD" id="bm_id3152460" localize="false"/> +<h2 id="hd_id3149323">YIELD</h2> +<paragraph role="paragraph" id="par_id3150643" xml-lang="en-US"><ahelp hid="HID_AAI_FUNC_YIELD">Calculates the yield of a security.</ahelp></paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph role="code" id="par_id3149744" xml-lang="en-US">YIELD(Settlement; Maturity; Rate; Price; Redemption; Frequency [; Basis])</paragraph> +<paragraph role="paragraph" id="par_id3154526" xml-lang="en-US"> +<emph>Settlement</emph> is the date of purchase of the security.</paragraph> +<paragraph role="paragraph" id="par_id3153266" xml-lang="en-US"> +<emph>Maturity</emph> is the date on which the security matures (expires).</paragraph> +<paragraph role="paragraph" id="par_id3151284" xml-lang="en-US"> +<emph>Rate</emph> is the annual rate of interest.</paragraph> +<paragraph role="paragraph" id="par_id3147314" xml-lang="en-US"> +<emph>Price</emph> is the price (purchase price) of the security per 100 currency units of par value.</paragraph> +<paragraph role="paragraph" id="par_id3145156" xml-lang="en-US"> +<emph>Redemption</emph> is the redemption value per 100 currency units of par value.</paragraph> +<paragraph role="paragraph" id="par_id3159218" xml-lang="en-US"> +<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"/> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph role="paragraph" id="par_id3151214" xml-lang="en-US">A security is purchased on 1999-02-15. It matures on 2007-11-15. The rate of interest is 5.75%. The price is 95.04287 currency units per 100 units of par value, the redemption value is 100 units. Interest is paid half-yearly (frequency = 2) and the basis is 0. How high is the yield?</paragraph> +<paragraph role="paragraph" id="par_id3154194" xml-lang="en-US"><input>=YIELD("1999-02-15"; "2007-11-15"; 0.0575 ;95.04287; 100; 2; 0)</input> returns 0.065 or 6.50 per cent.</paragraph> +</section> +<section id="yielddisc"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3150100"><bookmark_value>YIELDDISC function</bookmark_value> +<bookmark_value>rates of return;non-interest-bearing securities</bookmark_value> +</bookmark><comment>mw added one entry</comment> +<bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_YIELDDISC" id="bm_id3156206" localize="false"/> +<h2 id="hd_id3150100">YIELDDISC</h2> +<paragraph role="paragraph" id="par_id3150486" xml-lang="en-US"><ahelp hid="HID_AAI_FUNC_YIELDDISC">Calculates the annual yield of a non-interest-bearing security.</ahelp></paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph role="code" id="par_id3159191" xml-lang="en-US">YIELDDISC(Settlement; Maturity; Price; Redemption [; Basis])</paragraph> +<paragraph role="paragraph" id="par_id3150237" xml-lang="en-US"> +<emph>Settlement</emph> is the date of purchase of the security.</paragraph> +<paragraph role="paragraph" id="par_id3146924" xml-lang="en-US"> +<emph>Maturity</emph> is the date on which the security matures (expires).</paragraph> +<paragraph role="paragraph" id="par_id3151201" xml-lang="en-US"> +<emph>Price</emph> is the price (purchase price) of the security per 100 currency units of par value.</paragraph> +<paragraph role="paragraph" id="par_id3156049" xml-lang="en-US"> +<emph>Redemption</emph> is the redemption value per 100 currency units of par value.</paragraph> +<embed href="text/scalc/01/func_yearfrac.xhp#basis"/> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph role="paragraph" id="par_id3163815" xml-lang="en-US">A non-interest-bearing security is purchased on 1999-02-15. It matures on 1999-03-01. The price is 99.795 currency units per 100 units of par value, the redemption value is 100 units. The basis is 2. How high is the yield?</paragraph> +<paragraph role="paragraph" id="par_id3155187" xml-lang="en-US"><input>=YIELDDISC("1999-02-15"; "1999-03-01"; 99.795; 100; 2)</input> returns 0.052823 or 5.2823 per cent.</paragraph> +</section> +<section id="yieldmat"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3155140"><bookmark_value>YIELDMAT function</bookmark_value> +<bookmark_value>rates of return;securities with interest paid on maturity</bookmark_value> +</bookmark><comment>mw added one entry</comment> +<bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_YIELDMAT" id="bm_id3156029" localize="false"/> +<h2 id="hd_id3155140">YIELDMAT</h2> +<paragraph role="paragraph" id="par_id3151332" xml-lang="en-US"><ahelp hid="HID_AAI_FUNC_YIELDMAT">Calculates the annual yield of a security, the interest of which is paid on the date of maturity.</ahelp></paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph role="code" id="par_id3159113" xml-lang="en-US">YIELDMAT(Settlement; Maturity; Issue; Rate; Price [; Basis])</paragraph> +<paragraph role="paragraph" id="par_id3149309" xml-lang="en-US"> +<emph>Settlement</emph> is the date of purchase of the security.</paragraph> +<paragraph role="paragraph" id="par_id3151381" xml-lang="en-US"> +<emph>Maturity</emph> is the date on which the security matures (expires).</paragraph> +<paragraph role="paragraph" id="par_id3153302" xml-lang="en-US"> +<emph>Issue</emph> is the date of issue of the security.</paragraph> +<paragraph role="paragraph" id="par_id3147140" xml-lang="en-US"> +<emph>Rate</emph> is the interest rate of the security on the issue date.</paragraph> +<paragraph role="paragraph" id="par_id3151067" xml-lang="en-US"> +<emph>Price</emph> is the price (purchase price) of the security per 100 currency units of par value.</paragraph> +<embed href="text/scalc/01/func_yearfrac.xhp#basis"/> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph role="paragraph" id="par_id3163717" xml-lang="en-US">A security is purchased on 1999-03-15. It matures on 1999-11-03. The issue date was 1998-11-08. The rate of interest is 6.25%, the price is 100.0123 units. The basis is 0. How high is the yield?</paragraph> +<paragraph role="paragraph" id="par_id3155311" xml-lang="en-US"><input>=YIELDMAT("1999-03-15"; "1999-11-03"; "1998-11-08"; 0.0625; 100.0123; 0)</input> returns 0.060954 or 6.0954 per cent.</paragraph> +</section> +<section id="pmt"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3149577"><bookmark_value>calculating;annuities</bookmark_value> +<bookmark_value>annuities</bookmark_value> +<bookmark_value>PMT function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_RMZ" id="bm_id3148895" localize="false"/> +<h2 id="hd_id3149577">PMT</h2> +<paragraph role="paragraph" id="par_id3148563" xml-lang="en-US"><ahelp hid="HID_FUNC_RMZ">Returns the periodic payment for an annuity with constant interest rates.</ahelp></paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph role="code" id="par_id3147278" xml-lang="en-US">PMT(Rate; NPer; PV [ ; [ FV ] [ ; Type ] ])</paragraph> +<paragraph role="paragraph" id="par_id3147291" xml-lang="en-US"> +<emph>Rate</emph> is the periodic interest rate.</paragraph> +<paragraph role="paragraph" id="par_id3148641" xml-lang="en-US"> +<emph>NPer</emph> is the number of periods in which annuity is paid.</paragraph> +<paragraph role="paragraph" id="par_id3156360" xml-lang="en-US"> +<emph>PV</emph> is the present value (cash value) in a sequence of payments.</paragraph> +<paragraph role="paragraph" id="par_id3154920" xml-lang="en-US"> +<emph>FV</emph> (optional) is the desired value (future value) to be reached at the end of the periodic payments.</paragraph> +<paragraph role="paragraph" id="par_id3156434" xml-lang="en-US"> +<emph>Type</emph> (optional) is the due date for the periodic payments. Type=1 is payment at the beginning and Type=0 is payment at the end of each period.</paragraph> +<paragraph role="paragraph" id="par_idN11645" xml-lang="en-US" localize="false"> + <embedvar href="text/scalc/00/00000004.xhp#optional"/> +</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph role="paragraph" id="par_id3154222" xml-lang="en-US">What are the periodic payments at a yearly interest rate of 1.99% if the payment time is 3 years and the cash value is 25,000 currency units. There are 36 months as 36 payment periods, and the interest rate per payment period is 1.99%/12.</paragraph> +<paragraph role="paragraph" id="par_id3155943" xml-lang="en-US"> +<item type="input">=PMT(1.99%/12;36;25000)</item> = -715.96 currency units. The periodic monthly payment is therefore 715.96 currency units.</paragraph> +</section> +<section id="tbilleq"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3155799"><bookmark_value>TBILLEQ function</bookmark_value> +<bookmark_value>treasury bills;annual return</bookmark_value> +<bookmark_value>annual return on treasury bills</bookmark_value> +</bookmark><comment>mw changed "treasury bills;..." and added one entry</comment> +<bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_TBILLEQ" id="bm_id3147380" localize="false"/> +<h2 id="hd_id3155799">TBILLEQ</h2> +<paragraph role="paragraph" id="par_id3154403" xml-lang="en-US"><ahelp hid="HID_AAI_FUNC_TBILLEQ">Calculates the annual return on a treasury bill.</ahelp> A treasury bill is purchased on the settlement date and sold at the full par value on the maturity date, that must fall within the same year. A discount is deducted from the purchase price.</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph role="code" id="par_id3150224" xml-lang="en-US">TBILLEQ(Settlement; Maturity; Discount)</paragraph> +<paragraph role="paragraph" id="par_id3156190" xml-lang="en-US"> +<emph>Settlement</emph> is the date of purchase of the security.</paragraph> +<paragraph role="paragraph" id="par_id3153827" xml-lang="en-US"> +<emph>Maturity</emph> is the date on which the security matures (expires).</paragraph> +<paragraph role="paragraph" id="par_id3150310" xml-lang="en-US"> +<emph>Discount</emph> is the percentage discount on acquisition of the security.</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph role="paragraph" id="par_id3153173" xml-lang="en-US">Settlement date: March 31 1999, maturity date: June 1 1999, discount: 9.14 per cent.</paragraph> +<paragraph role="paragraph" id="par_id3153520" xml-lang="en-US">The return on the treasury bill corresponding to a security is worked out as follows:</paragraph> +<paragraph role="paragraph" id="par_id3154382" xml-lang="en-US"><input>=TBILLEQ("1999-03-31";"1999-06-01"; 0.0914)</input> returns 0.094151 or 9.4151 per cent.</paragraph> +</section> +<section id="tbillprice"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3151032"><bookmark_value>TBILLPRICE function</bookmark_value> +<bookmark_value>treasury bills;prices</bookmark_value> +<bookmark_value>prices;treasury bills</bookmark_value> +</bookmark><comment>mw added two entries</comment> +<bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_TBILLPRICE" id="bm_id3150576" localize="false"/> +<h2 id="hd_id3151032">TBILLPRICE</h2> +<paragraph role="paragraph" id="par_id3157887" xml-lang="en-US"><ahelp hid="HID_AAI_FUNC_TBILLPRICE">Calculates the price of a treasury bill per 100 currency units.</ahelp></paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph role="code" id="par_id3150284" xml-lang="en-US">TBILLPRICE(Settlement; Maturity; Discount)</paragraph> +<paragraph role="paragraph" id="par_id3154059" xml-lang="en-US"> +<emph>Settlement</emph> is the date of purchase of the security.</paragraph> +<paragraph role="paragraph" id="par_id3154073" xml-lang="en-US"> +<emph>Maturity</emph> is the date on which the security matures (expires).</paragraph> +<paragraph role="paragraph" id="par_id3145765" xml-lang="en-US"> +<emph>Discount</emph> is the percentage discount upon acquisition of the security.</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph role="paragraph" id="par_id3155542" xml-lang="en-US">Settlement date: March 31 1999, maturity date: June 1 1999, discount: 9 per cent.</paragraph> +<paragraph role="paragraph" id="par_id3154578" xml-lang="en-US">The price of the treasury bill is worked out as follows:</paragraph> +<paragraph role="paragraph" id="par_id3154592" xml-lang="en-US"><input>=TBILLPRICE("1999-03-31";"1999-06-01"; 0.09)</input> returns 98.45.</paragraph> +</section> +<section id="tbillyield"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3152912"><bookmark_value>TBILLYIELD function</bookmark_value> +<bookmark_value>treasury bills;rates of return</bookmark_value> +<bookmark_value>rates of return of treasury bills</bookmark_value> +</bookmark><comment>mw added two entries</comment> +<bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_TBILLYIELD" id="bm_id3151346" localize="false"/> +<h2 id="hd_id3152912">TBILLYIELD</h2> +<paragraph role="paragraph" id="par_id3145560" xml-lang="en-US"><ahelp hid="HID_AAI_FUNC_TBILLYIELD">Calculates the yield of a treasury bill.</ahelp></paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph role="code" id="par_id3156077" xml-lang="en-US">TBILLYIELD(Settlement; Maturity; Price)</paragraph> +<paragraph role="paragraph" id="par_id3156091" xml-lang="en-US"> +<emph>Settlement</emph> is the date of purchase of the security.</paragraph> +<paragraph role="paragraph" id="par_id3157856" xml-lang="en-US"> +<emph>Maturity</emph> is the date on which the security matures (expires).</paragraph> +<paragraph role="paragraph" id="par_id3149627" xml-lang="en-US"> +<emph>Price</emph> is the price (purchase price) of the treasury bill per 100 currency units of par value.</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph role="paragraph" id="par_id3145178" xml-lang="en-US">Settlement date: March 31 1999, maturity date: June 1 1999, price: 98.45 currency units.</paragraph> +<paragraph role="paragraph" id="par_id3145193" xml-lang="en-US">The yield of the treasury bill is worked out as follows:</paragraph> +<paragraph role="paragraph" id="par_id3148528" xml-lang="en-US"><input>=TBILLYIELD("1999-03-31";"1999-06-01"; 98.45)</input> returns 0.091417 or 9.1417 per cent.</paragraph> +</section> +</sort> +<paragraph role="paragraph" id="par_id3148546" xml-lang="en-US"><link href="text/scalc/01/04060103.xhp" name="Back to Financial Functions Part One">Back to Financial Functions Part One</link></paragraph> +<paragraph role="paragraph" id="par_id3146762" xml-lang="en-US"><link href="text/scalc/01/04060118.xhp" name="Forward to Financial Functions Part Three">Forward to Financial Functions Part Three</link></paragraph> +<embed href="text/scalc/01/04060100.xhp#drking"/> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/04060120.xhp b/helpcontent2/source/text/scalc/01/04060120.xhp new file mode 100644 index 000000000..b5e805053 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/04060120.xhp @@ -0,0 +1,129 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> + +<!-- +/* + * Version: MPL 1.1 / GPLv3+ / LGPLv3+ + * + * The contents of this file are subject to the Mozilla Public License Version + * 1.1 (the "License"); you may not use this file except in compliance with + * the License or as specified alternatively below. You may obtain a copy of + * the License at http://www.mozilla.org/MPL/ + * + * Software distributed under the License is distributed on an "AS IS" basis, + * WITHOUT WARRANTY OF ANY KIND, either express or implied. See the License + * for the specific language governing rights and limitations under the + * License. + * + * Major Contributor(s): + * [ Copyright (C) 2011 Wolfgang Pechlaner <libo@pechlaner.at> (initial developer) ] + * [ Copyright (C) 2011 Noel Grandin <noel@peralex.com> (English translation)] + * + * All Rights Reserved. + * + * For minor contributions see the git repository. + * + * Alternatively, the contents of this file may be used under the terms of + * either the GNU General Public License Version 3 or later (the "GPLv3+"), or + * the GNU Lesser General Public License Version 3 or later (the "LGPLv3+"), + * in which case the provisions of the GPLv3+ or the LGPLv3+ are applicable + * instead of those above. + */ --> + + +<meta> +<topic id="textscalc0104060120xml" indexer="include"> +<title id="tit" xml-lang="en-US">Bit Operation Functions</title> +<filename>/text/scalc/01/04060120.xhp</filename> +</topic> +</meta> +<body> +<h1 id="hd_id4149052">Bit Operation Functions</h1> +<section id="howtoget"> +<embed href="text/scalc/00/00000404.xhp#eikama"/> +</section> +<sort order="asc" descendant="h2"> +<section id="bitand"> +<bookmark xml-lang="en-US" branch="index" id="bm_id4150026"><bookmark_value>BITAND function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_BITAND" id="bm_id4145827" localize="false"/> +<h2 id="hd_id4150026">BITAND</h2> +<paragraph role="paragraph" id="par_id4146942" xml-lang="en-US"><ahelp hid="HID_FUNC_BITAND">Returns a bitwise logical "and" of the parameters.</ahelp></paragraph> +<embed href="text/scalc/00/avail_release.xhp#3.5"/> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph role="code" id="par_id4146878" xml-lang="en-US">BITAND(number1; number2)</paragraph> +<paragraph role="paragraph" id="par_id4151228" xml-lang="en-US"> +<emph>Number1</emph> and <emph>number2</emph> are positive integers less than 2 ^ 48 (281 474 976 710 656).</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph role="paragraph" id="par_id4149246" xml-lang="en-US"> +<item type="input">=BITAND(6;10)</item> returns 2 (0110 & 1010 = 0010).</paragraph> +</section> +<section id="bitor"> +<bookmark xml-lang="en-US" branch="index" id="bm_id4146139"><bookmark_value>BITOR function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_BITOR" id="bm_id4148754" localize="false"/> +<h2 id="hd_id4146139">BITOR</h2> +<paragraph role="paragraph" id="par_id4150140" xml-lang="en-US"><ahelp hid="HID_FUNC_BITOR">Returns a bitwise logical "or" of the parameters.</ahelp></paragraph> +<embed href="text/scalc/00/avail_release.xhp#3.5"/> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph role="code" id="par_id4148733" xml-lang="en-US">BITOR(number1; number2)</paragraph> +<paragraph role="paragraph" id="par_id4150864" xml-lang="en-US"> +<emph>Number1</emph> and <emph>number2</emph> are positive integers less than 2 ^ 48 (281 474 976 710 656).</paragraph> +<paragraph role="paragraph" id="par_id4149884" xml-lang="en-US"> +<item type="input">=BITOR(6;10)</item> returns 14 (0110 | 1010 = 1110).</paragraph> +</section> +<section id="bitxor"> +<bookmark xml-lang="en-US" branch="index" id="bm_id4150019"><bookmark_value>BITXOR function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_BITXOR" id="bm_id4154330" localize="false"/> +<h2 id="hd_id4150019">BITXOR</h2> +<paragraph role="paragraph" id="par_id4145246" xml-lang="en-US"><ahelp hid="HID_FUNC_BITXOR">Returns a bitwise logical "exclusive or" of the parameters.</ahelp></paragraph> +<embed href="text/scalc/00/avail_release.xhp#3.5"/> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph role="code" id="par_id4157970" xml-lang="en-US">BITXOR(number1; number2)</paragraph> +<paragraph role="paragraph" id="par_id4145302" xml-lang="en-US"> +<emph>Number1</emph> and <emph>number2</emph> are positive integers less than 2 ^ 48 (281 474 976 710 656).</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph role="paragraph" id="par_id4149394" xml-lang="en-US"> +<item type="input">=BITXOR(6;10)</item> returns 12 (0110 ^ 1010 = 1100)</paragraph> +</section> +<section id="bitlshift"> +<bookmark xml-lang="en-US" branch="index" id="bm_id4155370"><bookmark_value>BITLSHIFT function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_BITLSHIFT" id="bm_id4148593" localize="false"/> +<h2 id="hd_id4155370">BITLSHIFT</h2> +<paragraph role="paragraph" id="par_id4158411" xml-lang="en-US"><ahelp hid="HID_FUNC_BITLSHIFT">Shifts a number left by n bits.</ahelp></paragraph> +<embed href="text/scalc/00/avail_release.xhp#3.5"/> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph role="code" id="par_id4147536" xml-lang="en-US">BITLSHIFT(number; shift)</paragraph> +<paragraph role="paragraph" id="par_id4150475" xml-lang="en-US"> +<emph>Number</emph> is a positive integer less than 2 ^ 48 (281 474 976 710 656).</paragraph> +<paragraph role="paragraph" id="par_id4153921" xml-lang="en-US"> +<emph>Shift</emph> is the number of positions the bits will be moved to the left. If shift is negative, it is synonymous with BITRSHIFT (number; -shift).</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph role="paragraph" id="par_id4149819" xml-lang="en-US"> +<item type="input">=BITLSHIFT(6;1)</item> returns 12 (0110 << 1 = 1100).</paragraph> +</section> +<section id="bitrshift"> +<bookmark xml-lang="en-US" branch="index" id="bm_id4083280"><bookmark_value>BITRSHIFT function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_BITRSHIFT" id="bm_id4154312" localize="false"/> +<h2 id="hd_id4083280">BITRSHIFT</h2> +<paragraph role="paragraph" id="par_id4152482" xml-lang="en-US"><ahelp hid="HID_FUNC_BITRSHIFT">Shifts a number right by n bits.</ahelp></paragraph> +<embed href="text/scalc/00/avail_release.xhp#3.5"/> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph role="code" id="par_id4145087" xml-lang="en-US">BITRSHIFT(number; shift)</paragraph> +<paragraph role="paragraph" id="par_id4149277" xml-lang="en-US"> +<emph>Number</emph> is a positive integer less than 2 ^ 48 (281 474 976 710 656).</paragraph> +<paragraph role="paragraph" id="par_id4149270" xml-lang="en-US"> +<emph>Shift</emph> is the number of positions the bits will be moved to the right. If shift is negative, it is synonymous with BITLSHIFT (number; -shift).</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph role="paragraph" id="par_id4156130" xml-lang="en-US"> +<item type="input">=BITRSHIFT(6;1)</item> returns 3 (0110 >> 1 = 0011).</paragraph> +</section> +</sort> +<section id="relatedtopics"> +<embed href="text/scalc/01/04060100.xhp#drking"/> +</section> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/04060181.xhp b/helpcontent2/source/text/scalc/01/04060181.xhp new file mode 100644 index 000000000..c2c24850d --- /dev/null +++ b/helpcontent2/source/text/scalc/01/04060181.xhp @@ -0,0 +1,714 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . +--> + +<meta> + <topic id="textscalc0104060181xml" indexer="include"> + <title id="tit" xml-lang="en-US">Statistical Functions Part One</title> + <filename>/text/scalc/01/04060181.xhp</filename> + </topic> +</meta> +<body> + +<h1 id="hd_id3146320"><variable id="ae"><link href="text/scalc/01/04060181.xhp">Statistical Functions Part One</link></variable></h1> +<sort order="asc" descendant="h2"> + +<section id="intercept"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3145632"> + <bookmark_value>INTERCEPT function</bookmark_value> + <bookmark_value>points of intersection</bookmark_value> + <bookmark_value>intersections</bookmark_value> +</bookmark> +<comment>mw added two entries</comment> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_ACHSENABSCHNITT" id="bm_id3153018" localize="false"/> + +<h2 id="hd_id3145632">INTERCEPT</h2> +<paragraph id="par_id3146887" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_ACHSENABSCHNITT">Calculates the point at which a line will intersect the y-values by using known x-values and y-values.</ahelp></paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3149718" role="code" xml-lang="en-US">INTERCEPT(DataY; DataX)</paragraph> +<paragraph id="par_id3149947" role="paragraph" xml-lang="en-US"><emph>DataY</emph> is the dependent set of observations or data.</paragraph> +<paragraph id="par_id3147412" role="paragraph" xml-lang="en-US"><emph>DataX</emph> is the independent set of observations or data.</paragraph> +<paragraph id="par_id3152983" role="paragraph" xml-lang="en-US">Names, arrays or references containing numbers must be used here. Numbers can also be entered directly.</paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3148728" role="paragraph" xml-lang="en-US">To calculate the intercept, use cells D3:D9 as the y value and C3:C9 as the x value from the example spreadsheet. Input will be as follows:</paragraph> +<paragraph id="par_id3149013" role="paragraph" xml-lang="en-US"><item type="input">=INTERCEPT(D3:D9;C3:C9)</item> = 2.15.</paragraph> +</section> + +<section id="count"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3148437"> + <bookmark_value>COUNT function</bookmark_value> + <bookmark_value>numbers;counting</bookmark_value> +</bookmark> +<comment>mw added one entry</comment> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_ANZAHL" id="bm_id3153040" localize="false"/> + +<h2 id="hd_id3148437"><variable id="count_head"><link href="text/scalc/01/04060181.xhp#count">COUNT</link></variable></h2> +<paragraph id="par_id3150700" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_ANZAHL">Counts how many numbers are in the list of arguments.</ahelp> Text entries are ignored.</paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3148585" role="code" xml-lang="en-US">COUNT(<embedvar href="text/scalc/01/ful_func.xhp#number255_1" markup="keep"/>)</paragraph> +<embed href="text/scalc/01/ful_func.xhp#number255"/> +<embed href="text/scalc/01/common_func.xhp#datenumbersequencenote"/> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3149953" role="paragraph" xml-lang="en-US">The entries 2, 4, 6 and eight in the Value 1-4 fields are to be counted.</paragraph> +<paragraph id="par_id3154558" role="paragraph" xml-lang="en-US"><item type="input">=COUNT(2;4;6;"eight")</item> = 3. The count of numbers is therefore 3.</paragraph> +</section> + +<section id="counta"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3149729"> + <bookmark_value>COUNTA function</bookmark_value> + <bookmark_value>number of entries</bookmark_value> +</bookmark> +<comment>mw added one entry</comment> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_ANZAHL2" id="bm_id3148738" localize="false"/> + +<h2 id="hd_id3149729"><variable id="counta_head"><link href="text/scalc/01/04060181.xhp#counta">COUNTA</link></variable></h2> +<paragraph id="par_id3150142" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_ANZAHL2">Counts how many values are in the list of arguments.</ahelp> Text entries are also counted, even when they contain an empty string of length 0. If an argument is an array or reference, empty cells within the array or reference are ignored.<comment>UFI: fix to #i35888#</comment></paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3153111" role="code" xml-lang="en-US">COUNTA(<embedvar href="text/scalc/01/ful_func.xhp#number255_1" markup="keep"/>)</paragraph> +<embed href="text/scalc/01/ful_func.xhp#number255"/> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3154508" role="paragraph" xml-lang="en-US">The entries 2, 4, 6 and eight in the Value 1-4 fields are to be counted.</paragraph> +<paragraph id="par_id3158000" role="paragraph" xml-lang="en-US"><item type="input">=COUNTA(2;4;6;"eight")</item> = 4. The count of values is therefore 4.</paragraph> +</section> + +<section id="countblank"> +<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> + +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_ANZAHLLEEREZELLEN" id="bm_id3149730" localize="false"/> + +<h2 id="hd_id3150896"><variable id="countblank_head"><link href="text/scalc/01/04060181.xhp#countblank">COUNTBLANK</link></variable></h2> +<paragraph id="par_id3155260" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_ANZAHLLEEREZELLEN">Returns the number of empty cells.</ahelp></paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3153931" role="code" xml-lang="en-US">COUNTBLANK(Range)</paragraph> +<paragraph id="par_id3149512" role="paragraph" xml-lang="en-US">Returns the number of empty cells in the cell range <emph>Range</emph>.</paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3148586" role="paragraph" xml-lang="en-US"><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="countif"> +<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"/> + +<h2 id="hd_id3164897"><variable id="countif_head"><link href="text/scalc/01/04060181.xhp#countif">COUNTIF</link></variable></h2> +<paragraph id="par_id3164926" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_ZAEHLENWENN">Returns the number of cells that meet with certain criteria within a cell range.</ahelp></paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3164967" role="code" xml-lang="en-US">COUNTIF(Range; Criterion)</paragraph> +<paragraph id="par_id3164980" role="paragraph" xml-lang="en-US"><emph>Range</emph> is the range to which the criteria are to be applied.</paragraph> +<embed href="text/scalc/01/ex_data_stat_func.xhp#criterion"/> +<embed href="text/shared/00/00000001.xhp#regex"/> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3166505" role="paragraph" xml-lang="en-US">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 id="par_id3581652" role="paragraph" xml-lang="en-US"><item type="input">=COUNTIF(A1:A10;2006)</item> - this returns 1.</paragraph> +<paragraph id="par_id708639" role="paragraph" xml-lang="en-US"><item type="input">=COUNTIF(A1:A10;B1)</item> - this returns 1.</paragraph> +<paragraph id="par_id5169225" role="paragraph" xml-lang="en-US"><item type="input">=COUNTIF(A1:A10;">=2006")</item> - this returns 4.</paragraph> +<paragraph id="par_id2118594" role="paragraph" xml-lang="en-US"><item type="input">=COUNTIF(A1:A10;"<"&B1)</item> - when B1 contains <item type="input">2006</item>, this returns 6.</paragraph> +<paragraph id="par_id166020" role="paragraph" xml-lang="en-US"><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 id="par_id6386913" role="paragraph" xml-lang="en-US">To count only negative numbers: <item type="input">=COUNTIF(A1:A10;"<0")</item></paragraph> +</section> + +<section id="countifs"> + +<h2 localize="false" id="hd_id224412044220134"><embedvar href="text/scalc/01/func_countifs.xhp#countifs_head"/></h2> +<paragraph id="par_id16399242326772" role="paragraph" localize="false" xml-lang="en-US"><embedvar href="text/scalc/01/func_countifs.xhp#countifs_des"/></paragraph> +</section> + +<section id="b"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3150267"> + <bookmark_value>B function</bookmark_value> + <bookmark_value>probabilities of samples with binomial distribution</bookmark_value> +</bookmark> +<comment>mw added one entry</comment> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_B" id="bm_id3153044" localize="false"/> + +<h2 id="hd_id3150267">B</h2> +<paragraph id="par_id3156061" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_B">Returns the probability of a sample with binomial distribution.</ahelp></paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3148392" role="code" xml-lang="en-US">B(Trials; SP; T1 [; T2])</paragraph> +<paragraph id="par_id3149002" role="paragraph" xml-lang="en-US"><emph>Trials</emph> is the number of independent trials.</paragraph> +<paragraph id="par_id3148875" role="paragraph" xml-lang="en-US"><emph>SP</emph> is the probability of success on each trial.</paragraph> +<paragraph id="par_id3145352" role="paragraph" xml-lang="en-US"><emph>T1</emph> defines the lower limit for the number of trials.</paragraph> +<paragraph id="par_id3149538" role="paragraph" xml-lang="en-US"><emph>T2</emph> (optional) defines the upper limit for the number of trials.</paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3154633" role="paragraph" xml-lang="en-US">What is the probability with ten throws of the dice, that a six will come up exactly twice? The probability of a six (or any other number) is 1/6. The following formula combines these factors:</paragraph> +<paragraph id="par_id3149393" role="paragraph" xml-lang="en-US"><item type="input">=B(10;1/6;2)</item> returns a probability of 29%.</paragraph> +</section> + +<section id="rsq"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3158416"> + <bookmark_value>RSQ function</bookmark_value> + <bookmark_value>determination coefficients</bookmark_value> + <bookmark_value>regression analysis</bookmark_value> +</bookmark> +<comment>mw added regression analysis</comment> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_BESTIMMTHEITSMASS" id="bm_id3153228" localize="false"/> + +<h2 id="hd_id3158416">RSQ</h2> +<paragraph id="par_id3154949" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_BESTIMMTHEITSMASS">Returns the square of the Pearson correlation coefficient based on the given values.</ahelp> RSQ (also called determination coefficient) is a measure for the accuracy of an adjustment and can be used to produce a regression analysis.</paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3155822" role="code" xml-lang="en-US">RSQ(DataY; DataX)</paragraph> +<paragraph id="par_id3150470" role="paragraph" xml-lang="en-US"><emph>DataY</emph> is an array or range of data points.</paragraph> +<paragraph id="par_id3153181" role="paragraph" xml-lang="en-US"><emph>DataX</emph> is an array or range of data points.</paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3155991" role="paragraph" xml-lang="en-US"><item type="input">=RSQ(A1:A20;B1:B20)</item> calculates the determination coefficient for both data sets in columns A and B.</paragraph> +</section> + +<section id="betainv"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3145620"> + <bookmark_value>BETAINV function</bookmark_value> + <bookmark_value>cumulative probability density function;inverse of</bookmark_value> +</bookmark> +<comment>mw added one entry</comment> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_BETAINV" id="bm_id3146154" localize="false"/> + +<h2 id="hd_id3145620">BETAINV</h2> +<paragraph id="par_id3149825" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_BETAINV">Returns the inverse of the cumulative Beta probability density function.</ahelp></paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3156300" role="code" xml-lang="en-US">BETAINV(Number; Alpha; Beta [; Start [; End]])</paragraph> +<paragraph id="par_id3149266" role="paragraph" xml-lang="en-US"><emph>Number</emph> is the probability associated with the Beta distribution for the given arguments <emph>Alpha</emph> and <emph>Beta</emph>.</paragraph> +<paragraph id="par_id3149710" role="paragraph" xml-lang="en-US"><emph>Alpha</emph> is a strictly positive parameter of the Beta distribution.</paragraph> +<paragraph id="par_id3156306" role="paragraph" xml-lang="en-US"><emph>Beta</emph> is a strictly positive parameter of the Beta distribution.</paragraph> +<paragraph id="par_id3150960" role="paragraph" xml-lang="en-US"><emph>Start</emph> (optional) is the lower bound of the output range of the function. If omitted, the default value is 0.</paragraph> +<paragraph id="par_id3151268" role="paragraph" xml-lang="en-US"><emph>End</emph> (optional) is the upper bound of the output range of the function. If omitted, the default value is 1.</paragraph> +<paragraph id="par_idN109DF" role="paragraph" localize="false" xml-lang="en-US"><embedvar href="text/scalc/00/00000004.xhp#optional"/></paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3146859" role="paragraph" xml-lang="en-US"><input>=BETAINV(0.5;5;10)</input> returns the value 0.3257511553.</paragraph> +<paragraph role="paragraph" id="par_id871621424421294"><link href="https://wiki.documentfoundation.org/Documentation/Calc_Functions/BETAINV">BETAINV Wiki page</link></paragraph> +</section> + +<section id="betadotinv"> +<bookmark xml-lang="en-US" branch="index" id="bm_id2945620"> +<bookmark_value>BETA.INV function</bookmark_value> +<bookmark_value>cumulative probability density function;inverse of</bookmark_value> +</bookmark> +<comment>mw added one entry</comment> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_BETAINV_MS" id="bm_id2946154" localize="false"/> + +<h2 id="hd_id2945620">BETA.INV</h2> +<paragraph id="par_id2949825" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_BETAINV_MS">Returns the inverse of the cumulative Beta probability density function.</ahelp></paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id2956300" role="code" xml-lang="en-US">BETA.INV(Number; Alpha; Beta [; Start [; End]])</paragraph> +<paragraph id="par_id2949266" role="paragraph" xml-lang="en-US"><emph>Number</emph> is the probability associated with the Beta distribution for the given arguments <emph>Alpha</emph> and <emph>Beta</emph>.</paragraph> +<paragraph id="par_id2949710" role="paragraph" xml-lang="en-US"><emph>Alpha</emph> is a strictly positive parameter of the Beta distribution.</paragraph> +<paragraph id="par_id2956306" role="paragraph" xml-lang="en-US"><emph>Beta</emph> is a strictly positive parameter of the Beta distribution.</paragraph> +<paragraph id="par_id2950960" role="paragraph" xml-lang="en-US"><emph>Start</emph> (optional) is the lower bound of the output range of the function. If omitted, the default value is 0.</paragraph> +<paragraph id="par_id2951268" role="paragraph" xml-lang="en-US"><emph>End</emph> (optional) is the upper bound of the output range of the function. If omitted, the default value is 1.</paragraph> +<paragraph id="par_idN109DFms" role="paragraph" localize="false" xml-lang="en-US"><embedvar href="text/scalc/00/00000004.xhp#optional"/></paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id2946859" role="paragraph" xml-lang="en-US"><input>=BETA.INV(0.5;5;10)</input> returns the value 0.3257511553.</paragraph> +<paragraph role="paragraph" id="par_id841621424421294"><link href="https://wiki.documentfoundation.org/Documentation/Calc_Functions/BETA.INV">BETA.INV Wiki page</link></paragraph> +<embed href="text/scalc/01/common_func.xhp#sectiontechinfo"/> +<embed href="text/scalc/00/avail_release.xhp#4.2"/> +<embed href="text/scalc/01/common_func.xhp#notODFF"/> +<paragraph role="paragraph" id="par_id311640873986703" localize="false"><literal>COM.MICROSOFT.BETA.INV</literal></paragraph> +</section> + +<section id="betadist"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3156096"> + <bookmark_value>BETADIST function</bookmark_value> + <bookmark_value>cumulative probability density function;calculating</bookmark_value> +</bookmark> +<comment>mw added one entry</comment> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_BETAVERT" id="bm_id3153213" localize="false"/> + +<h2 id="hd_id3156096">BETADIST</h2> +<paragraph id="par_id3150880" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_BETAVERT">Returns the beta function.</ahelp></paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3147571" role="code" xml-lang="en-US">BETADIST(Number; Alpha; Beta [; Start [; End [; Cumulative]]])</paragraph> +<paragraph id="par_id3156317" role="paragraph" xml-lang="en-US"><emph>Number</emph> is the value between <emph>Start</emph> and <emph>End</emph> at which to evaluate the function.</paragraph> +<paragraph id="par_id3156107" role="paragraph" xml-lang="en-US"><emph>Alpha</emph> is a parameter to the distribution.</paragraph> +<paragraph id="par_id3153619" role="paragraph" xml-lang="en-US"><emph>Beta</emph> is a parameter to the distribution.</paragraph> +<paragraph id="par_id3150254" role="paragraph" xml-lang="en-US"><emph>Start</emph> (optional) is the lower bound for <emph>Number</emph>.</paragraph> +<paragraph id="par_id3149138" role="paragraph" xml-lang="en-US"><emph>End</emph> (optional) is the upper bound for <emph>Number</emph>.</paragraph> +<paragraph id="par_id012020091254453" role="paragraph" xml-lang="en-US"><emph>Cumulative</emph> (optional) can be 0 or False to calculate the probability density function. It can be any other value or True or omitted to calculate the cumulative distribution function.</paragraph> +<paragraph id="par_idN10AB3" role="paragraph" localize="false" xml-lang="en-US"><embedvar href="text/scalc/00/00000004.xhp#optional"/></paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3156118" role="paragraph" xml-lang="en-US"><item type="input">=BETADIST(0.75;3;4)</item> returns the value 0.96.</paragraph> +</section> + +<section id="betadotdist"> +<bookmark xml-lang="en-US" branch="index" id="bm_id2956096"> + <bookmark_value>BETA.DIST function</bookmark_value> + <bookmark_value>cumulative probability density function;calculating</bookmark_value> +</bookmark> +<comment>mw added one entry</comment> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_BETADIST_MS" id="bm_id2953213" localize="false"/> + +<h2 id="hd_id2956096">BETA.DIST</h2> +<paragraph id="par_id2950880" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_BETADIST_MS">Returns the beta function.</ahelp></paragraph> +<embed href="text/scalc/00/avail_release.xhp#4.2"/> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id2947571" role="code" xml-lang="en-US">BETA.DIST(Number; Alpha; Beta; Cumulative [; Start [; End]])</paragraph> +<paragraph id="par_id2956317" role="paragraph" xml-lang="en-US"><emph>Number</emph> (required) is the value between <emph>Start</emph> and <emph>End</emph> at which to evaluate the function.</paragraph> +<paragraph id="par_id2956107" role="paragraph" xml-lang="en-US"><emph>Alpha</emph> (required) is a parameter to the distribution.</paragraph> +<paragraph id="par_id2953619" role="paragraph" xml-lang="en-US"><emph>Beta</emph> (required) is a parameter to the distribution.</paragraph> +<paragraph id="par_id062920141254453" role="paragraph" xml-lang="en-US"><emph>Cumulative</emph> (required) can be 0 or False to calculate the probability density function. It can be any other value or True to calculate the cumulative distribution function.</paragraph> +<paragraph id="par_id2950254" role="paragraph" xml-lang="en-US"><emph>Start</emph> (optional) is the lower bound for <emph>Number</emph>.</paragraph> +<paragraph id="par_id2949138" role="paragraph" xml-lang="en-US"><emph>End</emph> (optional) is the upper bound for <emph>Number</emph>.</paragraph> +<paragraph id="par_idN10AB3ms" role="paragraph" localize="false" xml-lang="en-US"><embedvar href="text/scalc/00/00000004.xhp#optional"/></paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id2956118" role="paragraph" xml-lang="en-US"><item type="input">=BETA.DIST(2;8;10;1;1;3)</item> returns the value 0.6854706</paragraph> +<paragraph id="par_id2956119" role="paragraph" xml-lang="en-US"><item type="input">=BETA.DIST(2;8;10;0;1;3)</item> returns the value 1.4837646</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectiontechinfo"/> +<embed href="text/scalc/01/common_func.xhp#notODFF"/> +<paragraph role="paragraph" id="par_id341645873986703" localize="false"><literal>COM.MICROSOFT.BETA.DIST</literal></paragraph> +</section> + +<section id="binomdist"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3143228"> + <bookmark_value>BINOMDIST function</bookmark_value> +</bookmark> + +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_BINOMVERT" id="bm_id3150146" localize="false"/> + +<h2 id="hd_id3143228">BINOMDIST</h2> +<paragraph id="par_id3146897" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_BINOMVERT">Returns the individual term binomial distribution probability.</ahelp></paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3156009" role="code" xml-lang="en-US">BINOMDIST(X; Trials; SP; C)</paragraph> +<paragraph id="par_id3154304" role="paragraph" xml-lang="en-US"><emph>X</emph> is the number of successes in a set of trials.</paragraph> +<paragraph id="par_id3147492" role="paragraph" xml-lang="en-US"><emph>Trials</emph> is the number of independent trials.</paragraph> +<paragraph id="par_id3146085" role="paragraph" xml-lang="en-US"><emph>SP</emph> is the probability of success on each trial.</paragraph> +<paragraph id="par_id3149760" role="paragraph" xml-lang="en-US"><emph>C</emph> = 0 calculates the probability of a single event and <emph>C</emph> = 1 calculates the cumulative probability.</paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3145666" role="paragraph" xml-lang="en-US"><item type="input">=BINOMDIST(A1;12;0.5;0)</item> shows (if the values <item type="input">0</item> to <item type="input">12</item> are entered in A1) the probabilities for 12 flips of a coin that <emph>Heads</emph> will come up exactly the number of times entered in A1.</paragraph> +<paragraph id="par_id3150120" role="paragraph" xml-lang="en-US"><item type="input">=BINOMDIST(A1;12;0.5;1)</item> shows the cumulative probabilities for the same series. For example, if A1 = <item type="input">4</item>, the cumulative probability of the series is 0, 1, 2, 3 or 4 times <emph>Heads</emph> (non-exclusive OR).</paragraph> +</section> + +<section id="binomdotdist"> +<bookmark xml-lang="en-US" branch="index" id="bm_id2943228"> + <bookmark_value>BINOM.DIST function</bookmark_value> +</bookmark> + +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_BINOM_DIST_MS" id="bm_id2950146" localize="false"/> + +<h2 id="hd_id2943228">BINOM.DIST</h2> +<paragraph id="par_id2946897" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_BINOM_DIST_MS">Returns the individual term binomial distribution probability.</ahelp></paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id2956009" role="code" xml-lang="en-US">BINOM.DIST(X; Trials; SP; C)</paragraph> +<paragraph id="par_id2954304" role="paragraph" xml-lang="en-US"><emph>X</emph> is the number of successes in a set of trials.</paragraph> +<paragraph id="par_id2947492" role="paragraph" xml-lang="en-US"><emph>Trials</emph> is the number of independent trials.</paragraph> +<paragraph id="par_id2946085" role="paragraph" xml-lang="en-US"><emph>SP</emph> is the probability of success on each trial.</paragraph> +<paragraph id="par_id299760" role="paragraph" xml-lang="en-US"><emph>C</emph> = 0 calculates the probability of a single event and <emph>C</emph> = 1 calculates the cumulative probability.</paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id295666" role="paragraph" xml-lang="en-US"><item type="input">=BINOM.DIST(A1;12;0.5;0)</item> shows (if the values <item type="input">0</item> to <item type="input">12</item> are entered in A1) the probabilities for 12 flips of a coin that <emph>Heads</emph> will come up exactly the number of times entered in A1.</paragraph> +<paragraph id="par_id290120" role="paragraph" xml-lang="en-US"><item type="input">=BINOM.DIST(A1;12;0.5;1)</item> shows the cumulative probabilities for the same series. For example, if A1 = <item type="input">4</item>, the cumulative probability of the series is 0, 1, 2, 3 or 4 times <emph>Heads</emph> (non-exclusive OR).</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectiontechinfo"/> +<embed href="text/scalc/00/avail_release.xhp#4.2"/> +<embed href="text/scalc/01/common_func.xhp#notODFF"/> +<paragraph role="paragraph" id="par_id341640873786703" localize="false"><literal>COM.MICROSOFT.BINOM.DIST</literal></paragraph> +</section> + +<section id="binomdotinv"> +<bookmark xml-lang="en-US" branch="index" id="bm_id2843228"> + <bookmark_value>BINOM.INV function</bookmark_value> +</bookmark> + +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_BINOM_INV_MS" id="bm_id2850146" localize="false"/> + +<h2 id="hd_id2843228">BINOM.INV</h2> +<paragraph id="par_id2846897" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_BINOM_INV_MS">Returns the smallest value for which the cumulative binomial distribution is greater than or equal to a criterion value.</ahelp></paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id2856009" role="code" xml-lang="en-US">BINOM.INV(Trials; SP; Alpha)</paragraph> +<paragraph id="par_id2847492" role="paragraph" xml-lang="en-US"><emph>Trials</emph> The total number of trials.</paragraph> +<paragraph id="par_id2846085" role="paragraph" xml-lang="en-US"><emph>SP</emph> is the probability of success on each trial.</paragraph> +<paragraph id="par_id289760" role="paragraph" xml-lang="en-US"><emph>Alpha</emph> The border probability that is attained or exceeded.</paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id285666" role="paragraph" xml-lang="en-US"><item type="input">=BINOM.INV(8;0.6;0.9)</item> returns 7, the smallest value for which the cumulative binomial distribution is greater than or equal to a criterion value.</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectiontechinfo"/> +<embed href="text/scalc/00/avail_release.xhp#4.2"/> +<embed href="text/scalc/01/common_func.xhp#notODFF"/> +<paragraph role="paragraph" id="par_id341640873986706" localize="false"><literal>COM.MICROSOFT.BINOM.INV</literal></paragraph> +</section> + +<section id="chisqinv"> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_CHISQINV" id="bm_id0119200902430717" localize="false"/> +<bookmark xml-lang="en-US" branch="index" id="bm_id0119200902432928"> + <bookmark_value>CHISQINV function</bookmark_value> +</bookmark> + +<h2 id="hd_id0119200902421451">CHISQINV</h2> +<paragraph id="par_id0119200902421449" role="paragraph" xml-lang="en-US"><ahelp hid=".">Returns the inverse of CHISQDIST.</ahelp></paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id21585771564740" role="code" xml-lang="en-US">CHISQINV(Probability; Degrees of Freedom)</paragraph> +<paragraph id="par_id0119200902475286" role="paragraph" xml-lang="en-US"><emph>Probability</emph> is the probability value for which the inverse of the chi-square distribution is to be calculated.</paragraph> +<paragraph id="par_id0119200902475282" role="paragraph" xml-lang="en-US"><emph>Degrees Of Freedom</emph> is the degrees of freedom for the chi-square function.</paragraph> +</section> + +<section id="chisqdotinv"> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_CHISQINV_MS" id="bm_id2919200902430717" localize="false"/> +<bookmark xml-lang="en-US" branch="index" id="bm_id2919200902432928"> + <bookmark_value>CHISQ.INV function</bookmark_value> +</bookmark> + + +<h2 id="hd_id2919200902421451">CHISQ.INV</h2> +<paragraph id="par_id2919200902421449" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_CHISQINV_MS">Returns the inverse of the left-tailed probability of the chi-square distribution.</ahelp></paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id1150504" role="code" xml-lang="en-US">CHISQ.INV(Probability; DegreesFreedom)</paragraph> +<paragraph id="par_id2919200902475286" role="paragraph" xml-lang="en-US"><emph>Probability</emph> is the probability value for which the inverse of the chi-square distribution is to be calculated.</paragraph> +<paragraph id="par_id2919200902475282" role="paragraph" xml-lang="en-US"><emph>Degrees Of Freedom</emph> is the degrees of freedom for the chi-square function.</paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id275666" role="paragraph" xml-lang="en-US"><item type="input">=CHISQ.INV(0,5;1)</item> returns 0.4549364231.</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectiontechinfo"/> +<embed href="text/scalc/00/avail_release.xhp#4.2"/> +<embed href="text/scalc/01/common_func.xhp#notODFF"/> +<paragraph role="paragraph" id="par_id341640873986753" localize="false"><literal>COM.MICROSOFT.CHISQ.INV</literal></paragraph> +</section> + +<section id="chiinv"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3148835"> + <bookmark_value>CHIINV function</bookmark_value> +</bookmark> + +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_CHIINV" id="bm_id3148823" localize="false"/> + +<h2 id="hd_id3148835">CHIINV</h2> +<paragraph id="par_id3149906" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_CHIINV">Returns the inverse of the one-tailed probability of the chi-squared distribution.</ahelp></paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3150504" role="code" xml-lang="en-US">CHIINV(Number; DegreesFreedom)</paragraph> +<paragraph id="par_id3154898" role="paragraph" xml-lang="en-US"><emph>Number</emph> is the value of the error probability.</paragraph> +<paragraph id="par_id3154294" role="paragraph" xml-lang="en-US"><emph>DegreesFreedom</emph> is the degrees of freedom of the experiment.</paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3150777" role="paragraph" xml-lang="en-US">A die is thrown 1020 times. The numbers on the die 1 through 6 come up 195, 151, 148, 189, 183 and 154 times (observation values). The hypothesis that the die is not fixed is to be tested.</paragraph> +<paragraph id="par_id3153062" role="paragraph" xml-lang="en-US">The Chi square distribution of the random sample is determined by the formula given above. Since the expected value for a given number on the die for n throws is n times 1/6, thus 1020/6 = 170, the formula returns a Chi square value of 13.27.</paragraph> +<paragraph id="par_id3148806" role="paragraph" xml-lang="en-US">If the (observed) Chi square is greater than or equal to the (theoretical) Chi square CHIINV, the hypothesis will be discarded, since the deviation between theory and experiment is too great. If the observed Chi square is less that CHIINV, the hypothesis is confirmed with the indicated probability of error.</paragraph> +<paragraph id="par_id3149763" role="paragraph" xml-lang="en-US"><item type="input">=CHIINV(0.05;5)</item> returns 11.07.</paragraph> +<paragraph id="par_id3159142" role="paragraph" xml-lang="en-US"><item type="input">=CHIINV(0.02;5)</item> returns 13.39.</paragraph> +<paragraph id="par_id3158401" role="paragraph" xml-lang="en-US">If the probability of error is 5%, the die is not true. If the probability of error is 2%, there is no reason to believe it is fixed.</paragraph> +</section> + +<section id="chisqdotinvdotrt"> +<bookmark xml-lang="en-US" branch="index" id="bm_id2948835"> + <bookmark_value>CHISQ.INV.RT function</bookmark_value> +</bookmark> + +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_CHIINV_MS" id="bm_id2948823" localize="false"/> + +<h2 id="hd_id2948835">CHISQ.INV.RT</h2> +<paragraph id="par_id2949906" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_CHIINV_MS">Returns the inverse of the one-tailed probability of the chi-squared distribution.</ahelp></paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id2950504" role="code" xml-lang="en-US">CHISQ.INV.RT(Number; DegreesFreedom)</paragraph> +<paragraph id="par_id2954898" role="paragraph" xml-lang="en-US"><emph>Number</emph> is the value of the error probability.</paragraph> +<paragraph id="par_id2954294" role="paragraph" xml-lang="en-US"><emph>DegreesFreedom</emph> is the degrees of freedom of the experiment.</paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id2950777" role="paragraph" xml-lang="en-US">A die is thrown 1020 times. The numbers on the die 1 through 6 come up 195, 151, 148, 189, 183 and 154 times (observation values). The hypothesis that the die is not fixed is to be tested.</paragraph> +<paragraph id="par_id2953062" role="paragraph" xml-lang="en-US">The Chi square distribution of the random sample is determined by the formula given above. Since the expected value for a given number on the die for n throws is n times 1/6, thus 1020/6 = 170, the formula returns a Chi square value of 13.27.</paragraph> +<paragraph id="par_id2948806" role="paragraph" xml-lang="en-US">If the (observed) Chi square is greater than or equal to the (theoretical) Chi square CHIINV, the hypothesis will be discarded, since the deviation between theory and experiment is too great. If the observed Chi square is less that CHIINV, the hypothesis is confirmed with the indicated probability of error.</paragraph> +<paragraph id="par_id2949763" role="paragraph" xml-lang="en-US"><item type="input">=CHISQ.INV.RT(0.05;5)</item> returns 11.0704976935.</paragraph> +<paragraph id="par_id2959142" role="paragraph" xml-lang="en-US"><item type="input">=CHISQ.INV.RT(0.02;5)</item> returns 13.388222599.</paragraph> +<paragraph id="par_id2958401" role="paragraph" xml-lang="en-US">If the probability of error is 5%, the die is not true. If the probability of error is 2%, there is no reason to believe it is fixed.</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectiontechinfo"/> +<embed href="text/scalc/00/avail_release.xhp#4.2"/> +<embed href="text/scalc/01/common_func.xhp#notODFF"/> +<paragraph role="paragraph" id="par_id341640873983703" localize="false"><literal>COM.MICROSOFT.CHISQ.INV.RT</literal></paragraph> +</section> + +<section id="chitest"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3154260"> + <bookmark_value>CHITEST function</bookmark_value> +</bookmark> + +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_CHITEST" id="bm_id3155355" localize="false"/> + +<h2 id="hd_id3154260">CHITEST</h2> +<paragraph id="par_id3151052" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_CHITEST">Returns the probability of a deviance from a random distribution of two test series based on the chi-squared test for independence.</ahelp> CHITEST returns the chi-squared distribution of the data.</paragraph> +<paragraph id="par_id3148925" role="paragraph" xml-lang="en-US">The probability determined by CHITEST can also be determined with CHIDIST, in which case the Chi square of the random sample must then be passed as a parameter instead of the data row.</paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3149162" role="code" xml-lang="en-US">CHITEST(DataB; DataE)</paragraph> +<paragraph id="par_id3158421" role="paragraph" xml-lang="en-US"><emph>DataB</emph> is the array of the observations.</paragraph> +<paragraph id="par_id3166453" role="paragraph" xml-lang="en-US"><emph>DataE</emph> is the range of the expected values.</paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> + +<embed href="text/scalc/01/04060181.xhp#data_sample"/> + +<paragraph id="par_id3149481" role="paragraph" xml-lang="en-US"><item type="input">=CHITEST(A1:A6;B1:B6)</item> equals 0.02. This is the probability which suffices the observed data of the theoretical Chi-square distribution.</paragraph> +</section> + +<section id="chidottest"> +<bookmark xml-lang="en-US" branch="index" id="bm_id2954260"> + <bookmark_value>CHISQ.TEST function</bookmark_value> +</bookmark> + +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_CHITEST_MS" id="bm_id2955355" localize="false"/> + +<h2 id="hd_id2954260">CHISQ.TEST</h2> +<paragraph id="par_id2951052" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_CHITEST_MS">Returns the probability of a deviance from a random distribution of two test series based on the chi-squared test for independence.</ahelp> CHISQ.TEST returns the chi-squared distribution of the data.</paragraph> +<paragraph id="par_id2948925" role="paragraph" xml-lang="en-US">The probability determined by CHISQ.TEST can also be determined with CHISQ.DIST, in which case the Chi square of the random sample must then be passed as a parameter instead of the data row.</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id2949162" role="code" xml-lang="en-US">CHISQ.TEST(DataB; DataE)</paragraph> +<paragraph id="par_id2958421" role="paragraph" xml-lang="en-US"><emph>DataB</emph> is the array of the observations.</paragraph> +<paragraph id="par_id2966453" role="paragraph" xml-lang="en-US"><emph>DataE</emph> is the range of the expected values.</paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<section id="data_sample"> +<table id="tbl_id2953233"> + <tablerow> + <tablecell> + </tablecell> + <tablecell> + <paragraph id="par_id2954096" role="tablehead" xml-lang="en-US">Data_B (observed)</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id2952948" role="tablehead" xml-lang="en-US">Data_E (expected)</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id2952876" role="tablehead" localize="false" xml-lang="en-US">1</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id2959279" role="tablecontent" localize="false" xml-lang="en-US">195</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id2949105" role="tablecontent" localize="false" xml-lang="en-US">170</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id2949922" role="tablehead" localize="false" xml-lang="en-US">2</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id2948621" role="tablecontent" localize="false" xml-lang="en-US">151</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id2948987" role="tablecontent" localize="false" xml-lang="en-US">170</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id2949417" role="tablehead" localize="false" xml-lang="en-US">3</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id2948661" role="tablecontent" localize="false" xml-lang="en-US">148</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id2951128" role="tablecontent" localize="false" xml-lang="en-US">170</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id2948467" role="tablehead" localize="false" xml-lang="en-US">4</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id2949237" role="tablecontent" localize="false" xml-lang="en-US">189</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id2945304" role="tablecontent" localize="false" xml-lang="en-US">170</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id2949927" role="tablehead" localize="false" xml-lang="en-US">5</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id2950630" role="tablecontent" localize="false" xml-lang="en-US">183</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id2950423" role="tablecontent" localize="false" xml-lang="en-US">170</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id2943275" role="tablehead" localize="false" xml-lang="en-US">6</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id2944750" role="tablecontent" localize="false" xml-lang="en-US">154</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id2953947" role="tablecontent" localize="false" xml-lang="en-US">170</paragraph> + </tablecell> + </tablerow> +</table> +</section> +<paragraph id="par_id2949481" role="paragraph" xml-lang="en-US"><item type="input">=CHISQ.TEST(A1:A6;B1:B6)</item> equals 0.0209708029. This is the probability which suffices the observed data of the theoretical Chi-square distribution.</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectiontechinfo"/> +<embed href="text/scalc/00/avail_release.xhp#4.2"/> +<embed href="text/scalc/01/common_func.xhp#notODFF"/> +<paragraph role="paragraph" id="par_id341640873989703" localize="false"><literal>COM.MICROSOFT.CHISQ.TEST</literal></paragraph> +</section> + +<section id="chidist"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3148690"> + <bookmark_value>CHIDIST function</bookmark_value> +</bookmark> + +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_CHIVERT" id="bm_id3147521" localize="false"/> + +<h2 id="hd_id3148690">CHIDIST</h2> +<paragraph id="par_id3156338" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_CHIVERT">Returns the probability value from the indicated Chi square that a hypothesis is confirmed.</ahelp> CHIDIST compares the Chi square value to be given for a random sample that is calculated from the sum of (observed value-expected value)^2/expected value for all values with the theoretical Chi square distribution and determines from this the probability of error for the hypothesis to be tested.</paragraph> +<paragraph id="par_id3151316" role="paragraph" xml-lang="en-US">The probability determined by CHIDIST can also be determined by CHITEST.</paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3158439" role="code" xml-lang="en-US">CHIDIST(Number; DegreesFreedom)</paragraph> +<paragraph id="par_id3148675" role="paragraph" xml-lang="en-US"><emph>Number</emph> is the chi-square value of the random sample used to determine the error probability.</paragraph> +<paragraph id="par_id3155615" role="paragraph" xml-lang="en-US"><emph>DegreesFreedom</emph> are the degrees of freedom of the experiment.</paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3145774" role="paragraph" xml-lang="en-US"><item type="input">=CHIDIST(13.27; 5)</item> equals 0.02.</paragraph> +<paragraph id="par_id3156141" role="paragraph" xml-lang="en-US">If the Chi square value of the random sample is 13.27 and if the experiment has 5 degrees of freedom, then the hypothesis is assured with a probability of error of 2%.</paragraph> +</section> + +<section id="chisqdotdist"> +<bookmark xml-lang="en-US" branch="index" id="bm_id2848690"> + <bookmark_value>CHISQ.DIST function</bookmark_value> +</bookmark> + +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_CHISQDIST_MS" id="bm_id2947521" localize="false"/> + +<h2 id="hd_id2848690">CHISQ.DIST</h2> +<paragraph id="par_id2856338" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_CHISQDIST_MS">Returns the probability density function or the cumulative distribution function for the chi-square distribution.</ahelp></paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id2858439" role="code" xml-lang="en-US">CHISQ.DIST(Number; DegreesFreedom; Cumulative)</paragraph> +<paragraph id="par_id2848675" role="paragraph" xml-lang="en-US"><emph>Number</emph> is the chi-square value of the random sample used to determine the error probability.</paragraph> +<paragraph id="par_id2855615" role="paragraph" xml-lang="en-US"><emph>DegreesFreedom</emph> are the degrees of freedom of the experiment.</paragraph> +<paragraph id="par_id282020091254453" role="paragraph" xml-lang="en-US"><emph>Cumulative</emph> can be 0 or False to calculate the probability density function. It can be any other value or True to calculate the cumulative distribution function.</paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id2845774" role="paragraph" xml-lang="en-US"><item type="input">=CHISQ.DIST(3; 2; 0) </item>equals 0.1115650801, the probability density function with 2 degrees of freedom, at x = 3.</paragraph> +<paragraph id="par_id2745774" role="paragraph" xml-lang="en-US"><item type="input">=CHISQ.DIST(3; 2; 1) </item>equals 0.7768698399, the cumulative chi-square distribution with 2 degrees of freedom, at the value x = 3.</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectiontechinfo"/> +<embed href="text/scalc/00/avail_release.xhp#4.2"/> +<embed href="text/scalc/01/common_func.xhp#notODFF"/> +<paragraph role="paragraph" id="par_id341640873984703" localize="false"><literal>COM.MICROSOFT.CHISQ.DIST</literal></paragraph> +</section> + +<section id="chisqdotdistdotrt"> +<bookmark xml-lang="en-US" branch="index" id="bm_id2948690"> + <bookmark_value>CHISQ.DIST.RT function</bookmark_value> +</bookmark> + +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_CHIVERT_MS" id="bm_id2947522" localize="false"/> + +<h2 id="hd_id2948690">CHISQ.DIST.RT</h2> +<paragraph id="par_id2956338" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_CHIVERT_MS">Returns the probability value from the indicated Chi square that a hypothesis is confirmed.</ahelp> CHISQ.DIST.RT compares the Chi square value to be given for a random sample that is calculated from the sum of (observed value-expected value)^2/expected value for all values with the theoretical Chi square distribution and determines from this the probability of error for the hypothesis to be tested.</paragraph> +<paragraph id="par_id2951316" role="paragraph" xml-lang="en-US">The probability determined by CHISQ.DIST.RT can also be determined by CHITEST.</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id2958439" role="code" xml-lang="en-US">CHISQ.DIST.RT(Number; DegreesFreedom)</paragraph> +<paragraph id="par_id2948675" role="paragraph" xml-lang="en-US"><emph>Number</emph> is the chi-square value of the random sample used to determine the error probability.</paragraph> +<paragraph id="par_id2955615" role="paragraph" xml-lang="en-US"><emph>DegreesFreedom</emph> are the degrees of freedom of the experiment.</paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id2945774" role="paragraph" xml-lang="en-US"><item type="input">=CHISQ.DIST.RT(13.27; 5)</item> equals 0.0209757694.</paragraph> +<paragraph id="par_id2956141" role="paragraph" xml-lang="en-US">If the Chi square value of the random sample is 13.27 and if the experiment has 5 degrees of freedom, then the hypothesis is assured with a probability of error of 2%.</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectiontechinfo"/> +<embed href="text/scalc/00/avail_release.xhp#4.2"/> +<embed href="text/scalc/01/common_func.xhp#notODFF"/> +<paragraph role="paragraph" id="par_id343640873986703" localize="false"><literal>COM.MICROSOFT.CHISQ.DIST.RT</literal></paragraph> +</section> + +<section id="chisqdist"> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_CHISQDIST" id="bm_id0119200902213671" localize="false"/> +<bookmark xml-lang="en-US" branch="index" id="bm_id0119200902231887"> + <bookmark_value>CHISQDIST function</bookmark_value> + <bookmark_value>chi-square distribution</bookmark_value> +</bookmark> + + +<h2 id="hd_id0119200901583452">CHISQDIST</h2> +<paragraph id="par_id0119200901583471" role="paragraph" xml-lang="en-US"><ahelp hid=".">Returns the value of the probability density function or the cumulative distribution function for the chi-square distribution.</ahelp></paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id0119200902395679" role="code" xml-lang="en-US">CHISQDIST(Number; Degrees Of Freedom [; Cumulative])</paragraph> +<paragraph id="par_id011920090239564" role="paragraph" xml-lang="en-US"><emph>Number</emph> is the number for which the function is to be calculated.</paragraph> +<paragraph id="par_id0119200902395660" role="paragraph" xml-lang="en-US"><emph>Degrees Of Freedom</emph> is the degrees of freedom for the chi-square function.</paragraph> +<paragraph id="par_id0119200902395623" role="paragraph" xml-lang="en-US"><emph>Cumulative</emph> (optional): 0 or False calculates the probability density function. Other values or True or omitted calculates the cumulative distribution function.</paragraph> +</section> + +<section id="expondist"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3150603"> + <bookmark_value>EXPONDIST function</bookmark_value> + <bookmark_value>exponential distributions</bookmark_value> +</bookmark> + +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_EXPONVERT" id="bm_id3152962" localize="false"/> + +<h2 id="hd_id3150603">EXPONDIST</h2> +<paragraph id="par_id3149563" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_EXPONVERT">Returns the exponential distribution.</ahelp></paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3150987" role="code" xml-lang="en-US">EXPONDIST(Number; Lambda; C)</paragraph> +<paragraph id="par_id3154663" role="paragraph" xml-lang="en-US"><emph>Number</emph> is the value of the function.</paragraph> +<paragraph id="par_id3154569" role="paragraph" xml-lang="en-US"><emph>Lambda</emph> is the parameter value.</paragraph><comment>UFI removed a double bookmark</comment> +<paragraph id="par_id3147332" role="paragraph" xml-lang="en-US"><emph>C</emph> is a logical value that determines the form of the function. <emph>C = 0</emph> calculates the density function, and <emph>C = 1</emph> calculates the distribution.</paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3150357" role="paragraph" xml-lang="en-US"><item type="input">=EXPONDIST(3;0.5;1)</item> returns 0.78.</paragraph> +</section> + +<section id="expondotdist"> +<bookmark xml-lang="en-US" branch="index" id="bm_id2950603"> + <bookmark_value>EXPON.DIST function</bookmark_value> + <bookmark_value>exponential distributions</bookmark_value> +</bookmark> + +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_EXP_DIST_MS" id="bm_id2952962" localize="false"/> + +<h2 id="hd_id2950603">EXPON.DIST</h2> +<paragraph id="par_id2949563" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_EXP_DIST_MS">Returns the exponential distribution.</ahelp></paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id2950987" role="code" xml-lang="en-US">EXPON.DIST(Number; Lambda; C)</paragraph> +<paragraph id="par_id2954663" role="paragraph" xml-lang="en-US"><emph>Number</emph> is the value of the function.</paragraph> +<paragraph id="par_id2954569" role="paragraph" xml-lang="en-US"><emph>Lambda</emph> is the parameter value.</paragraph><comment>UFI removed a double bookmark</comment> +<paragraph id="par_id2947332" role="paragraph" xml-lang="en-US"><emph>C</emph> is a logical value that determines the form of the function. <emph>C = 0</emph> calculates the density function, and <emph>C = 1</emph> calculates the distribution.</paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id2950357" role="paragraph" xml-lang="en-US"><item type="input">=EXPON.DIST(3;0.5;1)</item> returns 0.7768698399.</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectiontechinfo"/> +<embed href="text/scalc/00/avail_release.xhp#4.2"/> +<embed href="text/scalc/01/common_func.xhp#notODFF"/> +<paragraph role="paragraph" id="par_id341660873986703" localize="false"><literal>COM.MICROSOFT.EXPON.DIST</literal></paragraph> +</section> +</sort> + +<section id="relatedtopics"> +<embed href="text/scalc/01/04060100.xhp#drking"/> +</section> +</body> + +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/04060182.xhp b/helpcontent2/source/text/scalc/01/04060182.xhp new file mode 100644 index 000000000..8591243a9 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/04060182.xhp @@ -0,0 +1,496 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . + --> + +<meta> + <topic id="textscalc0104060182xml" indexer="include"> + <title xml-lang="en-US" id="tit">Statistical Functions Part Two</title> + <filename>/text/scalc/01/04060182.xhp</filename> + </topic> + </meta> + <body> + <h1 id="hd_id3154372"><variable id="fh"><link href="text/scalc/01/04060182.xhp" name="Statistical Functions Part Two">Statistical Functions Part Two</link> +</variable></h1> +<sort order="asc" descendant="h2"> +<section id="finv"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3145388"><bookmark_value>FINV function</bookmark_value> + <bookmark_value>inverse F probability distribution</bookmark_value> +</bookmark><comment>mw added one entry</comment> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_FINV" id="bm_id3146113" localize="false"/> +<h2 id="hd_id3145388">FINV</h2> + <paragraph xml-lang="en-US" id="par_id3155089" role="paragraph"><ahelp hid="HID_FUNC_FINV">Returns the inverse of the F probability distribution.</ahelp> The F distribution is used for F tests in order to set the relation between two differing data sets.</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph xml-lang="en-US" id="par_id3153068" role="code">FINV(Number; DegreesFreedom1; DegreesFreedom2)</paragraph> + <paragraph xml-lang="en-US" id="par_id3146866" role="paragraph"> + <emph>Number</emph> is probability value for which the inverse F distribution is to be calculated.</paragraph> + <paragraph xml-lang="en-US" id="par_id3153914" role="paragraph"> + <emph>DegreesFreedom1</emph> is the number of degrees of freedom in the numerator of the F distribution.</paragraph> + <paragraph xml-lang="en-US" id="par_id3148607" role="paragraph"> + <emph>DegreesFreedom2</emph> is the number of degrees of freedom in the denominator of the F distribution.</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph xml-lang="en-US" id="par_id3145073" role="paragraph"> + <item type="input">=FINV(0.5;5;10)</item> yields 0.93.</paragraph> + </section> +<section id="fdotinv"> + <bookmark xml-lang="en-US" branch="index" id="bm_id2945388"> + <bookmark_value>F.INV function</bookmark_value> + <bookmark_value>Values of the inverse left tail of the F distribution</bookmark_value> + </bookmark> + <comment>mw added one entry</comment> + <bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_F_INV_LT" id="bm_id2946113" localize="false"/> + <h2 id="hd_id2945388">F.INV</h2> + <paragraph xml-lang="en-US" id="par_id2955089" role="paragraph"><ahelp hid="HID_FUNC_F_INV_LT">Returns the inverse of the cumulative F distribution.</ahelp> The F distribution is used for F tests in order to set the relation between two differing data sets.</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph xml-lang="en-US" id="par_id2953068" role="code">F.INV(Number; DegreesFreedom1; DegreesFreedom2)</paragraph> + <paragraph xml-lang="en-US" id="par_id2946866" role="paragraph"><emph>Number</emph> is probability value for which the inverse F distribution is to be calculated.</paragraph> + <paragraph xml-lang="en-US" id="par_id2953914" role="paragraph"><emph>DegreesFreedom1</emph> is the number of degrees of freedom in the numerator of the F distribution.</paragraph> + <paragraph xml-lang="en-US" id="par_id2948607" role="paragraph"><emph>DegreesFreedom2</emph> is the number of degrees of freedom in the denominator of the F distribution.</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph xml-lang="en-US" id="par_id2945073" role="paragraph"><item type="input">=F.INV(0.5;5;10)</item> yields 0.9319331609.</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectiontechinfo"/> + <embed href="text/scalc/00/avail_release.xhp#4.2"/> + <embed href="text/scalc/01/common_func.xhp#notODFF"/> + <paragraph role="paragraph" id="par_id341640873984703" localize="false"><literal>COM.MICROSOFT.F.INV</literal></paragraph> +</section> +<section id="fdotinvdotrt"> + <bookmark xml-lang="en-US" branch="index" id="bm_id2845388"> + <bookmark_value>F.INV.RT function</bookmark_value> + <bookmark_value>Values of the inverse right tail of the F distribution</bookmark_value> + </bookmark> + <comment>mw added one entry</comment> + <bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_F_INV_RT" id="bm_id2846113" localize="false"/> + <h2 id="hd_id2845388">F.INV.RT</h2> + <paragraph xml-lang="en-US" id="par_id2855089" role="paragraph"><ahelp hid="HID_FUNC_F_INV_RT">Returns the inverse right tail of the F distribution.</ahelp></paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph xml-lang="en-US" id="par_id2853068" role="code">F.INV.RT(Number; DegreesFreedom1; DegreesFreedom2)</paragraph> + <paragraph xml-lang="en-US" id="par_id2846866" role="paragraph"><emph>Number</emph> is probability value for which the inverse F distribution is to be calculated.</paragraph> + <paragraph xml-lang="en-US" id="par_id2853914" role="paragraph"><emph>DegreesFreedom1</emph> is the number of degrees of freedom in the numerator of the F distribution.</paragraph> + <paragraph xml-lang="en-US" id="par_id2848607" role="paragraph"><emph>DegreesFreedom2</emph> is the number of degrees of freedom in the denominator of the F distribution.</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph xml-lang="en-US" id="par_id2845073" role="paragraph"><item type="input">=F.INV.RT(0.5;5;10)</item> yields 0.9319331609.</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectiontechinfo"/> + <embed href="text/scalc/00/avail_release.xhp#4.2"/> + <embed href="text/scalc/01/common_func.xhp#notODFF"/> + <paragraph role="paragraph" id="par_id341660873986703" localize="false"><literal>COM.MICROSOFT.F.INV.RT</literal></paragraph> +</section> + <section id="fisher"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3150888"><bookmark_value>FISHER function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_FISHER" id="bm_id3146782" localize="false"/> +<h2 id="hd_id3150888">FISHER</h2> + <paragraph xml-lang="en-US" id="par_id3155384" role="paragraph"><ahelp hid="HID_FUNC_FISHER">Returns the Fisher transformation for x and creates a function close to a normal distribution.</ahelp></paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph xml-lang="en-US" id="par_id3143220" role="code">FISHER(Number)</paragraph> + <paragraph xml-lang="en-US" id="par_id3159228" role="paragraph"> + <emph>Number</emph> is the value to be transformed.</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph xml-lang="en-US" id="par_id3149383" role="paragraph"> + <item type="input">=FISHER(0.5)</item> yields 0.55.</paragraph> + </section> + <section id="fisherinv"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3155758"><bookmark_value>FISHERINV function</bookmark_value> + <bookmark_value>inverse of Fisher transformation</bookmark_value> +</bookmark><comment>mw added one entry</comment> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_FISHERINV" id="bm_id3149317" localize="false"/> +<h2 id="hd_id3155758">FISHERINV</h2> + <paragraph xml-lang="en-US" id="par_id3154734" role="paragraph"><ahelp hid="HID_FUNC_FISHERINV">Returns the inverse of the Fisher transformation for x and creates a function close to a normal distribution.</ahelp></paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph xml-lang="en-US" id="par_id3146108" role="code">FISHERINV(Number)</paragraph> + <paragraph xml-lang="en-US" id="par_id3145115" role="paragraph"> + <emph>Number</emph> is the value that is to undergo reverse-transformation.</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph xml-lang="en-US" id="par_id3150432" role="paragraph"> + <item type="input">=FISHERINV(0.5)</item> yields 0.46.</paragraph> + </section> + <section id="ftest"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3151390"><bookmark_value>FTEST function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_FTEST" id="bm_id3159263" localize="false"/> +<h2 id="hd_id3151390">FTEST</h2> + <paragraph xml-lang="en-US" id="par_id3150534" role="paragraph"><ahelp hid="HID_FUNC_FTEST">Returns the result of an F test.</ahelp></paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph xml-lang="en-US" id="par_id3153024" role="code">FTEST(Data1; Data2)</paragraph> + <paragraph xml-lang="en-US" id="par_id3150032" role="paragraph"> + <emph>Data1</emph> is the first record array.</paragraph> + <paragraph xml-lang="en-US" id="par_id3153018" role="paragraph"> + <emph>Data2</emph> is the second record array.</paragraph> + <embed href="text/scalc/01/common_func.xhp#datenumbersequencenote"/> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph xml-lang="en-US" id="par_id3159126" role="paragraph"> + <item type="input">=FTEST(A1:A30;B1:B12)</item> calculates whether the two data sets are different in their variance and returns the probability that both sets could have come from the same total population.</paragraph> + </section> +<section id="fdottest"> + <bookmark xml-lang="en-US" branch="index" id="bm_id2951390"> + <bookmark_value>F.TEST function</bookmark_value> + </bookmark> + <bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_F_TEST_MS" id="bm_id2959263" localize="false"/> + <h2 id="hd_id2951390">F.TEST</h2> + <paragraph xml-lang="en-US" id="par_id2950534" role="paragraph"><ahelp hid="HID_FUNC_F_TEST_MS">Returns the result of an F test.</ahelp></paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph xml-lang="en-US" id="par_id2953024" role="code">F.TEST(Data1; Data2)</paragraph> + <paragraph xml-lang="en-US" id="par_id2950032" role="paragraph"><emph>Data1</emph> is the first record array.</paragraph> + <paragraph xml-lang="en-US" id="par_id2953018" role="paragraph"><emph>Data2</emph> is the second record array.</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph xml-lang="en-US" id="par_id2959126" role="paragraph"><item type="input">=F.TEST(A1:A30;B1:B12)</item> calculates whether the two data sets are different in their variance and returns the probability that both sets could have come from the same total population.</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectiontechinfo"/> + <embed href="text/scalc/00/avail_release.xhp#4.2"/> + <embed href="text/scalc/01/common_func.xhp#notODFF"/> + <paragraph role="paragraph" id="par_id341640273986703" localize="false"><literal>COM.MICROSOFT.F.TEST</literal></paragraph> +</section> + <section id="fdist"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3150372"><bookmark_value>FDIST function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_FVERT" id="bm_id3149722" localize="false"/> +<h2 id="hd_id3150372">FDIST</h2> + <paragraph xml-lang="en-US" id="par_id3152981" role="paragraph"><ahelp hid="HID_FUNC_FVERT">Calculates the values of an F distribution.</ahelp></paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph xml-lang="en-US" id="par_id3145826" role="code">FDIST(Number; DegreesFreedom1; DegreesFreedom2)</paragraph> + <paragraph xml-lang="en-US" id="par_id3150461" role="paragraph"> + <emph>Number</emph> is the value for which the F distribution is to be calculated.</paragraph> + <paragraph xml-lang="en-US" id="par_id3150029" role="paragraph"> + <emph>degreesFreedom1</emph> is the degrees of freedom in the numerator in the F distribution.</paragraph> + <paragraph xml-lang="en-US" id="par_id3146877" role="paragraph"> + <emph>degreesFreedom2</emph> is the degrees of freedom in the denominator in the F distribution.</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph xml-lang="en-US" id="par_id3150696" role="paragraph"> + <item type="input">=FDIST(0.8;8;12)</item> yields 0.61.</paragraph> + </section> +<section id="fdotdist"> + <bookmark xml-lang="en-US" branch="index" id="bm_id2950372"> + <bookmark_value>F.DIST function</bookmark_value> + </bookmark> + <bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_F_DIST_LT" id="bm_id2949722" localize="false"/> + <h2 id="hd_id2950372">F.DIST</h2> + <paragraph xml-lang="en-US" id="par_id2952981" role="paragraph"><ahelp hid="HID_FUNC_F_DIST_LT">Calculates the values of the left tail of the F distribution.</ahelp></paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph xml-lang="en-US" id="par_id2945826" role="code">F.DIST(Number; DegreesFreedom1; DegreesFreedom2 [; Cumulative])</paragraph> + <paragraph xml-lang="en-US" id="par_id2950461" role="paragraph"><emph>Number</emph> is the value for which the F distribution is to be calculated.</paragraph> + <paragraph xml-lang="en-US" id="par_id2950029" role="paragraph"><emph>degreesFreedom1</emph> is the degrees of freedom in the numerator in the F distribution.</paragraph> + <paragraph xml-lang="en-US" id="par_id2946877" role="paragraph"><emph>degreesFreedom2</emph> is the degrees of freedom in the denominator in the F distribution.</paragraph> + <paragraph xml-lang="en-US" id="par_id2946878" role="paragraph"><emph>Cumulative</emph> = 0 or False calculates the density function <emph>Cumulative</emph> = 1 or True calculates the distribution.</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph xml-lang="en-US" id="par_id2950696" role="paragraph"><item type="input">=F.DIST(0.8;8;12;0)</item> yields 0.7095282499.</paragraph> + <paragraph xml-lang="en-US" id="par_id2950697" role="paragraph"><item type="input">=F.DIST(0.8;8;12;1)</item> yields 0.3856603563.</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectiontechinfo"/> + <embed href="text/scalc/00/avail_release.xhp#4.2"/> + <embed href="text/scalc/01/common_func.xhp#notODFF"/> + <paragraph role="paragraph" id="par_id341640873986707" localize="false"><literal>COM.MICROSOFT.F.DIST</literal></paragraph> +</section> +<section id="fdotdistdotrt"> + <bookmark xml-lang="en-US" branch="index" id="bm_id2850372"> + <bookmark_value>F.DIST.RT function</bookmark_value> + </bookmark> + <bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_F_DIST_RT" id="bm_id289722" localize="false"/> + <h2 id="hd_id280372">F.DIST.RT</h2> + <paragraph xml-lang="en-US" id="par_id2852981" role="paragraph"><ahelp hid="HID_FUNC_F_DIST_RT">Calculates the values of the right tail of the F distribution.</ahelp></paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph xml-lang="en-US" id="par_id2845826" role="code">F.DIST.RT(Number; DegreesFreedom1; DegreesFreedom2)</paragraph> + <paragraph xml-lang="en-US" id="par_id2850461" role="paragraph"><emph>Number</emph> is the value for which the F distribution is to be calculated.</paragraph> + <paragraph xml-lang="en-US" id="par_id2850029" role="paragraph"><emph>degreesFreedom1</emph> is the degrees of freedom in the numerator in the F distribution.</paragraph> + <paragraph xml-lang="en-US" id="par_id2846877" role="paragraph"><emph>degreesFreedom2</emph> is the degrees of freedom in the denominator in the F distribution.</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph xml-lang="en-US" id="par_id2850696" role="paragraph"><item type="input">=F.DIST.RT(0.8;8;12)</item> yields 0.6143396437.</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectiontechinfo"/> + <embed href="text/scalc/00/avail_release.xhp#4.2"/> + <embed href="text/scalc/01/common_func.xhp#notODFF"/> + <paragraph role="paragraph" id="par_id341640873986763" localize="false"><literal>COM.MICROSOFT.F.DIST.RT</literal></paragraph> +</section> + <section id="gamma"> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_GAMMA" id="bm_id0119200903221254" localize="false"/> +<bookmark xml-lang="en-US" branch="index" id="bm_id0119200903223192"><bookmark_value>GAMMA function</bookmark_value> +</bookmark> +<h2 id="hd_id0119200903205393">GAMMA</h2> + <paragraph xml-lang="en-US" id="par_id0119200903205379" role="paragraph"><ahelp hid=".">Returns the Gamma function value.</ahelp> Note that GAMMAINV is not the inverse of GAMMA, but of GAMMADIST.</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph id="par_id211585771824267" role="code" xml-lang="en-US">GAMMA(Number)</paragraph> + <paragraph xml-lang="en-US" id="par_id0119200903271614" role="paragraph"> + <emph>Number</emph> is the number for which the Gamma function value is to be calculated.</paragraph> + </section> + <section id="gammainv"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3154841"><bookmark_value>GAMMAINV function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_GAMMAINV" id="bm_id3149249" localize="false"/> +<h2 id="hd_id3154841">GAMMAINV</h2> + <paragraph xml-lang="en-US" id="par_id3153932" role="paragraph"><ahelp hid="HID_FUNC_GAMMAINV">Returns the inverse of the Gamma cumulative distribution GAMMADIST.</ahelp> This function allows you to search for variables with different distribution.</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph xml-lang="en-US" id="par_id3155828" role="code">GAMMAINV(Number; Alpha; Beta)</paragraph> + <paragraph xml-lang="en-US" id="par_id3145138" role="paragraph"> + <emph>Number</emph> is the probability value for which the inverse Gamma distribution is to be calculated.</paragraph> + <paragraph xml-lang="en-US" id="par_id3152785" role="paragraph"> + <emph>Alpha</emph> is the parameter Alpha of the Gamma distribution.</paragraph> + <paragraph xml-lang="en-US" id="par_id3154561" role="paragraph"> + <emph>Beta</emph> is the parameter Beta of the Gamma distribution.</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph xml-lang="en-US" id="par_id3153331" role="paragraph"> + <item type="input">=GAMMAINV(0.8;1;1)</item> yields 1.61.</paragraph> + </section> + <section id="gammadotinv"> +<bookmark xml-lang="en-US" branch="index" id="bm_id2914841"><bookmark_value>GAMMA.INV function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_GAMMAINV_MS" id="bm_id2919249" localize="false"/> +<h2 id="hd_id2914841">GAMMA.INV</h2> + <paragraph xml-lang="en-US" id="par_id2913932" role="paragraph"><ahelp hid="HID_FUNC_GAMMAINV_MS">Returns the inverse of the Gamma cumulative distribution GAMMADIST.</ahelp> This function allows you to search for variables with different distribution.</paragraph> + <paragraph id="par_id291422405814" role="paragraph" xml-lang="en-US">This function is identical to GAMMAINV and was introduced for interoperability with other office suites.</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph xml-lang="en-US" id="par_id2915828" role="code">GAMMA.INV(Number; Alpha; Beta)</paragraph> + <paragraph xml-lang="en-US" id="par_id2915138" role="paragraph"> + <emph>Number</emph> is the probability value for which the inverse Gamma distribution is to be calculated.</paragraph> + <paragraph xml-lang="en-US" id="par_id2912785" role="paragraph"> + <emph>Alpha</emph> is the parameter Alpha of the Gamma distribution.</paragraph> + <paragraph xml-lang="en-US" id="par_id2914561" role="paragraph"> + <emph>Beta</emph> is the parameter Beta of the Gamma distribution.</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph xml-lang="en-US" id="par_id2913331" role="paragraph"> + <item type="input">=GAMMA.INV(0.8;1;1)</item> yields 1.61.</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectiontechinfo"/> + <embed href="text/scalc/00/avail_release.xhp#4.3"/> + <embed href="text/scalc/01/common_func.xhp#notODFF"/> + <paragraph role="paragraph" id="par_id341630873986703" localize="false"><literal>COM.MICROSOFT.GAMMA.INV</literal></paragraph> + </section> + <section id="gammaln"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3154806"><bookmark_value>GAMMALN function</bookmark_value> + <bookmark_value>natural logarithm of Gamma function</bookmark_value> +</bookmark><comment>mw added one entry</comment> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_GAMMALN" id="bm_id3149511" localize="false"/> +<h2 id="hd_id3154806">GAMMALN</h2> + <paragraph xml-lang="en-US" id="par_id3148572" role="paragraph"><ahelp hid="HID_FUNC_GAMMALN">Returns the natural logarithm of the Gamma function: G(x).</ahelp></paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph xml-lang="en-US" id="par_id3153112" role="code">GAMMALN(Number)</paragraph> + <paragraph xml-lang="en-US" id="par_id3154502" role="paragraph"> + <emph>Number</emph> is the value for which the natural logarithm of the Gamma function is to be calculated.</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph xml-lang="en-US" id="par_id3153730" role="paragraph"> + <item type="input">=GAMMALN(2)</item> yields 0.</paragraph> + </section> + <section id="gammalnprecise"> +<bookmark xml-lang="en-US" branch="index" id="bm_id2914806"><bookmark_value>GAMMALN.PRECISE function</bookmark_value> + <bookmark_value>natural logarithm of Gamma function</bookmark_value> +</bookmark><comment>mw added one entry</comment> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_GAMMALN_MS" id="bm_id2919511" localize="false"/> +<h2 id="hd_id2914806">GAMMALN.PRECISE</h2> + <paragraph xml-lang="en-US" id="par_id2918572" role="paragraph"><ahelp hid="HID_FUNC_GAMMALN_MS">Returns the natural logarithm of the Gamma function: G(x).</ahelp></paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph xml-lang="en-US" id="par_id2913112" role="code">GAMMALN.PRECISE(Number)</paragraph> + <paragraph xml-lang="en-US" id="par_id2914502" role="paragraph"> + <emph>Number</emph> is the value for which the natural logarithm of the Gamma function is to be calculated.</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph xml-lang="en-US" id="par_id2913730" role="paragraph"> + <item type="input">=GAMMALN.PRECISE(2)</item> yields 0.</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectiontechinfo"/> + <embed href="text/scalc/00/avail_release.xhp#4.3"/> + <embed href="text/scalc/01/common_func.xhp#notODFF"/> + <paragraph role="paragraph" id="par_id541640873986703" localize="false"><literal>COM.MICROSOFT.GAMMALN.PRECISE</literal></paragraph> + </section> + <section id="gammadist"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3150132"><bookmark_value>GAMMADIST function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_GAMMAVERT" id="bm_id3154330" localize="false"/> +<h2 id="hd_id3150132">GAMMADIST</h2> + <paragraph xml-lang="en-US" id="par_id3155931" role="paragraph"><ahelp hid="HID_FUNC_GAMMAVERT">Returns the values of a Gamma distribution.</ahelp></paragraph> + <paragraph xml-lang="en-US" id="par_id0119200903333675" role="paragraph">The inverse function is GAMMAINV.</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph xml-lang="en-US" id="par_id3155436" role="code">GAMMADIST(Number; Alpha; Beta [; C])</paragraph> + <paragraph xml-lang="en-US" id="par_id3150571" role="paragraph"> + <emph>Number</emph> is the value for which the Gamma distribution is to be calculated.</paragraph> + <paragraph xml-lang="en-US" id="par_id3145295" role="paragraph"> + <emph>Alpha</emph> is the parameter Alpha of the Gamma distribution.</paragraph> + <paragraph xml-lang="en-US" id="par_id3151015" role="paragraph"> + <emph>Beta</emph> is the parameter Beta of the Gamma distribution.</paragraph> + <paragraph xml-lang="en-US" id="par_id3157972" role="paragraph"> + <emph>C</emph> (optional) = 0 or False calculates the density function <emph>C</emph> = 1 or True calculates the distribution.</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph xml-lang="en-US" id="par_id3145354" role="paragraph"> + <item type="input">=GAMMADIST(2;1;1;1)</item> yields 0.86.</paragraph> + </section> + <section id="gammadotdist"> +<bookmark xml-lang="en-US" branch="index" id="bm_id240620142206421"> +<bookmark_value>GAMMA.DIST function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_GAMMADIST_MS" id="bm_id2406201421290724" localize="false"/> +<h2 id="hd_id2406201422120061">GAMMA.DIST</h2> +<paragraph id="par_id2406201422414690" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_GAMMADIST_MS">Returns the values of a Gamma distribution.</ahelp></paragraph> +<paragraph id="par_id24061422414690" role="paragraph" xml-lang="en-US">The inverse function is GAMMAINV or GAMMA.INV.</paragraph> +<paragraph id="par_id2406201422405814" role="paragraph" xml-lang="en-US">This function is similar to GAMMADIST and was introduced for interoperability with other office suites.</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id240620142238475" role="code" xml-lang="en-US">GAMMA.DIST(Number; Alpha; Beta; Cumulative)</paragraph> +<paragraph id="par_id2406201422385134" role="paragraph" xml-lang="en-US"><emph>Number</emph> is the value for which the Gamma distribution is to be calculated.</paragraph> +<paragraph id="par_id2406201422385590" role="paragraph" xml-lang="en-US"><emph>Alpha</emph> is the parameter Alpha of the Gamma distribution.</paragraph> +<paragraph id="par_id2406201422390458" role="paragraph" xml-lang="en-US"><emph>Beta</emph> is the parameter Beta of the Gamma distribution.</paragraph> +<paragraph id="par_id2406201422391058" role="paragraph" xml-lang="en-US"><emph>Cumulative</emph> = 0 or False calculates the probability density function; <emph>Cumulative</emph> = 1, True, or any other value calculates the cumulative distribution function.</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id2406201422392251" role="paragraph" xml-lang="en-US"><item type="input">=GAMMA.DIST(2;1;1;1)</item> yields 0.86.</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectiontechinfo"/> +<embed href="text/scalc/00/avail_release.xhp#4.3"/> +<embed href="text/scalc/01/common_func.xhp#notODFF"/> +<paragraph role="paragraph" id="par_id341640273086703" localize="false"><literal>COM.MICROSOFT.GAMMA.DIST</literal></paragraph> +</section> + <section id="gauss"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3150272"><bookmark_value>GAUSS function</bookmark_value> + <bookmark_value>normal distribution; standard</bookmark_value> +</bookmark><comment>mw added one entry</comment> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_GAUSS" id="bm_id3149388" localize="false"/> +<h2 id="hd_id3150272">GAUSS</h2> + <paragraph xml-lang="en-US" id="par_id3149030" role="paragraph"><ahelp hid="HID_FUNC_GAUSS">Returns the standard normal cumulative distribution.</ahelp></paragraph> + <paragraph xml-lang="en-US" id="par_id2059694" role="paragraph">It is GAUSS(x)=NORMSDIST(x)-0.5</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph xml-lang="en-US" id="par_id3155368" role="code">GAUSS(Number)</paragraph> + <paragraph xml-lang="en-US" id="par_id3153228" role="paragraph"> + <emph>Number</emph> is the value for which the value of the standard normal distribution is to be calculated.</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph xml-lang="en-US" id="par_id3154867" role="paragraph"> + <item type="input">=GAUSS(0.19)</item> = 0.08</paragraph> + <paragraph xml-lang="en-US" id="par_id3148594" role="paragraph"> + <item type="input">=GAUSS(0.0375)</item> = 0.01</paragraph> + </section> + <section id="geomean"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3148425"><bookmark_value>GEOMEAN function</bookmark_value> + <bookmark_value>means;geometric</bookmark_value> +</bookmark><comment>mw added one entry</comment> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_GEOMITTEL" id="bm_id3149777" localize="false"/> +<h2 id="hd_id3148425">GEOMEAN</h2> + <paragraph xml-lang="en-US" id="par_id3156257" role="paragraph"><ahelp hid="HID_FUNC_GEOMITTEL">Returns the geometric mean of a sample.</ahelp></paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph xml-lang="en-US" id="par_id3153720" role="code">GEOMEAN(<embedvar href="text/scalc/01/ful_func.xhp#number255_1" markup="keep"/>)</paragraph> + <embed href="text/scalc/01/ful_func.xhp#number255"/> + <embed href="text/scalc/01/common_func.xhp#datenumbersequencenote"/> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph xml-lang="en-US" id="par_id3149819" role="paragraph"> + <item type="input">=GEOMEAN(23;46;69)</item> = 41.79. The geometric mean value of this random sample is therefore 41.79.</paragraph> + </section> + <section id="trimmean"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3152966"><bookmark_value>TRIMMEAN function</bookmark_value> + <bookmark_value>means;of data set without margin data</bookmark_value> +</bookmark><comment>mw added one entry</comment> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_GESTUTZTMITTEL" id="bm_id3145081" localize="false"/> +<h2 id="hd_id3152966">TRIMMEAN</h2> + <paragraph xml-lang="en-US" id="par_id3149716" role="paragraph"><ahelp hid="HID_FUNC_GESTUTZTMITTEL">Returns the mean of a data set without the Alpha percent of data at the margins.</ahelp></paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph xml-lang="en-US" id="par_id3154821" role="code">TRIMMEAN(Data; Alpha)</paragraph> + <paragraph xml-lang="en-US" id="par_id3155834" role="paragraph"> + <emph>Data</emph> is the array of data in the sample.</paragraph> + <paragraph xml-lang="en-US" id="par_id3156304" role="paragraph"> + <emph>Alpha</emph> is the percentage of the marginal data that will not be taken into consideration.</paragraph> + <embed href="text/scalc/01/common_func.xhp#datenumbersequencenote"/> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph xml-lang="en-US" id="par_id3156130" role="paragraph"> + <item type="input">=TRIMMEAN(A1:A50; 0.1)</item> calculates the mean value of numbers in A1:A50, without taking into consideration the 5 percent of the values representing the highest values and the 5 percent of the values representing the lowest ones. The percentage numbers refer to the amount of the untrimmed mean value, not to the number of summands.</paragraph> + </section> + <section id="ztest"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3153216"><bookmark_value>ZTEST function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_GTEST" id="bm_id3147569" localize="false"/> +<h2 id="hd_id3153216">ZTEST</h2> + <paragraph xml-lang="en-US" id="par_id3150758" role="paragraph"><ahelp hid="HID_FUNC_GTEST">Calculates the probability of observing a z-statistic greater than the one computed based on a sample.</ahelp></paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph xml-lang="en-US" id="par_id3153274" role="code">ZTEST(Data; mu [; Sigma])</paragraph> + <paragraph xml-lang="en-US" id="par_id3156109" role="paragraph"> + <emph>Data</emph> is the given sample, drawn from a normally distributed population.</paragraph> + <paragraph xml-lang="en-US" id="par_id3149977" role="paragraph"> + <emph>mu</emph> is the known mean of the population.</paragraph> + <paragraph xml-lang="en-US" id="par_id3154740" role="paragraph"> + <emph>Sigma</emph> (optional) is the known standard deviation of the population. If omitted, the standard deviation of the given sample is used.</paragraph> + <paragraph xml-lang="en-US" id="par_id0305200911372999" role="paragraph">See also the <link href="https://wiki.documentfoundation.org/Documentation/How_Tos/Calc:_ZTEST_function" name="wiki.documentfoundation.org Documentation/HowTo/Calc/ZTEST function">Wiki page</link>.</paragraph> + <embed href="text/scalc/01/common_func.xhp#datenumbersequencenote"/> + </section> +<section id="zdottest"> +<bookmark xml-lang="en-US" branch="index" id="bm_id2953216"><bookmark_value>Z.TEST function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_Z_TEST_MS" id="bm_id2947569" localize="false"/> +<h2 id="hd_id2953216">Z.TEST</h2> +<paragraph xml-lang="en-US" id="par_id2950758" role="paragraph"><ahelp hid="HID_FUNC_Z_TEST_MS">Calculates the probability of observing a z-statistic greater than the one computed based on a sample.</ahelp></paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph xml-lang="en-US" id="par_id2953274" role="code">Z.TEST(Data; mu [; Sigma])</paragraph> +<paragraph xml-lang="en-US" id="par_id2956109" role="paragraph"><emph>Data</emph> is the given sample, drawn from a normally distributed population.</paragraph> +<paragraph xml-lang="en-US" id="par_id2949977" role="paragraph"><emph>mu</emph> is the known mean of the population.</paragraph> +<paragraph xml-lang="en-US" id="par_id2954740" role="paragraph"><emph>Sigma</emph> (optional) is the known standard deviation of the population. If omitted, the standard deviation of the given sample is used.</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph xml-lang="en-US" id="par_id2948770" role="paragraph"><item type="input">=Z.TEST(A2:A20; 9; 2)</item> returns the result of a z-test on a sample A2:A20 drawn from a population with known mean 9 and known standard deviation 2.</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectiontechinfo"/> +<embed href="text/scalc/00/avail_release.xhp#4.3"/> +<embed href="text/scalc/01/common_func.xhp#notODFF"/> +<paragraph role="paragraph" id="par_id341640873986700" localize="false"><literal>COM.MICROSOFT.Z.TEST</literal></paragraph> +</section> + <section id="harmean"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3153623"><bookmark_value>HARMEAN function</bookmark_value> + <bookmark_value>means;harmonic</bookmark_value> +</bookmark><comment>mw added one entry</comment> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_HARMITTEL" id="bm_id3154052" localize="false"/> +<h2 id="hd_id3153623">HARMEAN</h2> + <paragraph xml-lang="en-US" id="par_id3155102" role="paragraph"><ahelp hid="HID_FUNC_HARMITTEL">Returns the harmonic mean of a data set.</ahelp></paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph xml-lang="en-US" id="par_id3149287" role="code">HARMEAN(<embedvar href="text/scalc/01/ful_func.xhp#number255_1" markup="keep"/>)</paragraph> + <embed href="text/scalc/01/ful_func.xhp#number255"/> + <embed href="text/scalc/01/common_func.xhp#datenumbersequencenote"/> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph xml-lang="en-US" id="par_id3146093" role="paragraph"> + <item type="input">=HARMEAN(23;46;69)</item> = 37.64. The harmonic mean of this random sample is thus 37.64</paragraph> + </section> + <section id="hypgeomdist"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3152801"><bookmark_value>HYPGEOMDIST function</bookmark_value> + <bookmark_value>sampling without replacement</bookmark_value> +</bookmark><comment>mw added one entry</comment> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_HYPGEOMVERT" id="bm_id3153910" localize="false"/> +<h2 id="hd_id3152801">HYPGEOMDIST</h2> + <paragraph xml-lang="en-US" id="par_id3159341" role="paragraph"><ahelp hid="HID_FUNC_HYPGEOMVERT">Returns the hypergeometric distribution.</ahelp></paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + + <paragraph xml-lang="en-US" id="par_id3155388" role="code">HYPGEOMDIST(X; NSample; Successes; NPopulation [; Cumulative])</paragraph> + <paragraph xml-lang="en-US" id="par_id3154933" role="paragraph"> + <emph>X</emph> is the number of results achieved in the random sample.</paragraph> + <paragraph xml-lang="en-US" id="par_id3153106" role="paragraph"> + <emph>NSample</emph> is the size of the random sample.</paragraph> + <paragraph xml-lang="en-US" id="par_id3146992" role="paragraph"> + <emph>Successes</emph> is the number of possible results in the total population.</paragraph> + <paragraph xml-lang="en-US" id="par_id3148826" role="paragraph"> + <emph>NPopulation </emph>is the size of the total population.</paragraph> + <paragraph xml-lang="en-US" id="par_id231585952506847" role="paragraph"><emph>Cumulative </emph> (optional) specifies whether to calculate the probability mass function (FALSE or 0) or the cumulative distribution function (any other value). The probability mass function is the default if no value is specified for this parameter.</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph xml-lang="en-US" id="par_id3154904" role="paragraph"> + <item type="input">=HYPGEOMDIST(2;2;90;100)</item> yields 0.81. If 90 out of 100 pieces of buttered toast fall from the table and hit the floor with the buttered side first, then if 2 pieces of buttered toast are dropped from the table, the probability is 81%, that both will strike buttered side first.</paragraph> + </section> +<section id="hypgeomdotdist"> + <bookmark xml-lang="en-US" branch="index" id="bm_id2952801"> + <bookmark_value>HYPGEOM.DIST function</bookmark_value> + <bookmark_value>sampling without replacement</bookmark_value> + </bookmark> + <comment>mw added one entry</comment> + <bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_HYP_GEOM_DIST_MS" id="bm_id2953910" localize="false"/> + <h2 id="hd_id2952801">HYPGEOM.DIST</h2> + <paragraph xml-lang="en-US" id="par_id2959341" role="paragraph"><ahelp hid="HID_FUNC_HYP_GEOM_DIST_MS">Returns the hypergeometric distribution.</ahelp></paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph xml-lang="en-US" id="par_id2955388" role="code">HYPGEOM.DIST(X; NSample; Successes; NPopulation; Cumulative)</paragraph> + <paragraph xml-lang="en-US" id="par_id2954933" role="paragraph"><emph>X</emph> is the number of results achieved in the random sample.</paragraph> + <paragraph xml-lang="en-US" id="par_id2953106" role="paragraph"><emph>NSample</emph> is the size of the random sample.</paragraph> + <paragraph xml-lang="en-US" id="par_id2946992" role="paragraph"><emph>Successes</emph> is the number of possible results in the total population.</paragraph> + <paragraph xml-lang="en-US" id="par_id2948826" role="paragraph"><emph>NPopulation </emph>is the size of the total population.</paragraph> + <paragraph xml-lang="en-US" id="par_id2948827" role="paragraph"><emph>Cumulative </emph>: 0 or False calculates the probability density function. Other values or True calculates the cumulative distribution function.</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph xml-lang="en-US" id="par_id2954904" role="paragraph"><item type="input">=HYPGEOM.DIST(2;2;90;100;0)</item> yields 0.8090909091. If 90 out of 100 pieces of buttered toast fall from the table and hit the floor with the buttered side first, then if 2 pieces of buttered toast are dropped from the table, the probability is 81%, that both will strike buttered side first.</paragraph> + <paragraph xml-lang="en-US" id="par_id2954905" role="paragraph"><item type="input">=HYPGEOM.DIST(2;2;90;100;1)</item> yields 1.</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectiontechinfo"/> + <embed href="text/scalc/00/avail_release.xhp#4.2"/> + <embed href="text/scalc/01/common_func.xhp#notODFF"/> + <paragraph role="paragraph" id="par_id341640873986704" localize="false"><literal>COM.MICROSOFT.HYPGEOM.DIST</literal></paragraph> +</section> +</sort> +<section id="relatedtopics"> + <embed href="text/scalc/01/04060100.xhp#drking"/> + </section> + </body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/04060183.xhp b/helpcontent2/source/text/scalc/01/04060183.xhp new file mode 100644 index 000000000..41b9d69ea --- /dev/null +++ b/helpcontent2/source/text/scalc/01/04060183.xhp @@ -0,0 +1,326 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> + +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . + --> + +<meta> +<topic id="textscalc0104060183xml" indexer="include"> +<title id="tit" xml-lang="en-US">Statistical Functions Part Three</title> +<filename>/text/scalc/01/04060183.xhp</filename> +</topic> +</meta> +<body> +<h1 id="hd_id3166425"><variable id="kl"><link href="text/scalc/01/04060183.xhp" name="Statistical Functions Part Three">Statistical Functions Part Three</link> +</variable></h1> +<sort order="asc" descendant="h2"> +<section id="large"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3149530"><bookmark_value>LARGE function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_KGROESSTE" id="bm_id3150883" localize="false"/> +<h2 id="hd_id3149530">LARGE</h2> +<paragraph role="paragraph" id="par_id3150518" xml-lang="en-US"><ahelp hid="HID_FUNC_KGROESSTE">Returns the Rank_c-th largest value in a data set.</ahelp></paragraph> +<embed href="text/scalc/01/ODFF.xhp#odff"/> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph role="code" id="par_id3154372" xml-lang="en-US">LARGE(Data; RankC)</paragraph> +<paragraph role="paragraph" id="par_id3152986" xml-lang="en-US"><emph>Data</emph> is the cell range of data.</paragraph> +<paragraph role="paragraph" id="par_id3156448" xml-lang="en-US"><emph>RankC</emph> is the ranking of the value. If RankC is an array, the function becomes an <link href="text/scalc/01/04060107.xhp" name="array function">array function</link>.</paragraph> +<embed href="text/scalc/01/common_func.xhp#datenumbersequencenote"/> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph role="paragraph" id="par_id3148702" xml-lang="en-US"><input>=LARGE(A1:C50;2)</input> gives the second largest value in A1:C50.</paragraph> +<paragraph role="paragraph" id="par_id3248702" xml-lang="en-US"><input>=LARGE(A1:C50;B1:B5)</input> entered as an array function gives an array of the c-th largest value in A1:C50 with ranks defined in B1:B5.</paragraph> +</section> +<section id="small"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3154532"><bookmark_value>SMALL function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_KKLEINSTE" id="bm_id3148609" localize="false"/> +<h2 id="hd_id3154532">SMALL</h2> +<paragraph role="paragraph" id="par_id3157981" xml-lang="en-US"><ahelp hid="HID_FUNC_KKLEINSTE">Returns the Rank_c-th smallest value in a data set.</ahelp></paragraph> +<embed href="text/scalc/01/ODFF.xhp#odff"/> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph role="code" id="par_id3153974" xml-lang="en-US">SMALL(Data; RankC)</paragraph> +<paragraph role="paragraph" id="par_id3154540" xml-lang="en-US"><emph>Data</emph> is the cell range of data.</paragraph> +<paragraph role="paragraph" id="par_id3155094" xml-lang="en-US"><emph>RankC</emph> is the rank of the value. If RankC is an array, the function becomes an <link href="text/scalc/01/04060107.xhp" name="array function">array function</link>.</paragraph> +<embed href="text/scalc/01/common_func.xhp#datenumbersequencenote"/> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph role="paragraph" id="par_id3149897" xml-lang="en-US"><input>=SMALL(A1:C50;2)</input> gives the second smallest value in A1:C50.</paragraph> +<paragraph role="paragraph" id="par_id3249897" xml-lang="en-US"><input>=SMALL(A1:C50;B1:B5)</input> entered as an array function gives an array of the c-th smallest value in A1:C50 with ranks defined in B1:B5.</paragraph> +</section> +<section id="confidence"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3153559"><bookmark_value>CONFIDENCE function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_KONFIDENZ" id="bm_id3153803" localize="false"/> +<h2 id="hd_id3153559">CONFIDENCE</h2> +<paragraph role="paragraph" id="par_id3153814" xml-lang="en-US"><ahelp hid="HID_FUNC_KONFIDENZ">Returns the (1-alpha) confidence interval for a normal distribution.</ahelp></paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph role="code" id="par_id3147501" xml-lang="en-US">CONFIDENCE(Alpha; StDev; Size)</paragraph> +<paragraph role="paragraph" id="par_id3149872" xml-lang="en-US"> +<emph>Alpha</emph> is the level of the confidence interval.</paragraph> +<paragraph role="paragraph" id="par_id3145324" xml-lang="en-US"> +<emph>StDev</emph> is the standard deviation for the total population.</paragraph> +<paragraph role="paragraph" id="par_id3153075" xml-lang="en-US"> +<emph>Size</emph> is the size of the total population.</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph role="paragraph" id="par_id3153335" xml-lang="en-US"> +<item type="input">=CONFIDENCE(0.05;1.5;100)</item> gives 0.29.</paragraph> +</section> +<section id="confidencedott"> +<bookmark xml-lang="en-US" branch="index" id="bm_id2953559"><bookmark_value>CONFIDENCE.T function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_CONFIDENCE_T" id="bm_id2953803" localize="false"/> +<h2 id="hd_id2953559">CONFIDENCE.T</h2> +<paragraph role="paragraph" id="par_id2953814" xml-lang="en-US"> + <ahelp hid="HID_FUNC_CONFIDENCE_T">Returns the (1-alpha) confidence interval for a Student's t distribution.</ahelp></paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph role="code" id="par_id2947501" xml-lang="en-US">CONFIDENCE.T(Alpha; StDev; Size)</paragraph> +<paragraph role="paragraph" id="par_id2949872" xml-lang="en-US"> +<emph>Alpha</emph> is the level of the confidence interval.</paragraph> +<paragraph role="paragraph" id="par_id2945324" xml-lang="en-US"> +<emph>StDev</emph> is the standard deviation for the total population.</paragraph> +<paragraph role="paragraph" id="par_id2953075" xml-lang="en-US"> +<emph>Size</emph> is the size of the total population.</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph role="paragraph" id="par_id2953335" xml-lang="en-US"> +<item type="input">=CONFIDENCE.T(0.05;1.5;100)</item> gives 0.2976325427.</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectiontechinfo"/> +<embed href="text/scalc/00/avail_release.xhp#4.2"/> +<embed href="text/scalc/01/common_func.xhp#notODFF"/> +<paragraph role="paragraph" id="par_id341640973986703" localize="false"><literal>COM.MICROSOFT.CONFIDENCE.T</literal></paragraph> +</section> +<section id="confidencedotnorm"> +<bookmark xml-lang="en-US" branch="index" id="bm_id2853559"><bookmark_value>CONFIDENCE.NORM function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_CONFIDENCE_N" id="bm_id2853803" localize="false"/> +<h2 id="hd_id2853559">CONFIDENCE.NORM</h2> +<paragraph role="paragraph" id="par_id2853814" xml-lang="en-US"> + <ahelp hid="HID_FUNC_CONFIDENCE_N">Returns the (1-alpha) confidence interval for a normal distribution.</ahelp></paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph role="code" id="par_id2847501" xml-lang="en-US">CONFIDENCE.NORM(Alpha; StDev; Size)</paragraph> +<paragraph role="paragraph" id="par_id2849872" xml-lang="en-US"> +<emph>Alpha</emph> is the level of the confidence interval.</paragraph> +<paragraph role="paragraph" id="par_id2845324" xml-lang="en-US"> +<emph>StDev</emph> is the standard deviation for the total population.</paragraph> +<paragraph role="paragraph" id="par_id2853075" xml-lang="en-US"> +<emph>Size</emph> is the size of the total population.</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph role="paragraph" id="par_id2853335" xml-lang="en-US"> +<item type="input">=CONFIDENCE.NORM(0.05;1.5;100)</item> gives 0.2939945977.</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectiontechinfo"/> +<embed href="text/scalc/00/avail_release.xhp#4.2"/> +<embed href="text/scalc/01/common_func.xhp#notODFF"/> +<paragraph role="paragraph" id="par_id341340873986703" localize="false"><literal>COM.MICROSOFT.CONFIDENCE.NORM</literal></paragraph> +</section> +<section id="correl"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3148746"><bookmark_value>CORREL function</bookmark_value> +<bookmark_value>coefficient of correlation</bookmark_value> +</bookmark><comment>mw added one entry</comment> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_KORREL" id="bm_id3147403" localize="false"/> +<h2 id="hd_id3148746">CORREL</h2> +<paragraph role="paragraph" id="par_id3147299" xml-lang="en-US"><ahelp hid="HID_FUNC_KORREL">Returns the correlation coefficient between two data sets.</ahelp></paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph role="code" id="par_id3153023" xml-lang="en-US">CORREL(Data1; Data2)</paragraph> +<paragraph role="paragraph" id="par_id3150036" xml-lang="en-US"> +<emph>Data1</emph> is the first data set.</paragraph> +<paragraph role="paragraph" id="par_id3153021" xml-lang="en-US"> +<emph>Data2</emph> is the second data set.</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph role="paragraph" id="par_id3149941" xml-lang="en-US"> +<item type="input">=CORREL(A1:A50;B1:B50)</item> calculates the correlation coefficient as a measure of the linear correlation of the two data sets.</paragraph> +</section> +<section id="covar"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3150652"><bookmark_value>COVAR function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_KOVAR" id="bm_id3152983" localize="false"/> +<h2 id="hd_id3150652">COVAR</h2> +<paragraph role="paragraph" id="par_id3146875" xml-lang="en-US"><ahelp hid="HID_FUNC_KOVAR">Returns the covariance of the product of paired deviations.</ahelp></paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph role="code" id="par_id3150740" xml-lang="en-US">COVAR(Data1; Data2)</paragraph> +<paragraph role="paragraph" id="par_id3145827" xml-lang="en-US"> +<emph>Data1</emph> is the first data set.</paragraph> +<paragraph role="paragraph" id="par_id3150465" xml-lang="en-US"> +<emph>Data2</emph> is the second data set.</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph role="paragraph" id="par_id3144748" xml-lang="en-US"> +<item type="input">=COVAR(A1:A30;B1:B30)</item> +</paragraph> +</section> +<section id="covariancedotp"> + <bookmark xml-lang="en-US" branch="index" id="bm_id2950652"> + <bookmark_value>COVARIANCE.P function</bookmark_value> + </bookmark> + <bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_COVARIANCE_P" id="bm_id2952983" localize="false"/> + <h2 id="hd_id2950652">COVARIANCE.P</h2> + <paragraph role="paragraph" id="par_id2946875" xml-lang="en-US"><ahelp hid="HID_FUNC_COVARIANCE_P">Returns the covariance of the product of paired deviations, for the entire population.</ahelp></paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph role="code" id="par_id2950740" xml-lang="en-US">COVARIANCE.P(Data1; Data2)</paragraph> + <paragraph role="paragraph" id="par_id2945827" xml-lang="en-US"><emph>Data1</emph> is the first data set.</paragraph> + <paragraph role="paragraph" id="par_id2950465" xml-lang="en-US"><emph>Data2</emph> is the second data set.</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph role="paragraph" id="par_id2944748" xml-lang="en-US"><item type="input">=COVARIANCE.P(A1:A30;B1:B30)</item></paragraph> + <embed href="text/scalc/01/common_func.xhp#sectiontechinfo"/> + <embed href="text/scalc/00/avail_release.xhp#4.2"/> + <embed href="text/scalc/01/common_func.xhp#notODFF"/> + <paragraph role="paragraph" id="par_id641640873986703" localize="false"><literal>COM.MICROSOFT.COVARIANCE.P</literal></paragraph> +</section> +<section id="covariancedots"> + <bookmark xml-lang="en-US" branch="index" id="bm_id280652"> + <bookmark_value>COVARIANCE.S function</bookmark_value> + </bookmark> + <bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_COVARIANCE_S" id="bm_id2852983" localize="false"/> + <h2 id="hd_id2850652">COVARIANCE.S</h2> + <paragraph role="paragraph" id="par_id2846875" xml-lang="en-US"><ahelp hid="HID_FUNC_COVARIANCE_S">Returns the covariance of the product of paired deviations, for a sample of the population.</ahelp></paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph role="code" id="par_id2850740" xml-lang="en-US">COVARIANCE.S(Data1; Data2)</paragraph> + <paragraph role="paragraph" id="par_id2845827" xml-lang="en-US"><emph>Data1</emph> is the first data set.</paragraph> + <paragraph role="paragraph" id="par_id2850465" xml-lang="en-US"><emph>Data2</emph> is the second data set.</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph role="paragraph" id="par_id2844748" xml-lang="en-US"><item type="input">=COVARIANCE.S(A1:A30;B1:B30)</item></paragraph> + <embed href="text/scalc/01/common_func.xhp#sectiontechinfo"/> + <embed href="text/scalc/00/avail_release.xhp#4.2"/> + <embed href="text/scalc/01/common_func.xhp#notODFF"/> + <paragraph role="paragraph" id="par_id341670873986703" localize="false"><literal>COM.MICROSOFT.COVARIANCE.S</literal></paragraph> +</section> +<section id="critbinom"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3147472"><bookmark_value>CRITBINOM function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_KRITBINOM" id="bm_id3154848" localize="false"/> +<h2 id="hd_id3147472">CRITBINOM</h2> +<paragraph role="paragraph" id="par_id3149254" xml-lang="en-US"><ahelp hid="HID_FUNC_KRITBINOM">Returns the smallest value for which the cumulative binomial distribution is greater than or equal to a criterion value.</ahelp></paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph role="code" id="par_id3148586" xml-lang="en-US">CRITBINOM(Trials; SP; Alpha)</paragraph> +<paragraph role="paragraph" id="par_id3145593" xml-lang="en-US"> +<emph>Trials</emph> is the total number of trials.</paragraph> +<paragraph role="paragraph" id="par_id3153084" xml-lang="en-US"> +<emph>SP</emph> is the probability of success for one trial.</paragraph> +<paragraph role="paragraph" id="par_id3149726" xml-lang="en-US"> +<emph>Alpha</emph> is the threshold probability to be reached or exceeded.</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph role="paragraph" id="par_id3148740" xml-lang="en-US"> +<item type="input">=CRITBINOM(100;0.5;0.1)</item> yields 44.</paragraph> +</section> +<section id="kurt"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3155956"><bookmark_value>KURT function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_KURT" id="bm_id3146847" localize="false"/> +<h2 id="hd_id3155956">KURT</h2> +<paragraph role="paragraph" id="par_id3153108" xml-lang="en-US"><ahelp hid="HID_FUNC_KURT">Returns the kurtosis of a data set (at least 4 values required).</ahelp></paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph role="code" id="par_id3154508" xml-lang="en-US">KURT(<embedvar href="text/scalc/01/ful_func.xhp#number255_1" markup="keep"/>)</paragraph> +<embed href="text/scalc/01/ful_func.xhp#number255"/> +<paragraph id="par_id501585152669900" role="paragraph" xml-lang="en-US">The parameters should specify at least four values.</paragraph> +<embed href="text/scalc/01/common_func.xhp#datenumbersequencenote"/> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph role="paragraph" id="par_id3150016" xml-lang="en-US"> +<item type="input">=KURT(A1;A2;A3;A4;A5;A6)</item> +</paragraph> +</section> +<section id="loginv"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3150928"><bookmark_value>LOGINV function</bookmark_value> +<bookmark_value>inverse of lognormal distribution</bookmark_value> +</bookmark><comment>mw added one entry</comment> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_LOGINV" id="bm_id3156062" localize="false"/> +<h2 id="hd_id3150928">LOGINV</h2> +<paragraph role="paragraph" id="par_id3145297" xml-lang="en-US"><ahelp hid="HID_FUNC_LOGINV">Returns the inverse of the lognormal distribution.</ahelp></paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph role="code" id="par_id3153049" xml-lang="en-US">LOGINV(Number [; Mean [; StDev]])</paragraph> +<paragraph role="paragraph" id="par_id3148390" xml-lang="en-US"> +<emph>Number</emph> (required) is the probability value for which the inverse standard logarithmic distribution is to be calculated.</paragraph> +<paragraph role="paragraph" id="par_id3149538" xml-lang="en-US"> +<emph>Mean</emph> (optional) is the arithmetic mean of the standard logarithmic distribution (defaults to 0 if omitted).</paragraph> +<paragraph role="paragraph" id="par_id3145355" xml-lang="en-US"> +<emph>StDev</emph> (optional) is the standard deviation of the standard logarithmic distribution (defaults to 1 if omitted).</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph role="paragraph" id="par_id3155623" xml-lang="en-US"> +<item type="input">=LOGINV(0.05;0;1)</item> returns 0.1930408167.</paragraph> +</section> +<section id="lognormdotinv"> +<bookmark xml-lang="en-US" branch="index" id="bm_id2901928"><bookmark_value>LOGNORM.INV function</bookmark_value> +<bookmark_value>inverse of lognormal distribution</bookmark_value> +</bookmark><comment>mw added one entry</comment> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_LOGINV_MS" id="bm_id2901062" localize="false"/> +<h2 id="hd_id2901928">LOGNORM.INV</h2> +<paragraph role="paragraph" id="par_id2901297" xml-lang="en-US"><ahelp hid="HID_FUNC_LOGINV_MS">Returns the inverse of the lognormal distribution.</ahelp></paragraph> +<paragraph id="par_id290122405814" role="paragraph" xml-lang="en-US">This function is identical to LOGINV and was introduced for interoperability with other office suites.</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph role="code" id="par_id2901049" xml-lang="en-US">LOGNORM.INV(Number ; Mean ; StDev)</paragraph> +<paragraph role="paragraph" id="par_id2901390" xml-lang="en-US"> +<emph>Number</emph> (required) is the probability value for which the inverse standard logarithmic distribution is to be calculated.</paragraph> +<paragraph role="paragraph" id="par_id2901538" xml-lang="en-US"> +<emph>Mean</emph> (required) is the arithmetic mean of the standard logarithmic distribution.</paragraph> +<paragraph role="paragraph" id="par_id2901355" xml-lang="en-US"> +<emph>StDev</emph> (required) is the standard deviation of the standard logarithmic distribution.</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph role="paragraph" id="par_id2901623" xml-lang="en-US"> +<item type="input">=LOGNORM.INV(0.05;0;1)</item> returns 0.1930408167.</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectiontechinfo"/> +<embed href="text/scalc/00/avail_release.xhp#4.3"/> +<embed href="text/scalc/01/common_func.xhp#notODFF"/> +<paragraph role="paragraph" id="par_id341640873906703" localize="false"><literal>COM.MICROSOFT.LOGNORM.INV</literal></paragraph> +</section> +<section id="lognormdist"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3158417"><bookmark_value>LOGNORMDIST function</bookmark_value> +<bookmark_value>lognormal distribution</bookmark_value> +</bookmark><comment>mw added one entry</comment> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_LOGNORMVERT" id="bm_id3155366" localize="false"/> +<h2 id="hd_id3158417">LOGNORMDIST</h2> +<paragraph role="paragraph" id="par_id3154953" xml-lang="en-US"><ahelp hid="HID_FUNC_LOGNORMVERT">Returns the values of a lognormal distribution.</ahelp></paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph role="code" id="par_id3150686" xml-lang="en-US">LOGNORMDIST(Number [; Mean [; StDev [; Cumulative]]])</paragraph> +<paragraph role="paragraph" id="par_id3154871" xml-lang="en-US"> +<emph>Number</emph> is the probability value for which the standard logarithmic distribution is to be calculated.</paragraph> +<paragraph role="paragraph" id="par_id3155820" xml-lang="en-US"> +<emph>Mean</emph> (optional) is the mean value of the standard logarithmic distribution.</paragraph> +<paragraph role="paragraph" id="par_id3155991" xml-lang="en-US"> +<emph>StDev</emph> (optional) is the standard deviation of the standard logarithmic distribution.</paragraph> +<paragraph role="paragraph" id="par_id3155992" xml-lang="en-US"> +<emph>Cumulative</emph> (optional) = 0 calculates the density function, Cumulative = 1 calculates the distribution.</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph role="paragraph" id="par_id3149778" xml-lang="en-US"> +<item type="input">=LOGNORMDIST(0.1;0;1)</item> returns 0.01.</paragraph> +</section> +<section id="lognormdotdist"> +<bookmark xml-lang="en-US" branch="index" id="bm_id2901417"><bookmark_value>LOGNORM.DIST function</bookmark_value> +<bookmark_value>lognormal distribution</bookmark_value> +</bookmark><comment>mw added one entry</comment> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_LOGNORMDIST_MS" id="bm_id2901366" localize="false"/> +<h2 id="hd_id2908417">LOGNORM.DIST</h2> +<paragraph role="paragraph" id="par_id2904953" xml-lang="en-US"><ahelp hid="HID_FUNC_LOGNORMDIST_MS">Returns the values of a lognormal distribution.</ahelp></paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph role="code" id="par_id2900686" xml-lang="en-US">LOGNORM.DIST(Number; Mean; StDev; Cumulative)</paragraph> +<paragraph role="paragraph" id="par_id2904871" xml-lang="en-US"> +<emph>Number</emph> (required) is the probability value for which the standard logarithmic distribution is to be calculated.</paragraph> +<paragraph role="paragraph" id="par_id2905820" xml-lang="en-US"> +<emph>Mean</emph> (required) is the mean value of the standard logarithmic distribution.</paragraph> +<paragraph role="paragraph" id="par_id2905991" xml-lang="en-US"> +<emph>StDev</emph> (required) is the standard deviation of the standard logarithmic distribution.</paragraph> +<paragraph role="paragraph" id="par_id2905992" xml-lang="en-US"> +<emph>Cumulative</emph> (required) = 0 calculates the density function, Cumulative = 1 calculates the distribution.</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph role="paragraph" id="par_id2909778" xml-lang="en-US"> +<item type="input">=LOGNORM.DIST(0.1;0;1;1)</item> returns 0.0106510993.</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectiontechinfo"/> +<embed href="text/scalc/00/avail_release.xhp#4.3"/> +<embed href="text/scalc/01/common_func.xhp#notODFF"/> +<paragraph role="paragraph" id="par_id341670873986703" localize="false"><literal>COM.MICROSOFT.LOGNORM.DIST</literal></paragraph> +</section> +</sort> +<section id="relatedtopics"> +<embed href="text/scalc/01/04060100.xhp#drking"/> +</section> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/04060184.xhp b/helpcontent2/source/text/scalc/01/04060184.xhp new file mode 100644 index 000000000..c3fb40e19 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/04060184.xhp @@ -0,0 +1,561 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> + +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . + --> +<meta> +<topic id="textscalc0104060184xml" indexer="include"> +<title xml-lang="en-US" id="tit">Statistical Functions Part Four</title> +<filename>/text/scalc/01/04060184.xhp</filename> +</topic> +</meta> +<body> +<h1 id="hd_id3153415"><variable id="mq"><link href="text/scalc/01/04060184.xhp" name="Statistical Functions Part Four">Statistical Functions Part Four</link> +</variable></h1> +<sort order="asc" descendant="h2"> +<section id="max"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3154511"><bookmark_value>MAX function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_MAX" id="bm_id3146972" localize="false"/> +<h2 id="hd_id3154511"><variable id="max_head"><link href="text/scalc/01/04060184.xhp#max">MAX</link></variable></h2> +<paragraph xml-lang="en-US" id="par_id3153709" role="paragraph"><ahelp hid="HID_FUNC_MAX">Returns the maximum value in a list of arguments.</ahelp></paragraph> +<paragraph xml-lang="en-US" id="par_id9282509" role="paragraph">Returns 0 if no numeric value and no error was encountered in the cell range(s) passed as cell reference(s). Text cells are ignored by MIN() and MAX(). The functions MINA() and MAXA() return 0 if no value (numeric or text) and no error was encountered. Passing a literal string argument to MIN() or MAX(), e.g. MIN("string"), still results in an error.</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph xml-lang="en-US" id="par_id3147340" role="code">MAX(<embedvar href="text/scalc/01/ful_func.xhp#number255_1" markup="keep"/>)</paragraph> +<embed href="text/scalc/01/ful_func.xhp#number255"/> +<embed href="text/scalc/01/common_func.xhp#datenumbersequencenote"/> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph xml-lang="en-US" id="par_id3147343" role="paragraph"> +<item type="input">=MAX(A1;A2;A3;50;100;200)</item> returns the largest value from the list.</paragraph> +<paragraph xml-lang="en-US" id="par_id3148485" role="paragraph"> +<item type="input">=MAX(A1:B100)</item> returns the largest value from the list.</paragraph> +</section> +<section id="maxa"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3166426"><bookmark_value>MAXA function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_MAXA" id="bm_id3150304" localize="false"/> +<h2 id="hd_id3166426"><variable id="maxa_head"><link href="text/scalc/01/04060184.xhp#maxa">MAXA</link></variable></h2> +<paragraph xml-lang="en-US" id="par_id3150363" role="paragraph"><ahelp hid="HID_FUNC_MAXA">Returns the maximum value in a list of arguments. In opposite to MAX, here you can enter text. The value of the text is 0.</ahelp></paragraph> +<paragraph xml-lang="en-US" id="par_id7689443" role="paragraph">The functions MINA() and MAXA() return 0 if no value (numeric or text) and no error was encountered.</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph xml-lang="en-US" id="par_id3166431" role="code">MAXA(<embedvar href="text/scalc/01/ful_func.xhp#number255_1" markup="keep"/>)</paragraph> +<embed href="text/scalc/01/ful_func.xhp#number255"/> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph xml-lang="en-US" id="par_id3156446" role="paragraph"> +<item type="input">=MAXA(A1;A2;A3;50;100;200;"Text")</item> returns the largest value from the list.</paragraph> +<paragraph xml-lang="en-US" id="par_id3149404" role="paragraph"> +<item type="input">=MAXA(A1:B100)</item> returns the largest value from the list.</paragraph> +</section> +<section id="median"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3153820"><bookmark_value>MEDIAN function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_MEDIAN" id="bm_id3153069" localize="false"/> +<h2 id="hd_id3153820"><variable id="median_head"><link href="text/scalc/01/04060184.xhp#median">MEDIAN</link></variable></h2> +<paragraph xml-lang="en-US" id="par_id3151241" role="paragraph"><ahelp hid="HID_FUNC_MEDIAN">Returns the median of a set of numbers. In a set containing an uneven number of values, the median will be the number in the middle of the set and in a set containing an even number of values, it will be the mean of the two values in the middle of the set.</ahelp></paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph xml-lang="en-US" id="par_id3155264" role="code">MEDIAN(<embedvar href="text/scalc/01/ful_func.xhp#number255_1" markup="keep"/>)</paragraph> +<embed href="text/scalc/01/ful_func.xhp#number255"/> +<embed href="text/scalc/01/common_func.xhp#datenumbersequencenote"/> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph xml-lang="en-US" id="par_id3145078" role="paragraph">for an odd number: <item type="input">=MEDIAN(1;5;9;20;21)</item> returns 9 as the median value.</paragraph> +<paragraph xml-lang="en-US" id="par_id3149126" role="paragraph">for an even number: <item type="input">=MEDIAN(1;5;9;20)</item> returns the average of the two middle values 5 and 9, thus 7.</paragraph> +</section> +<section id="min"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3154541"><bookmark_value>MIN function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_MIN" id="bm_id3159226" localize="false"/> +<h2 id="hd_id3154541"><variable id="min_head"><link href="text/scalc/01/04060184.xhp#min">MIN</link></variable></h2> +<paragraph xml-lang="en-US" id="par_id3143222" role="paragraph"><ahelp hid="HID_FUNC_MIN">Returns the minimum value in a list of arguments.</ahelp></paragraph> +<paragraph xml-lang="en-US" id="par_id2301400" role="paragraph">Returns 0 if no numeric value and no error was encountered in the cell range(s) passed as cell reference(s). Text cells are ignored by MIN() and MAX(). The functions MINA() and MAXA() return 0 if no value (numeric or text) and no error was encountered. Passing a literal string argument to MIN() or MAX(), e.g. MIN("string"), still results in an error.</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph xml-lang="en-US" id="par_id3146964" role="code">MIN(<embedvar href="text/scalc/01/ful_func.xhp#number255_1" markup="keep"/>)</paragraph> +<embed href="text/scalc/01/ful_func.xhp#number255"/> +<embed href="text/scalc/01/common_func.xhp#datenumbersequencenote"/> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph xml-lang="en-US" id="par_id3154734" role="paragraph"> +<item type="input">=MIN(A1:B100)</item> returns the smallest value in the list.</paragraph> +</section> +<section id="mina"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3147504"><bookmark_value>MINA function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_MINA" id="bm_id3155752" localize="false"/> +<h2 id="hd_id3147504"><variable id="mina_head"><link href="text/scalc/01/04060184.xhp#mina">MINA</link></variable></h2> +<paragraph xml-lang="en-US" id="par_id3147249" role="paragraph"><ahelp hid="HID_FUNC_MINA">Returns the minimum value in a list of arguments. Here you can also enter text. The value of the text is 0.</ahelp></paragraph> +<paragraph xml-lang="en-US" id="par_id4294564" role="paragraph">The functions MINA() and MAXA() return 0 if no value (numeric or text) and no error was encountered.</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph xml-lang="en-US" id="par_id3153336" role="code">MINA(<embedvar href="text/scalc/01/ful_func.xhp#number255_1" markup="keep"/>)</paragraph> +<embed href="text/scalc/01/ful_func.xhp#number255"/> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph xml-lang="en-US" id="par_id3147401" role="paragraph"> +<item type="input">=MINA(1;"Text";20)</item> returns 0.</paragraph> +<paragraph xml-lang="en-US" id="par_id3147295" role="paragraph"> +<item type="input">=MINA(A1:B100)</item> returns the smallest value in the list.</paragraph> +</section> +<section id="avedev"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3166465"><bookmark_value>AVEDEV function</bookmark_value> +<bookmark_value>averages;statistical functions</bookmark_value> +</bookmark><comment>mw added "averages;"</comment> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_MITTELABW" id="bm_id3156396" localize="false"/> +<h2 id="hd_id3166465"><variable id="avedev_head"><link href="text/scalc/01/04060184.xhp#avedev">AVEDEV</link></variable></h2> +<paragraph role="paragraph" id="par_id3150373" xml-lang="en-US"><ahelp hid="HID_FUNC_MITTELABW">Returns the average of the absolute deviations of data points from their mean.</ahelp> Displays the diffusion in a data set.</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph role="code" id="par_id3145636" xml-lang="en-US">AVEDEV(<embedvar href="text/scalc/01/ful_func.xhp#number255_1" markup="keep"/>)</paragraph> +<embed href="text/scalc/01/ful_func.xhp#number255"/> +<embed href="text/scalc/01/common_func.xhp#datenumbersequencenote"/> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph role="paragraph" id="par_id3153122" xml-lang="en-US"><item type="input">=AVEDEV(A1:A50)</item> </paragraph> +</section> +<section id="average"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3145824"><bookmark_value>AVERAGE function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_MITTELWERT" id="bm_id3146878" localize="false"/> +<h2 id="hd_id3145824"><variable id="average_head"><link href="text/scalc/01/04060184.xhp#average">AVERAGE</link></variable></h2> +<paragraph xml-lang="en-US" id="par_id3150482" role="paragraph"><ahelp hid="HID_FUNC_MITTELWERT">Returns the average of the arguments.</ahelp></paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph xml-lang="en-US" id="par_id3154679" role="code">AVERAGE(<embedvar href="text/scalc/01/ful_func.xhp#number255_1" markup="keep"/>)</paragraph> +<embed href="text/scalc/01/ful_func.xhp#number255"/> +<embed href="text/scalc/01/common_func.xhp#datenumbersequencenote"/> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph xml-lang="en-US" id="par_id3151232" role="paragraph"> +<item type="input">=AVERAGE(A1:A50)</item> +</paragraph> +</section> +<section id="averagea"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3148754"><bookmark_value>AVERAGEA function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_MITTELWERTA" id="bm_id3149690" localize="false"/> +<h2 id="hd_id3148754"><variable id="averagea_head"><link href="text/scalc/01/04060184.xhp#averagea">AVERAGEA</link></variable></h2> +<paragraph xml-lang="en-US" id="par_id3145138" role="paragraph"><ahelp hid="HID_FUNC_MITTELWERTA">Returns the average of the arguments. The value of a text is 0.</ahelp></paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph xml-lang="en-US" id="par_id3149734" role="code">AVERAGEA(<embedvar href="text/scalc/01/ful_func.xhp#number255_1" markup="keep"/>)</paragraph> +<embed href="text/scalc/01/ful_func.xhp#number255"/> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph xml-lang="en-US" id="par_id3150864" role="paragraph"> +<item type="input">=AVERAGEA(A1:A50)</item> +</paragraph> +</section> +<section id="averageif"> +<h2 id="hd_id110421803716508"><embedvar href="text/scalc/01/func_averageif.xhp#averageif_head"/></h2> +<paragraph id="par_id71462400513325" role="paragraph" localize="false" xml-lang="en-US"><embedvar href="text/scalc/01/func_averageif.xhp#averageif_des"/></paragraph> +</section> +<section id="averageifs"> +<h2 id="hd_id5471656631510"><embedvar href="text/scalc/01/func_averageifs.xhp#averageifs_head"/></h2> +<paragraph id="par_id5259182024777" role="paragraph" localize="false" xml-lang="en-US"><embedvar href="text/scalc/01/func_averageifs.xhp#averageifs_des"/></paragraph> +</section> +<section id="mode"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3153933"><bookmark_value>MODE function</bookmark_value> +<bookmark_value>most common value</bookmark_value> +</bookmark><comment>mw added one entry</comment> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_MODALWERT" id="bm_id3149253" localize="false"/> +<h2 id="hd_id3153933">MODE</h2> +<paragraph xml-lang="en-US" id="par_id3153085" role="paragraph"><ahelp hid="HID_FUNC_MODALWERT">Returns the most common value in a data set.</ahelp> If there are several values with the same frequency, it returns the smallest value. An error occurs when a value doesn't appear twice.</paragraph> +<embed href="text/scalc/01/ODFF.xhp#odff"/> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph xml-lang="en-US" id="par_id3155950" role="code">MODE(<embedvar href="text/scalc/01/ful_func.xhp#number255_1" markup="keep"/>)</paragraph> +<embed href="text/scalc/01/ful_func.xhp#number255"/> +<embed href="text/scalc/01/common_func.xhp#datenumbersequencenote"/> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph xml-lang="en-US" id="par_id3153733" role="paragraph"> +<item type="input">=MODE(A1:A50)</item> +</paragraph> +</section> + +<section id="modedotsngl"> +<bookmark xml-lang="en-US" branch="index" id="bm_id2953933"><bookmark_value>MODE.SNGL function</bookmark_value> +<bookmark_value>most common value</bookmark_value> +</bookmark><comment>mw added one entry</comment> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_MODAL_VALUE_MS" id="bm_id2949253" localize="false"/> +<h2 id="hd_id2953933">MODE.SNGL</h2> +<paragraph xml-lang="en-US" id="par_id2953085" role="paragraph"><ahelp hid="HID_FUNC_MODAL_VALUE_MS">Returns the most frequently occurring, or repetitive, value in an array or range of data.</ahelp> If there are several values with the same frequency, it returns the smallest value. An error occurs when a value doesn't appear twice.</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph xml-lang="en-US" id="par_id2955950" role="code">MODE.SNGL(<embedvar href="text/scalc/01/ful_func.xhp#number255_1" markup="keep"/>)</paragraph> +<embed href="text/scalc/01/ful_func.xhp#number255"/> +<warning id="par_id2963792">If the data set contains no duplicate data points, MODE.SNGL returns the #VALUE! error value.</warning> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph xml-lang="en-US" id="par_id2953733" role="paragraph"><item type="input">=MODE.SNGL(A1:A50)</item></paragraph> +<embed href="text/scalc/01/common_func.xhp#sectiontechinfo"/> +<embed href="text/scalc/00/avail_release.xhp#4.3"/> +<embed href="text/scalc/01/common_func.xhp#notODFF"/> +<paragraph role="paragraph" id="par_id341540873986703" localize="false"><literal>COM.MICROSOFT.MODE.SNGL</literal></paragraph> +</section> +<section id="modedotmult"> +<bookmark xml-lang="en-US" branch="index" id="bm_id2853933"><bookmark_value>MODE.MULT function</bookmark_value> +<bookmark_value>most common value</bookmark_value> +</bookmark><comment>mw added one entry</comment> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_MODAL_VALUE_MULTI" id="bm_id2849253" localize="false"/> +<h2 id="hd_id2853933">MODE.MULT</h2> +<paragraph xml-lang="en-US" id="par_id2853085" role="paragraph"><ahelp hid="HID_FUNC_MODAL_VALUE_MULTI">Returns a vertical array of the statistical modes (the most frequently occurring values) within a list of supplied numbers.</ahelp></paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph xml-lang="en-US" id="par_id2855950" role="code">MODE.MULT(<embedvar href="text/scalc/01/ful_func.xhp#number255_1" markup="keep"/>)</paragraph> +<embed href="text/scalc/01/ful_func.xhp#number255"/> +<warning id="par_id2863792">As the MODE.MULT function returns an array of values, it must be entered as an array formula. If the function is not entered as an array formula, only the first mode is returned, which is the same as using the MODE.SNGL function.</warning> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph xml-lang="en-US" id="par_id2853733" role="paragraph"><item type="input">=MODE.MULT(A1:A50)</item></paragraph> +<embed href="text/scalc/01/common_func.xhp#sectiontechinfo"/> +<embed href="text/scalc/00/avail_release.xhp#4.3"/> +<embed href="text/scalc/01/common_func.xhp#notODFF"/> +<paragraph role="paragraph" id="par_id341640875986703" localize="false"><literal>COM.MICROSOFT.MODE.MULT</literal></paragraph> +</section> +<section id="negbinomdist"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3149879"><bookmark_value>NEGBINOMDIST function</bookmark_value> +<bookmark_value>negative binomial distribution</bookmark_value> +</bookmark><comment>mw added one entry</comment> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_NEGBINOMVERT" id="bm_id3159135" localize="false"/> +<h2 id="hd_id3149879">NEGBINOMDIST</h2> +<paragraph xml-lang="en-US" id="par_id3155437" role="paragraph"><ahelp hid="HID_FUNC_NEGBINOMVERT">Returns the negative binomial distribution.</ahelp></paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph xml-lang="en-US" id="par_id3150935" role="code">NEGBINOMDIST(X; R; SP)</paragraph> +<paragraph xml-lang="en-US" id="par_id3153044" role="paragraph"><emph>X</emph> represents the value returned for unsuccessful tests.</paragraph> +<paragraph xml-lang="en-US" id="par_id3151018" role="paragraph"><emph>R</emph> represents the value returned for successful tests.</paragraph> +<paragraph xml-lang="en-US" id="par_id3148878" role="paragraph"><emph>SP</emph> is the probability of the success of an attempt.</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph xml-lang="en-US" id="par_id3148770" role="paragraph"> +<item type="input">=NEGBINOMDIST(1;1;0.5)</item> returns 0.25.</paragraph> +</section> +<section id="negbinomdotdist"> +<bookmark xml-lang="en-US" branch="index" id="bm_id2949879"><bookmark_value>NEGBINOM.DIST function</bookmark_value> +<bookmark_value>negative binomial distribution</bookmark_value> +</bookmark><comment>mw added one entry</comment> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_NEGBINOMDIST_MS" id="bm_id2959135" localize="false"/> +<h2 id="hd_id2949879">NEGBINOM.DIST</h2> +<paragraph xml-lang="en-US" id="par_id2955437" role="paragraph"><ahelp hid="HID_FUNC_NEGBINOMDIST_MS">Returns the negative binomial density or distribution function.</ahelp></paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph xml-lang="en-US" id="par_id2950935" role="code">NEGBINOM.DIST(X; R; SP; Cumulative)</paragraph> +<paragraph xml-lang="en-US" id="par_id2953044" role="paragraph"><emph>X</emph> represents the value returned for unsuccessful tests.</paragraph> +<paragraph xml-lang="en-US" id="par_id2951018" role="paragraph"><emph>R</emph> represents the value returned for successful tests.</paragraph> +<paragraph xml-lang="en-US" id="par_id2948878" role="paragraph"><emph>SP</emph> is the probability of the success of an attempt.</paragraph> +<paragraph xml-lang="en-US" id="par_id2948879" role="paragraph"><emph>Cumulative</emph> = 0 calculates the density function, <emph>Cumulative</emph> = 1 calculates the distribution.</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph xml-lang="en-US" id="par_id2948770" role="paragraph"><item type="input">=NEGBINOM.DIST(1;1;0.5;0)</item> returns 0.25.</paragraph> +<paragraph xml-lang="en-US" id="par_id2948771" role="paragraph"><item type="input">=NEGBINOM.DIST(1;1;0.5;1)</item> returns 0.75.</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectiontechinfo"/> +<embed href="text/scalc/00/avail_release.xhp#4.3"/> +<embed href="text/scalc/01/common_func.xhp#notODFF"/> +<paragraph role="paragraph" id="par_id341640873985703" localize="false"><literal>COM.MICROSOFT.NEGBINOM.DIST</literal></paragraph> +</section> +<section id="norminv"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3155516"><bookmark_value>NORMINV function</bookmark_value> +<bookmark_value>normal distribution;inverse of</bookmark_value> +</bookmark><comment>mw added one entry</comment> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_NORMINV" id="bm_id3149396" localize="false"/> +<h2 id="hd_id3155516">NORMINV</h2> +<paragraph xml-lang="en-US" id="par_id3154634" role="paragraph"><ahelp hid="HID_FUNC_NORMINV">Returns the inverse of the normal cumulative distribution.</ahelp></paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph xml-lang="en-US" id="par_id3147534" role="code">NORMINV(Number; Mean; StDev)</paragraph> +<paragraph xml-lang="en-US" id="par_id3154950" role="paragraph"><emph>Number</emph> represents the probability value used to determine the inverse normal distribution.</paragraph> +<paragraph xml-lang="en-US" id="par_id3150690" role="paragraph"><emph>Mean</emph> represents the mean value in the normal distribution.</paragraph> +<paragraph xml-lang="en-US" id="par_id3148594" role="paragraph"><emph>StDev</emph> represents the standard deviation of the normal distribution.</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph xml-lang="en-US" id="par_id3153921" role="paragraph"> +<item type="input">=NORMINV(0.9;63;5)</item> returns 69.41. If the average egg weighs 63 grams with a standard deviation of 5, then there will be 90% probability that the egg will not be heavier than 69.41g grams.</paragraph> +</section> +<section id="normdotinv"> +<bookmark xml-lang="en-US" branch="index" id="bm_id2955516"><bookmark_value>NORM.INV function</bookmark_value> +<bookmark_value>normal distribution;inverse of</bookmark_value> +</bookmark><comment>mw added one entry</comment> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_NORMINV_MS" id="bm_id2949396" localize="false"/> +<h2 id="hd_id2955516">NORM.INV</h2> +<paragraph xml-lang="en-US" id="par_id2954634" role="paragraph"><ahelp hid="HID_FUNC_NORMINV_MS">Returns the inverse of the normal cumulative distribution.</ahelp></paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph xml-lang="en-US" id="par_id2947534" role="code">NORM.INV(Number; Mean; StDev)</paragraph> +<paragraph xml-lang="en-US" id="par_id2954950" role="paragraph"><emph>Number</emph> represents the probability value used to determine the inverse normal distribution.</paragraph> +<paragraph xml-lang="en-US" id="par_id2950690" role="paragraph"><emph>Mean</emph> represents the mean value in the normal distribution.</paragraph> +<paragraph xml-lang="en-US" id="par_id2948594" role="paragraph"><emph>StDev</emph> represents the standard deviation of the normal distribution.</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph xml-lang="en-US" id="par_id2953921" role="paragraph"> +<item type="input">=NORM.INV(0.9;63;5)</item> returns 69.4077578277. If the average egg weighs 63 grams with a standard deviation of 5, then there will be 90% probability that the egg will not be heavier than 69.41g grams.</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectiontechinfo"/> +<embed href="text/scalc/00/avail_release.xhp#4.3"/> +<embed href="text/scalc/01/common_func.xhp#notODFF"/> +<paragraph role="paragraph" id="par_id341640873966703" localize="false"><literal>COM.MICROSOFT.NORM.INV</literal></paragraph> +</section> +<section id="normdist"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3153722"><bookmark_value>NORMDIST function</bookmark_value> +<bookmark_value>density function</bookmark_value> +</bookmark><comment>mw added one entry</comment> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_NORMVERT" id="bm_id3147484" localize="false"/> +<h2 id="hd_id3153722">NORMDIST</h2> +<paragraph xml-lang="en-US" id="par_id3150386" role="paragraph"><ahelp hid="HID_FUNC_NORMVERT">Returns the density function or the normal cumulative distribution.</ahelp></paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph xml-lang="en-US" id="par_id3150613" role="code">NORMDIST(Number; Mean; StDev [; C])</paragraph> +<paragraph xml-lang="en-US" id="par_id3149820" role="paragraph"><emph>Number</emph> is the value of the distribution based on which the normal distribution is to be calculated.</paragraph> +<paragraph xml-lang="en-US" id="par_id3146063" role="paragraph"><emph>Mean</emph> is the mean value of the distribution.</paragraph> +<paragraph xml-lang="en-US" id="par_id3156295" role="paragraph"><emph>StDev</emph> is the standard deviation of the distribution.</paragraph> +<paragraph xml-lang="en-US" id="par_id3145080" role="paragraph"><emph>C</emph> is optional. <emph>C</emph> = 0 calculates the density function, <emph>C</emph> = 1 calculates the distribution.</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph xml-lang="en-US" id="par_id3149283" role="paragraph"> +<item type="input">=NORMDIST(70;63;5;0)</item> returns 0.03.</paragraph> +<paragraph xml-lang="en-US" id="par_id3149448" role="paragraph"> +<item type="input">=NORMDIST(70;63;5;1)</item> returns 0.92.</paragraph> +</section> +<section id="normdotdist"> +<bookmark xml-lang="en-US" branch="index" id="bm_id2913722"><bookmark_value>NORM.DIST function</bookmark_value> +<bookmark_value>density function</bookmark_value> +</bookmark><comment>mw added one entry</comment> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_NORMDIST_MS" id="bm_id2917484" localize="false"/> +<h2 id="hd_id2913722">NORM.DIST</h2> +<paragraph xml-lang="en-US" id="par_id2910386" role="paragraph"><ahelp hid="HID_FUNC_NORMDIST_MS">Returns the density function or the normal cumulative distribution.</ahelp></paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph xml-lang="en-US" id="par_id2910613" role="code">NORM.DIST(Number; Mean; StDev; C)</paragraph> +<paragraph xml-lang="en-US" id="par_id2919820" role="paragraph"><emph>Number</emph> is the value of the distribution based on which the normal distribution is to be calculated.</paragraph> +<paragraph xml-lang="en-US" id="par_id2916063" role="paragraph"><emph>Mean</emph> is the mean value of the distribution.</paragraph> +<paragraph xml-lang="en-US" id="par_id2916295" role="paragraph"><emph>StDev</emph> is the standard deviation of the distribution.</paragraph> +<paragraph xml-lang="en-US" id="par_id2915080" role="paragraph"><emph>C</emph> = 0 calculates the density function, <emph>C</emph> = 1 calculates the distribution.</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph xml-lang="en-US" id="par_id2919283" role="paragraph"> +<item type="input">=NORM.DIST(70;63;5;0)</item> returns 0.029945493.</paragraph> +<paragraph xml-lang="en-US" id="par_id2919448" role="paragraph"> +<item type="input">=NORM.DIST(70;63;5;1)</item> returns 0.9192433408.</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectiontechinfo"/> +<embed href="text/scalc/00/avail_release.xhp#4.3"/> +<embed href="text/scalc/01/common_func.xhp#notODFF"/> +<paragraph role="paragraph" id="par_id341640373986703" localize="false"><literal>COM.MICROSOFT.NORM.DIST</literal></paragraph> +</section> +<section id="pearson"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3152934"><bookmark_value>PEARSON function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_PEARSON" id="bm_id3156103" localize="false"/> +<h2 id="hd_id3152934">PEARSON</h2> +<paragraph xml-lang="en-US" id="par_id3153216" role="paragraph"><ahelp hid="HID_FUNC_PEARSON">Returns the Pearson product moment correlation coefficient r.</ahelp></paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph xml-lang="en-US" id="par_id3156133" role="code">PEARSON(Data1; Data2)</paragraph> +<paragraph xml-lang="en-US" id="par_id3151272" role="paragraph"><emph>Data1</emph> represents the array of the first data set.</paragraph> +<paragraph xml-lang="en-US" id="par_id3153279" role="paragraph"><emph>Data2</emph> represents the array of the second data set.</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph xml-lang="en-US" id="par_id3151187" role="paragraph"> +<item type="input">=PEARSON(A1:A30;B1:B30)</item> returns the Pearson correlation coefficient of both data sets.</paragraph> +</section> +<section id="phi"> + <bookmark xml-lang="en-US" branch="index" id="bm_id3152806"> + <bookmark_value>PHI function</bookmark_value> + </bookmark> + <bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_PHI" id="bm_id3153757" localize="false"/> + <h2 id="hd_id3152806">PHI</h2> + <paragraph xml-lang="en-US" id="par_id3150254" role="paragraph"><ahelp hid="HID_FUNC_PHI">Returns the value of the probability density function for a given value considering the standard normal distribution.</ahelp></paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph role="paragraph" id="par_id151629986285891"><input>PHI(Number)</input></paragraph> + <paragraph id="par_id3156108" role="paragraph"><emph>Number</emph> is the value for which the probability density function is calculated.</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph id="par_id3155849" role="paragraph"> + <input>=PHI(2.25)</input> returns 0.0317. + </paragraph> + <paragraph id="par_id3143236" role="paragraph"> + <input>=PHI(-2.25)</input> also returns 0.0317 because the normal distribution is symmetrical. + </paragraph> + <paragraph id="par_id3149286" role="paragraph"> + <input>=PHI(0)</input> returns 0.3989. + </paragraph> + <tip id="par_id611629985664328">Calling <input>PHI(Number)</input> is equivalent to calling <input>NORMDIST(Number,0,1,FALSE())</input> or <input>NORM.S.DIST(Number;FALSE())</input>, hence using the standard normal distribution with mean equal to 0 and standard deviation equal to 1 with the <emph>Cumulative</emph> argument set to <emph>False.</emph></tip> +</section> +<section id="poisson"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3153985"><bookmark_value>POISSON function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_POISSON" id="bm_id3156011" localize="false"/> +<h2 id="hd_id3153985">POISSON</h2> +<paragraph xml-lang="en-US" id="par_id3154298" role="paragraph"><ahelp hid="HID_FUNC_POISSON">Returns the Poisson distribution.</ahelp></paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph xml-lang="en-US" id="par_id3146093" role="code">POISSON(Number; Mean [; C])</paragraph> +<paragraph xml-lang="en-US" id="par_id3147253" role="paragraph"><emph>Number</emph> represents the value based on which the Poisson distribution is calculated.</paragraph> +<paragraph xml-lang="en-US" id="par_id3151177" role="paragraph"><emph>Mean</emph> represents the middle value of the Poisson distribution.</paragraph> +<paragraph xml-lang="en-US" id="par_id3149200" role="paragraph"><emph>C</emph> (optional) = 0 or False calculates the density function; <emph>C</emph> = 1 or True calculates the distribution. When omitted, the default value True is inserted when you save the document, for best compatibility with other programs and older versions of %PRODUCTNAME.</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph xml-lang="en-US" id="par_id3150113" role="paragraph"> +<item type="input">=POISSON(60;50;1)</item> returns 0.93.</paragraph> +</section> +<section id="poissondotdist"> + <bookmark xml-lang="en-US" branch="index" id="bm_id2953985"> + <bookmark_value>POISSON.DIST function</bookmark_value> + </bookmark> + <bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_POISSON_DIST_MS" id="bm_id2956011" localize="false"/> + <h2 id="hd_id2953985">POISSON.DIST</h2> + <paragraph xml-lang="en-US" id="par_id2954298" role="paragraph"><ahelp hid="HID_FUNC_POISSON_DIST_MS">Returns the Poisson distribution.</ahelp></paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph xml-lang="en-US" id="par_id2946093" role="code">POISSON.DIST(Number; Mean ; Cumulative)</paragraph> + <paragraph xml-lang="en-US" id="par_id2947253" role="paragraph"><emph>Number</emph> represents the value based on which the Poisson distribution is calculated.</paragraph> + <paragraph xml-lang="en-US" id="par_id2951177" role="paragraph"><emph>Mean</emph> represents the middle value of the Poisson distribution.</paragraph> + <paragraph xml-lang="en-US" id="par_id2949200" role="paragraph"><emph>Cumulative</emph> = 0 or False to calculate the probability mass function; <emph>Cumulative</emph> = 1, True, or any other non-zero value to calculate the cumulative distribution function.</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph xml-lang="en-US" id="par_id2950113" role="paragraph"><item type="input">=POISSON.DIST(60;50;1)</item> returns 0.9278398202.</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectiontechinfo"/> + <embed href="text/scalc/00/avail_release.xhp#4.2"/> + <embed href="text/scalc/01/common_func.xhp#notODFF"/> + <paragraph role="paragraph" id="par_id341630873986703" localize="false"><literal>COM.MICROSOFT.POISSON.DIST</literal></paragraph> +</section> +<section id="percentile"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3153100"><bookmark_value>PERCENTILE function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_QUANTIL" id="bm_id3155394" localize="false"/> +<h2 id="hd_id3153100">PERCENTILE</h2> +<paragraph xml-lang="en-US" id="par_id3154940" role="paragraph"><ahelp hid="HID_FUNC_QUANTIL">Returns the alpha-percentile of data values in an array.</ahelp> A percentile returns the scale value for a data series which goes from the smallest (Alpha=0) to the largest value (alpha=1) of a data series. For <item type="literal">Alpha</item> = 25%, the percentile means the first quartile; <item type="literal">Alpha</item> = 50% is the MEDIAN.</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph xml-lang="en-US" id="par_id3148813" role="code">PERCENTILE(Data; Alpha)</paragraph> +<paragraph xml-lang="en-US" id="par_id3153054" role="paragraph"><emph>Data</emph> represents the array of data.</paragraph> +<paragraph xml-lang="en-US" id="par_id3154212" role="paragraph"><emph>Alpha</emph> represents the percentage of the scale between 0 and 1.</paragraph> +<embed href="text/scalc/01/common_func.xhp#datenumbersequencenote"/> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph xml-lang="en-US" id="par_id3159147" role="paragraph"> +<item type="input">=PERCENTILE(A1:A50;0.1)</item> represents the value in the data set, which equals 10% of the total data scale in A1:A50.</paragraph> +</section> +<section id="percentileexc"> +<bookmark xml-lang="en-US" branch="index" id="bm_id2853100"><bookmark_value>PERCENTILE.EXC function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/HID_FUNC_PERCENTILE_EXC" id="bm_id2855394" localize="false"/> +<h2 id="hd_id2853100">PERCENTILE.EXC</h2> +<paragraph xml-lang="en-US" id="par_id2854940" role="paragraph"><ahelp hid="HID_FUNC_PERCENTILE_EXC">Returns the <item type="literal">Alpha</item>'th percentile of a supplied range of values for a given value of <item type="literal">Alpha</item>, within the range 0 to 1 (exclusive).</ahelp> A percentile returns the scale value for a data series which goes from the smallest (<item type="literal">Alpha=0</item>) to the largest value (<item type="literal">Alpha=1</item>) of a data series. For <item type="literal">Alpha</item> = 25%, the percentile means the first quartile; <item type="literal">Alpha</item> = 50% is the MEDIAN.</paragraph> +<warning id="par_id2754940">If <item type="literal">Alpha</item> is not a multiple of <item type="literal">1/(n+1)</item>, (where n is the number of values in the supplied array), the function interpolates between the values in the supplied array, to calculate the percentile value. However, if <item type="literal">Alpha</item> is less than <item type="literal">1/(n+1)</item> or <item type="literal">Alpha</item> is greater than <item type="literal">n/(n+1)</item>, the function is unable to interpolate, and so returns an error.</warning> +<note id="par_id2653976">The difference between <item type="input">PERCENTILE.INC</item> and <item type="input">PERCENTILE.EXC</item> is that, in the <item type="input">PERCENTILE.INC</item> function the value of alpha is within the range 0 to 1 inclusive, and in the <item type="input">PERCENTILE.EXC</item> function, the value of alpha is within the range 0 to 1 exclusive.</note> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph xml-lang="en-US" id="par_id2848813" role="code">PERCENTILE.EXC(Data; Alpha)</paragraph> +<paragraph xml-lang="en-US" id="par_id2853054" role="paragraph"><emph>Data</emph> represents the array of data.</paragraph> +<paragraph xml-lang="en-US" id="par_id2854212" role="paragraph"><emph>Alpha</emph> represents the percentage of the scale between 0 and 1.</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph xml-lang="en-US" id="par_id2859147" role="paragraph"><item type="input">=PERCENTILE.EXC(A1:A50;10%)</item> represents the value in the data set, which equals 10% of the total data scale in A1:A50.</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectiontechinfo"/> +<embed href="text/scalc/00/avail_release.xhp#4.3"/> +<embed href="text/scalc/01/common_func.xhp#notODFF"/> +<paragraph role="paragraph" id="par_id342640873986703" localize="false"><literal>COM.MICROSOFT.PERCENTILE.EXC</literal></paragraph> +</section> +<section id="percentileinc"> +<bookmark xml-lang="en-US" branch="index" id="bm_id2953100"><bookmark_value>PERCENTILE.INC function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/HID_FUNC_PERCENTILE_INC" id="bm_id2955394" localize="false"/> +<h2 id="hd_id2953100">PERCENTILE.INC</h2> +<paragraph xml-lang="en-US" id="par_id2954940" role="paragraph"><ahelp hid="HID_FUNC_PERCENTILE_INC">Returns the alpha-percentile of data values in an array.</ahelp> A percentile returns the scale value for a data series which goes from the smallest (Alpha=0) to the largest value (alpha=1) of a data series. For <item type="literal">Alpha</item> = 25%, the percentile means the first quartile; <item type="literal">Alpha</item> = 50% is the MEDIAN.</paragraph> +<note id="par_id2753976">The difference between <item type="input">PERCENTILE.INC</item> and <item type="input">PERCENTILE.EXC</item> is that, in the <item type="input">PERCENTILE.INC</item> function the value of alpha is within the range 0 to 1 inclusive, and in the <item type="input">PERCENTILE.EXC</item> function, the value of alpha is within the range 0 to 1 exclusive.</note> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph xml-lang="en-US" id="par_id2948813" role="code">PERCENTILE.INC(Data; Alpha)</paragraph> +<paragraph xml-lang="en-US" id="par_id2953054" role="paragraph"><emph>Data</emph> represents the array of data.</paragraph> +<paragraph xml-lang="en-US" id="par_id2954212" role="paragraph"><emph>Alpha</emph> represents the percentage of the scale between 0 and 1.</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph xml-lang="en-US" id="par_id2959147" role="paragraph"><item type="input">=PERCENTILE.INC(A1:A50;0.1)</item> represents the value in the data set, which equals 10% of the total data scale in A1:A50.</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectiontechinfo"/> +<embed href="text/scalc/00/avail_release.xhp#4.3"/> +<embed href="text/scalc/01/common_func.xhp#notODFF"/> +<paragraph role="paragraph" id="par_id341340873986703" localize="false"><literal>COM.MICROSOFT.PERCENTILE.INC</literal></paragraph> +</section> +<section id="percentrank"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3148807"><bookmark_value>PERCENTRANK function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_QUANTILSRANG" id="bm_id3154902" localize="false"/> +<h2 id="hd_id3148807">PERCENTRANK</h2> +<paragraph xml-lang="en-US" id="par_id3153573" role="paragraph"><ahelp hid="HID_FUNC_QUANTILSRANG">Returns the percentage rank of a value in a sample.</ahelp></paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph xml-lang="en-US" id="par_id3147238" role="code">PERCENTRANK(Data; Value [; Significance])</paragraph> +<paragraph xml-lang="en-US" id="par_id3154266" role="paragraph"><emph>Data</emph> represents the array of data in the sample.</paragraph> +<paragraph xml-lang="en-US" id="par_id3148475" role="paragraph"><emph>Value</emph> represents the value whose percentile rank must be determined.</paragraph> +<paragraph xml-lang="en-US" id="par_id2748477" role="paragraph"><emph>Significance</emph> An optional argument that specifies the number of significant digits that the returned percentage value is rounded to. If omitted, a value of 3 is used.</paragraph> +<embed href="text/scalc/01/common_func.xhp#datenumbersequencenote"/> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph xml-lang="en-US" id="par_id3149163" role="paragraph"> +<item type="input">=PERCENTRANK(A1:A50;50)</item> returns the percentage rank of the value 50 from the total range of all values found in A1:A50. If 50 falls outside the total range, an error message will appear.</paragraph> +</section> +<section id="percentrankexc"> +<bookmark xml-lang="en-US" branch="index" id="bm_id2848807"><bookmark_value>PERCENTRANK.EXC function</bookmark_value></bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_PERCENTRANK_EXC" id="bm_id2854902" localize="false"/> +<h2 id="hd_id2848807">PERCENTRANK.EXC</h2> +<paragraph xml-lang="en-US" id="par_id2853573" role="paragraph"><ahelp hid="HID_FUNC_PERCENTRANK_EXC"> Returns the relative position, between 0 and 1 (exclusive), of a specified value within a supplied array.</ahelp></paragraph> +<note id="par_id2553976">The difference between <item type="input">PERCENTRANK.INC</item> and <item type="input">PERCENTRANK.EXC</item> is that <item type="input">PERCENTRANK.INC</item> calculates a value in the range 0 to 1 inclusive, whereas the <item type="input">PERCENTRANK.EXC</item> function calculates a value in the range 0 to 1 exclusive.</note> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph xml-lang="en-US" id="par_id2847238" role="code">PERCENTRANK.EXC(Data; Value [; Significance])</paragraph> +<paragraph xml-lang="en-US" id="par_id2854266" role="paragraph"><emph>Data</emph> represents the array of data in the sample.</paragraph> +<paragraph xml-lang="en-US" id="par_id2848475" role="paragraph"><emph>Value</emph> represents the value whose percentile rank must be determined.</paragraph> +<paragraph xml-lang="en-US" id="par_id2748475" role="paragraph"><emph>Significance</emph> An optional argument that specifies the number of significant digits that the returned percentage value is rounded to.</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph xml-lang="en-US" id="par_id2849163" role="paragraph"><item type="input">=PERCENTRANK.EXC(A1:A50;50)</item> returns the percentage rank of the value 50 from the total range of all values found in A1:A50. If 50 falls outside the total range, an error message will appear.</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectiontechinfo"/> +<embed href="text/scalc/00/avail_release.xhp#4.3"/> +<embed href="text/scalc/01/common_func.xhp#notODFF"/> +<paragraph role="paragraph" id="par_id341640878986703" localize="false"><literal>COM.MICROSOFT.PERCENTRANK.EXC</literal></paragraph> +</section> +<section id="percentrankinc"> +<bookmark xml-lang="en-US" branch="index" id="bm_id2948807"><bookmark_value>PERCENTRANK.INC function</bookmark_value></bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_PERCENTRANK_INC" id="bm_id2954902" localize="false"/> +<h2 id="hd_id2948807">PERCENTRANK.INC</h2> +<paragraph xml-lang="en-US" id="par_id2953573" role="paragraph"><ahelp hid="HID_FUNC_PERCENTRANK_INC">Returns the relative position, between 0 and 1 (inclusive), of a specified value within a supplied array.</ahelp></paragraph> +<note id="par_id2453976">The difference between <item type="input">PERCENTRANK.INC</item> and <item type="input">PERCENTRANK.EXC</item> is that <item type="input">PERCENTRANK.INC</item> calculates a value in the range 0 to 1 inclusive, whereas the <item type="input">PERCENTRANK.EXC</item> function calculates a value in the range 0 to 1 exclusive.</note> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph xml-lang="en-US" id="par_id2947238" role="code">PERCENTRANK.INC(Data; Value [; Significance])</paragraph> +<paragraph xml-lang="en-US" id="par_id2954266" role="paragraph"><emph>Data</emph> represents the array of data in the sample.</paragraph> +<paragraph xml-lang="en-US" id="par_id2948475" role="paragraph"><emph>Value</emph> represents the value whose percentile rank must be determined.</paragraph> +<paragraph xml-lang="en-US" id="par_id2648475" role="paragraph"><emph>Significance</emph> An optional argument that specifies the number of significant digits that the returned percentage value is rounded to.</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph xml-lang="en-US" id="par_id2949163" role="paragraph"><item type="input">=PERCENTRANK.INC(A1:A50;50)</item> returns the percentage rank of the value 50 from the total range of all values found in A1:A50. If 50 falls outside the total range, an error message will appear.</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectiontechinfo"/> +<embed href="text/scalc/00/avail_release.xhp#4.3"/> +<embed href="text/scalc/01/common_func.xhp#notODFF"/> +<paragraph role="paragraph" id="par_id341640873086703" localize="false"><literal>COM.MICROSOFT.PERCENTRANK.INC</literal></paragraph> +</section> +<section id="quartile"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3166442"><bookmark_value>QUARTILE function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_QUARTILE" id="bm_id3150709" localize="false"/> +<h2 id="hd_id3166442">QUARTILE</h2> +<paragraph xml-lang="en-US" id="par_id3146958" role="paragraph"><ahelp hid="HID_FUNC_QUARTILE">Returns the quartile of a data set.</ahelp></paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph xml-lang="en-US" id="par_id3153684" role="code">QUARTILE(Data; Type)</paragraph> +<paragraph xml-lang="en-US" id="par_id3153387" role="paragraph"><emph>Data</emph> represents the array of data in the sample.</paragraph> +<paragraph xml-lang="en-US" id="par_id3155589" role="paragraph"><emph>Type</emph> represents the type of quartile. (0 = MIN, 1 = 25%, 2 = 50% (MEDIAN), 3 = 75% and 4 = MAX.)</paragraph> +<embed href="text/scalc/01/common_func.xhp#datenumbersequencenote"/> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph xml-lang="en-US" id="par_id3159276" role="paragraph"> +<item type="input">=QUARTILE(A1:A50;2)</item> returns the value of which 50% of the scale corresponds to the lowest to highest values in the range A1:A50.</paragraph> +</section> +<section id="quartileexc"> +<bookmark xml-lang="en-US" branch="index" id="bm_id2866442"><bookmark_value>QUARTILE.EXC function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_QUARTILE_EXC" id="bm_id2950709" localize="false"/> +<h2 id="hd_id2866442">QUARTILE.EXC</h2> +<paragraph xml-lang="en-US" id="par_id2846958" role="paragraph"><ahelp hid="HID_FUNC_QUARTILE_EXC">Returns a requested quartile of a supplied range of values, based on a percentile range of 0 to 1 exclusive.</ahelp></paragraph> +<note id="par_id2353976">The difference between <item type="input">QUARTILE.INC</item> and <item type="input">QUARTILE.EXC</item> is that the <item type="input">QUARTILE.INC</item> function bases its calculation on a percentile range of 0 to 1 inclusive, whereas the <item type="input">QUARTILE.EXC</item> function bases its calculation on a percentile range of 0 to 1 exclusive.</note> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph xml-lang="en-US" id="par_id2853684" role="code">QUARTILE.EXC(Data; Type)</paragraph> +<paragraph xml-lang="en-US" id="par_id2853387" role="paragraph"><emph>Data</emph> represents the range of data values for which you want to calculate the specified quartile.</paragraph> +<paragraph xml-lang="en-US" id="par_id2855589" role="paragraph"><emph>Type</emph> An integer between 1 and 3, representing the required quartile. (if type = 1 or 3, the supplied array must contain more than 2 values) </paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph xml-lang="en-US" id="par_id2859276" role="paragraph"> +<item type="input">=QUARTILE.EXC(A1:A50;2)</item> returns the value of which 50% of the scale corresponds to the lowest to highest values in the range A1:A50.</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectiontechinfo"/> +<embed href="text/scalc/00/avail_release.xhp#4.3"/> +<embed href="text/scalc/01/common_func.xhp#notODFF"/> +<paragraph role="paragraph" id="par_id341640873986700" localize="false"><literal>COM.MICROSOFT.QUARTILE.EXC</literal></paragraph> +</section> +<section id="quartileinc"> +<bookmark xml-lang="en-US" branch="index" id="bm_id2966442"><bookmark_value>QUARTILE.INC function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_QUARTILE_INC" id="bm_id2950309" localize="false"/> +<h2 id="hd_id2966442">QUARTILE.INC</h2> +<paragraph xml-lang="en-US" id="par_id2946958" role="paragraph"><ahelp hid="HID_FUNC_QUARTILE_INC">Returns the quartile of a data set.</ahelp></paragraph> +<note id="par_id2253976">The difference between <item type="input">QUARTILE.INC</item> and <item type="input">QUARTILE.EXC</item> is that the <item type="input">QUARTILE.INC</item> function bases its calculation on a percentile range of 0 to 1 inclusive, whereas the <item type="input">QUARTILE.EXC</item> function bases its calculation on a percentile range of 0 to 1 exclusive.</note> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph xml-lang="en-US" id="par_id2953684" role="code">QUARTILE.INC(Data; Type)</paragraph> +<paragraph xml-lang="en-US" id="par_id2953387" role="paragraph"><emph>Data</emph> represents the array of data in the sample.</paragraph> +<paragraph xml-lang="en-US" id="par_id2955589" role="paragraph"><emph>Type</emph> represents the type of quartile. (0 = MIN, 1 = 25%, 2 = 50% (MEDIAN), 3 = 75% and 4 = MAX.)</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph xml-lang="en-US" id="par_id2959276" role="paragraph"> +<item type="input">=QUARTILE.INC(A1:A50;2)</item> returns the value of which 50% of the scale corresponds to the lowest to highest values in the range A1:A50.</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectiontechinfo"/> +<embed href="text/scalc/00/avail_release.xhp#4.3"/> +<embed href="text/scalc/01/common_func.xhp#notODFF"/> +<paragraph role="paragraph" id="par_id341640873986707" localize="false"><literal>COM.MICROSOFT.QUARTILE.INC</literal></paragraph> +</section> +</sort> +<section id="relatedtopics"> +<embed href="text/scalc/01/04060100.xhp#drking"/> +</section> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/04060185.xhp b/helpcontent2/source/text/scalc/01/04060185.xhp new file mode 100644 index 000000000..9223f4a2b --- /dev/null +++ b/helpcontent2/source/text/scalc/01/04060185.xhp @@ -0,0 +1,786 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> + +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . + --> + + +<meta> + <topic id="textscalc0104060185xml" indexer="include"> + <title xml-lang="en-US" id="tit">Statistical Functions Part Five</title> + <filename>/text/scalc/01/04060185.xhp</filename> + </topic> + </meta> + <body> + <h1 id="hd_id3147072"><variable id="rz"><link href="text/scalc/01/04060185.xhp" name="Statistical Functions Part Five">Statistical Functions Part Five</link> +</variable></h1> +<sort order="asc" descendant="h2"> +<section id="rank"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3155071"><bookmark_value>RANK function</bookmark_value> + <bookmark_value>numbers;determining ranks</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_RANG" id="bm_id3146778" localize="false"/> +<h2 id="hd_id3155071">RANK</h2> + <paragraph xml-lang="en-US" id="par_id3153976" role="paragraph"><ahelp hid="HID_FUNC_RANG">Returns the rank of a number in a sample.</ahelp></paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph xml-lang="en-US" id="par_id3153250" role="code">RANK(Value; Data [; Type])</paragraph> + <paragraph xml-lang="en-US" id="par_id3154543" role="paragraph"> + <emph>Value</emph> is the value, whose rank is to be determined.</paragraph> + <paragraph xml-lang="en-US" id="par_id3149130" role="paragraph"> + <emph>Data</emph> is the array or range of data in the sample.</paragraph> + <paragraph xml-lang="en-US" id="par_id3150215" role="paragraph"> + <emph>Type</emph> (optional) is the sequence order.</paragraph> + <paragraph xml-lang="en-US" id="par_id9305398" role="paragraph">Type = 0 means descending from the last item of the array to the first (this is the default),</paragraph> + <paragraph xml-lang="en-US" id="par_id9996948" role="paragraph">Type = 1 means ascending from the first item of the range to the last.</paragraph> + <embed href="text/scalc/01/common_func.xhp#datenumbersequencenote"/> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph xml-lang="en-US" id="par_id3155919" role="paragraph"> + <item type="input">=RANK(A10;A1:A50)</item> returns the ranking of the value in A10 in value range A1:A50. If <item type="literal">Value</item> does not exist within the range an error message is displayed.</paragraph> + </section> +<section id="rankavg"> +<bookmark xml-lang="en-US" branch="index" id="bm_id2955071"> + <bookmark_value>RANK.AVG function</bookmark_value> + <bookmark_value>numbers;determining ranks</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_RANK_AVG" id="bm_id2946778" localize="false"/> +<h2 id="hd_id2955071">RANK.AVG</h2> +<paragraph xml-lang="en-US" id="par_id2953976" role="paragraph"><ahelp hid="HID_FUNC_RANK_AVG">Returns the statistical rank of a given value, within a supplied array of values.</ahelp> If there are duplicate values in the list, the average rank is returned.</paragraph> +<note id="par_id2653976">The difference between <item type="input">RANK.AVG</item> and <item type="input">RANK.EQ</item> occurs when there are duplicates in the list of values. The <item type="input">RANK.EQ</item> function returns the lower rank, whereas the <item type="input">RANK.AVG</item> function returns the average rank.</note> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph xml-lang="en-US" id="par_id2953250" role="code">RANK.AVG(Value; Data [; Type])</paragraph> +<paragraph xml-lang="en-US" id="par_id2954543" role="paragraph"><emph>Value</emph> is the value, whose rank is to be determined.</paragraph> +<paragraph xml-lang="en-US" id="par_id2949130" role="paragraph"><emph>Data</emph> is the array or range of data in the sample.</paragraph> +<paragraph xml-lang="en-US" id="par_id2950215" role="paragraph"><emph>Type</emph> (optional) is the sequence order.</paragraph> +<paragraph xml-lang="en-US" id="par_id0305398" role="paragraph">Type = 0 means descending from the last item of the array to the first (this is the default),</paragraph> +<paragraph xml-lang="en-US" id="par_id0996948" role="paragraph">Type = 1 means ascending from the first item of the range to the last.</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph xml-lang="en-US" id="par_id2955919" role="paragraph"><item type="input">=RANK.AVG(A10;A1:A50)</item> returns the ranking of the value in A10 in value range A1:A50. If <item type="literal">Value</item> does not exist within the range an error message is displayed.</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectiontechinfo"/> +<embed href="text/scalc/00/avail_release.xhp#4.3"/> +<embed href="text/scalc/01/common_func.xhp#notODFF"/> +<paragraph role="paragraph" id="par_id341640873886703" localize="false"><literal>COM.MICROSOFT.RANK.AVG</literal></paragraph> +</section> +<section id="rankeq"> +<bookmark xml-lang="en-US" branch="index" id="bm_id2855071"> + <bookmark_value>RANK.EQ function</bookmark_value> + <bookmark_value>numbers;determining ranks</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_RANK_EQ" id="bm_id2846778" localize="false"/> +<h2 id="hd_id2855071">RANK.EQ</h2> +<paragraph xml-lang="en-US" id="par_id2853976" role="paragraph"><ahelp hid="HID_FUNC_RANK_EQ">Returns the statistical rank of a given value, within a supplied array of values.</ahelp> If there are duplicate values in the list, these are given the same rank.</paragraph> +<note id="par_id2753976">The difference between <item type="input">RANK.AVG</item> and <item type="input">RANK.EQ</item> occurs when there are duplicates in the list of values. The <item type="input">RANK.EQ</item> function returns the lower rank, whereas the <item type="input">RANK.AVG</item> function returns the average rank.</note> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph xml-lang="en-US" id="par_id2853250" role="code">RANK.EQ(Value; Data [; Type])</paragraph> +<paragraph xml-lang="en-US" id="par_id2854543" role="paragraph"><emph>Value</emph> is the value, whose rank is to be determined.</paragraph> +<paragraph xml-lang="en-US" id="par_id2849130" role="paragraph"><emph>Data</emph> is the array or range of data in the sample.</paragraph> +<paragraph xml-lang="en-US" id="par_id2850215" role="paragraph"><emph>Type</emph> (optional) is the sequence order.</paragraph> +<paragraph xml-lang="en-US" id="par_id89305398" role="paragraph">Type = 0 means descending from the last item of the array to the first (this is the default),</paragraph> +<paragraph xml-lang="en-US" id="par_id89996948" role="paragraph">Type = 1 means ascending from the first item of the range to the last.</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph xml-lang="en-US" id="par_id2855919" role="paragraph"><item type="input">=RANK.EQ(A10;A1:A50)</item> returns the ranking of the value in A10 in value range A1:A50. If <item type="literal">Value</item> does not exist within the range an error message is displayed.</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectiontechinfo"/> +<embed href="text/scalc/00/avail_release.xhp#4.3"/> +<embed href="text/scalc/01/common_func.xhp#notODFF"/> +<paragraph role="paragraph" id="par_id341040873966703" localize="false"><literal>COM.MICROSOFT.RANK.EQ</literal></paragraph> +</section> + <section id="skew"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3153556"><bookmark_value>SKEW function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_SCHIEFE" id="bm_id3153801" localize="false"/> +<h2 id="hd_id3153556">SKEW</h2> + <paragraph xml-lang="en-US" id="par_id3153485" role="paragraph"><ahelp hid="HID_FUNC_SCHIEFE">Returns the skewness of a distribution.</ahelp></paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + + <paragraph xml-lang="en-US" id="par_id3151191" role="code">SKEW(<embedvar href="text/scalc/01/ful_func.xhp#number255_1" markup="keep"/>)</paragraph> + <embed href="text/scalc/01/ful_func.xhp#number255"/> + <paragraph id="par_id171585151428396" role="paragraph" xml-lang="en-US">The parameters should specify at least three values.</paragraph> + <embed href="text/scalc/01/common_func.xhp#datenumbersequencenote"/> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph xml-lang="en-US" id="par_id3145118" role="paragraph"> + <item type="input">=SKEW(A1:A50)</item> calculates the value of skew for the data referenced.</paragraph> + </section> +<section id="skewp"> + <embed href="text/scalc/01/func_skewp.xhp#skewp_function"/> +</section> + <section id="forecast"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3149051"><bookmark_value>regression lines;FORECAST function</bookmark_value> + <bookmark_value>extrapolations</bookmark_value> + <bookmark_value>FORECAST function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_SCHAETZER" id="bm_id3146102" localize="false"/><comment>mw made "regression lines" a two level entry</comment> +<h2 id="hd_id3149051">FORECAST</h2> + <paragraph xml-lang="en-US" id="par_id3153290" role="paragraph"><ahelp hid="HID_FUNC_SCHAETZER">Extrapolates future values based on existing x and y values.</ahelp></paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph xml-lang="en-US" id="par_id3147404" role="code">FORECAST(Value; DataY; DataX)</paragraph> + <paragraph xml-lang="en-US" id="par_id3148743" role="paragraph"> + <emph>Value</emph> is the x value, for which the y value on the linear regression is to be returned.</paragraph> + <paragraph xml-lang="en-US" id="par_id3146325" role="paragraph"> + <emph>DataY</emph> is the array or range of known y's.</paragraph> + <paragraph xml-lang="en-US" id="par_id3150536" role="paragraph"> + <emph>DataX</emph> is the array or range of known x's.</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph xml-lang="en-US" id="par_id3157874" role="paragraph"> + <item type="input">=FORECAST(50;A1:A50;B1;B50)</item> returns the Y value expected for the X value of 50 if the X and Y values in both references are linked by a linear trend.</paragraph> + </section> + <section id="forecastlinear"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3149052"><bookmark_value>regression lines;FORECAST.LINEAR function</bookmark_value> + <bookmark_value>extrapolations</bookmark_value> + <bookmark_value>FORECAST.LINEAR function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_FORECAST_LIN" id="bm_id3146102" localize="false"/> +<h2 id="hd_id3149052">FORECAST.LINEAR</h2> + <paragraph xml-lang="en-US" id="par_id3153291" role="paragraph"><ahelp hid="HID_FUNC_SCHAETZER">Extrapolates future values based on existing x and y values.</ahelp></paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph xml-lang="en-US" id="par_id3147405" role="code">FORECAST.LINEAR(Value; DataY; DataX)</paragraph> + <paragraph xml-lang="en-US" id="par_id3148744" role="paragraph"> + <emph>Value</emph> is the x value, for which the y value on the linear regression is to be returned.</paragraph> + <paragraph xml-lang="en-US" id="par_id3146326" role="paragraph"> + <emph>DataY</emph> is the array or range of known y's.</paragraph> + <paragraph xml-lang="en-US" id="par_id3150537" role="paragraph"> + <emph>DataX</emph> is the array or range of known x's.</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph xml-lang="en-US" id="par_id3157875" role="paragraph"> + <item type="input">=FORECAST.LINEAR(50;A1:A50;B1;B50)</item> returns the Y value expected for the X value of 50 if the X and Y values in both references are linked by a linear trend.</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectiontechinfo"/> + <embed href="text/scalc/01/common_func.xhp#notODFF"/> + <paragraph role="paragraph" id="par_id341640873980703" localize="false"><literal>COM.MICROSOFT.FORECAST.LINEAR</literal></paragraph> + </section> + <section id="stdev"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3149143"><bookmark_value>STDEV function</bookmark_value> + <bookmark_value>standard deviations in statistics;based on a sample</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_STABW" id="bm_id3153121" localize="false"/> +<h2 id="hd_id3149143">STDEV</h2> + <paragraph xml-lang="en-US" id="par_id3146888" role="paragraph"><ahelp hid="HID_FUNC_STABW">Estimates the standard deviation based on a sample.</ahelp></paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph xml-lang="en-US" id="par_id3149946" role="code">STDEV(<embedvar href="text/scalc/01/ful_func.xhp#number255_1" markup="keep"/>)</paragraph> + <embed href="text/scalc/01/ful_func.xhp#number255"/> + <paragraph id="par_id211585163957345" role="paragraph" xml-lang="en-US">The parameters should specify at least two values.</paragraph> + <embed href="text/scalc/01/common_func.xhp#datenumbersequencenote"/> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph xml-lang="en-US" id="par_id3149434" role="paragraph"><input>=STDEV(A1:A50)</input> returns the estimated standard deviation based on the data referenced.</paragraph> + </section> + <section id="stdeva"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3144745"><bookmark_value>STDEVA function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_STABWA" id="bm_id3154846" localize="false"/> +<h2 id="hd_id3144745">STDEVA</h2> + <paragraph xml-lang="en-US" id="par_id3151234" role="paragraph"><ahelp hid="HID_FUNC_STABWA">Calculates the standard deviation of an estimation based on a sample.</ahelp></paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + + <paragraph xml-lang="en-US" id="par_id3147422" role="code">STDEVA(<embedvar href="text/scalc/01/ful_func.xhp#number255_1" markup="keep"/>)</paragraph> + <embed href="text/scalc/01/ful_func.xhp#number255"/> + <paragraph id="par_id981585163977014" role="paragraph" xml-lang="en-US">The parameters should specify at least two values. Text has the value 0.</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph xml-lang="en-US" id="par_id3148581" role="paragraph"> + <item type="input">=STDEVA(A1:A50)</item> returns the estimated standard deviation based on the data referenced.</paragraph> + </section> + <section id="stdevp"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3149734"><bookmark_value>STDEVP function</bookmark_value> + <bookmark_value>standard deviations in statistics;based on a population</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_STABWN" id="bm_id3146139" localize="false"/> +<h2 id="hd_id3149734">STDEVP</h2> + <paragraph xml-lang="en-US" id="par_id3149187" role="paragraph"><ahelp hid="HID_FUNC_STABWN">Calculates the standard deviation based on the entire population.</ahelp></paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + + <paragraph xml-lang="en-US" id="par_id3154392" role="code">STDEVP(<embedvar href="text/scalc/01/ful_func.xhp#number255_1" markup="keep"/>)</paragraph> + <embed href="text/scalc/01/ful_func.xhp#number255"/> + <embed href="text/scalc/01/common_func.xhp#datenumbersequencenote"/> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph xml-lang="en-US" id="par_id3153933" role="paragraph"> + <item type="input">=STDEVP(A1:A50)</item> returns a standard deviation of the data referenced.</paragraph> + </section> +<section id="stdevdotp"> + <bookmark xml-lang="en-US" branch="index" id="bm_id2949734"> + <bookmark_value>STDEV.P function</bookmark_value> + <bookmark_value>standard deviations in statistics;based on a population</bookmark_value> + </bookmark> + <bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_ST_DEV_P_MS" id="bm_id2946139" localize="false"/> + <h2 id="hd_id2949734">STDEV.P</h2> + <paragraph xml-lang="en-US" id="par_id2949187" role="paragraph"><ahelp hid="HID_FUNC_ST_DEV_P_MS">Calculates the standard deviation based on the entire population.</ahelp></paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + + <paragraph xml-lang="en-US" id="par_id2954392" role="code">STDEV.P(<embedvar href="text/scalc/01/ful_func.xhp#number255_1" markup="keep"/>)</paragraph> + <embed href="text/scalc/01/ful_func.xhp#number255"/> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph xml-lang="en-US" id="par_id2953933" role="paragraph"><item type="input">=STDEV.P(A1:A50)</item> returns a standard deviation of the data referenced.</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectiontechinfo"/> + <embed href="text/scalc/00/avail_release.xhp#4.2"/> + <embed href="text/scalc/01/common_func.xhp#notODFF"/> + <paragraph role="paragraph" id="par_id341640873986700" localize="false"><literal>COM.MICROSOFT.STDEV.P</literal></paragraph> +</section> +<section id="stdevdots"> + <bookmark xml-lang="en-US" branch="index" id="bm_id2849734"> + <bookmark_value>STDEV.S function</bookmark_value> + <bookmark_value>standard deviations in statistics;based on a sample</bookmark_value> + </bookmark> + <bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_ST_DEV_S" id="bm_id2846139" localize="false"/> + <h2 id="hd_id2849734">STDEV.S</h2> + <paragraph xml-lang="en-US" id="par_id2849187" role="paragraph"><ahelp hid="HID_FUNC_ST_DEV_S">Calculates the standard deviation based on sample of the population.</ahelp></paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + + <paragraph xml-lang="en-US" id="par_id2854392" role="code">STDEV.S(<embedvar href="text/scalc/01/ful_func.xhp#number255_1" markup="keep"/>)</paragraph> + <embed href="text/scalc/01/ful_func.xhp#number255"/> + <paragraph id="par_id671585163972431" role="paragraph" xml-lang="en-US">The parameters should specify at least two values.</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph xml-lang="en-US" id="par_id2853933" role="paragraph"><item type="input">=STDEV.S(A1:A50)</item> returns a standard deviation of the data referenced.</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectiontechinfo"/> + <embed href="text/scalc/00/avail_release.xhp#4.2"/> + <embed href="text/scalc/01/common_func.xhp#notODFF"/> + <paragraph role="paragraph" id="par_id301640873986703" localize="false"><literal>COM.MICROSOFT.STDEV.S</literal></paragraph> +</section> + <section id="stdevpa"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3154522"><bookmark_value>STDEVPA function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_STABWNA" id="bm_id3150902" localize="false"/> +<h2 id="hd_id3154522">STDEVPA</h2> + <paragraph xml-lang="en-US" id="par_id3149549" role="paragraph"><ahelp hid="HID_FUNC_STABWNA">Calculates the standard deviation based on the entire population.</ahelp></paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph xml-lang="en-US" id="par_id3146851" role="code">STDEVPA(<embedvar href="text/scalc/01/ful_func.xhp#number255_1" markup="keep"/>)</paragraph> + <embed href="text/scalc/01/ful_func.xhp#number255"/> + <paragraph id="par_id961585163990543" role="paragraph" xml-lang="en-US">Text has the value 0.</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph xml-lang="en-US" id="par_id3145163" role="paragraph"> + <item type="input">=STDEVPA(A1:A50)</item> returns the standard deviation of the data referenced.</paragraph> + </section> + <section id="standardize"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3155928"><bookmark_value>STANDARDIZE function</bookmark_value> + <bookmark_value>converting;random variables, into normalized values</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_STANDARDISIERUNG" id="bm_id3148764" localize="false"/> +<h2 id="hd_id3155928">STANDARDIZE</h2> + <paragraph xml-lang="en-US" id="par_id3149883" role="paragraph"><ahelp hid="HID_FUNC_STANDARDISIERUNG">Converts a random variable to a normalized value.</ahelp></paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph xml-lang="en-US" id="par_id3150132" role="code">STANDARDIZE(Number; Mean; StDev)</paragraph> + <paragraph xml-lang="en-US" id="par_id3159139" role="paragraph"> + <emph>Number</emph> is the value to be standardized.</paragraph> + <paragraph xml-lang="en-US" id="par_id3145241" role="paragraph"> + <emph>Mean</emph> is the arithmetic mean of the distribution.</paragraph> + <paragraph xml-lang="en-US" id="par_id3148874" role="paragraph"> + <emph>StDev</emph> is the standard deviation of the distribution.</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph xml-lang="en-US" id="par_id3156067" role="paragraph"> + <item type="input">=STANDARDIZE(11;10;1)</item> returns 1. The value 11 in a normal distribution with a mean of 10 and a standard deviation of 1 is as much above the mean of 10, as the value 1 is above the mean of the standard normal distribution.</paragraph> + </section> + <section id="normsinv"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3157986"><bookmark_value>NORMSINV function</bookmark_value> + <bookmark_value>normal distribution;inverse of standard</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_STANDNORMINV" id="bm_id3148389" localize="false"/> +<h2 id="hd_id3157986">NORMSINV</h2> + <paragraph xml-lang="en-US" id="par_id3151282" role="paragraph"><ahelp hid="HID_FUNC_STANDNORMINV">Returns the inverse of the standard normal cumulative distribution.</ahelp></paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph xml-lang="en-US" id="par_id3154195" role="code">NORMSINV(Number)</paragraph> + <paragraph xml-lang="en-US" id="par_id3148772" role="paragraph"> + <emph>Number</emph> is the probability to which the inverse standard normal distribution is calculated.</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph xml-lang="en-US" id="par_id3149030" role="paragraph"> + <item type="input">=NORMSINV(0.908789)</item> returns 1.3333.</paragraph> + </section> + <section id="normdotsdotinv"> +<bookmark xml-lang="en-US" branch="index" id="bm_id2957986"><bookmark_value>NORM.S.INV function</bookmark_value> + <bookmark_value>normal distribution;inverse of standard</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_STD_NORMINV_MS" id="bm_id2948389" localize="false"/> +<h2 id="hd_id2957986">NORM.S.INV</h2> + <paragraph xml-lang="en-US" id="par_id2951282" role="paragraph"><ahelp hid="HID_FUNC_STD_NORMINV_MS">Returns the inverse of the standard normal cumulative distribution.</ahelp></paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph xml-lang="en-US" id="par_id2954195" role="code">NORM.S.INV(Number)</paragraph> + <paragraph xml-lang="en-US" id="par_id2948772" role="paragraph"> + <emph>Number</emph> is the probability to which the inverse standard normal distribution is calculated.</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph xml-lang="en-US" id="par_id2949030" role="paragraph"> + <item type="input">=NORM.S.INV(0.908789)</item> returns 1.333334673.</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectiontechinfo"/> + <embed href="text/scalc/00/avail_release.xhp#4.3"/> + <embed href="text/scalc/01/common_func.xhp#notODFF"/> + <paragraph role="paragraph" id="par_id341000873986703" localize="false"><literal>COM.MICROSOFT.NORM.S.INV</literal></paragraph> + </section> + <section id="normsdist"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3147538"><bookmark_value>NORMSDIST function</bookmark_value> + <bookmark_value>normal distribution;statistics</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_STANDNORMVERT" id="bm_id3145269" localize="false"/> +<h2 id="hd_id3147538">NORMSDIST</h2> + <paragraph xml-lang="en-US" id="par_id3150474" role="paragraph"><ahelp hid="HID_FUNC_STANDNORMVERT">Returns the standard normal cumulative distribution function. The distribution has a mean of zero and a standard deviation of one.</ahelp></paragraph> + <paragraph xml-lang="en-US" id="par_id8652302" role="paragraph">It is GAUSS(x)=NORMSDIST(x)-0.5</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph xml-lang="en-US" id="par_id3158411" role="code">NORMSDIST(Number)</paragraph> + <paragraph xml-lang="en-US" id="par_id3154950" role="paragraph"> + <emph>Number</emph> is the value to which the standard normal cumulative distribution is calculated.</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph xml-lang="en-US" id="par_id3155984" role="paragraph"> + <item type="input">=NORMSDIST(1)</item> returns 0.84. The area below the standard normal distribution curve to the left of X value 1 is 84% of the total area.</paragraph> + </section> + <section id="normdotsdotdist"> +<bookmark xml-lang="en-US" branch="index" id="bm_id2947538"><bookmark_value>NORM.S.DIST function</bookmark_value> + <bookmark_value>normal distribution;statistics</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_STD_NORMDIST_MS" id="bm_id2945269" localize="false"/> +<h2 id="hd_id2947538">NORM.S.DIST</h2> + <paragraph xml-lang="en-US" id="par_id2950474" role="paragraph"><ahelp hid="HID_FUNC_STD_NORMDIST_MS">Returns the standard normal cumulative distribution function. The distribution has a mean of zero and a standard deviation of one.</ahelp></paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph xml-lang="en-US" id="par_id2958411" role="code">NORM.S.DIST(Number; Cumulative)</paragraph> + <paragraph xml-lang="en-US" id="par_id2954950" role="paragraph"> + <emph>Number</emph> is the value to which the standard normal cumulative distribution is calculated.</paragraph> + <paragraph xml-lang="en-US" id="par_id2954951" role="paragraph"> + <emph>Cumulative</emph> 0 or FALSE calculates the probability density function. Any other value or TRUE calculates the cumulative distribution function.</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph xml-lang="en-US" id="par_id2955984" role="paragraph"> + <item type="input">=NORM.S.DIST(1;0)</item> returns 0.2419707245.</paragraph> + <paragraph xml-lang="en-US" id="par_id2955985" role="paragraph"> + <item type="input">=NORM.S.DIST(1;1)</item> returns 0.8413447461. The area below the standard normal distribution curve to the left of X value 1 is 84% of the total area.</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectiontechinfo"/> + <embed href="text/scalc/00/avail_release.xhp#4.3"/> + <embed href="text/scalc/01/common_func.xhp#notODFF"/> + <paragraph role="paragraph" id="par_id341640873980003" localize="false"><literal>COM.MICROSOFT.NORM.S.DIST</literal></paragraph> + </section> + <section id="slope"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3152592"><bookmark_value>SLOPE function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_STEIGUNG" id="bm_id3153716" localize="false"/> +<h2 id="hd_id3152592">SLOPE</h2> + <paragraph xml-lang="en-US" id="par_id3150386" role="paragraph"><ahelp hid="HID_FUNC_STEIGUNG">Returns the slope of the linear regression line.</ahelp> The slope is adapted to the data points set in the y and x values.</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph xml-lang="en-US" id="par_id3149819" role="code">SLOPE(DataY; DataX)</paragraph> + <paragraph xml-lang="en-US" id="par_id3083446" role="paragraph"> + <emph>DataY</emph> is the array or matrix of Y data.</paragraph> + <paragraph xml-lang="en-US" id="par_id3152375" role="paragraph"> + <emph>DataX</emph> is the array or matrix of X data.</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph xml-lang="en-US" id="par_id3152480" role="paragraph"> + <item type="input">=SLOPE(A1:A50;B1:B50)</item> + </paragraph> + </section> + <section id="steyx"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3155836"><bookmark_value>STEYX function</bookmark_value> + <bookmark_value>standard errors;statistical functions</bookmark_value> +</bookmark><comment>mw changed "standard errors"</comment> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_STFEHLERYX" id="bm_id3150964" localize="false"/> +<h2 id="hd_id3155836">STEYX</h2> + <paragraph xml-lang="en-US" id="par_id3149446" role="paragraph"><ahelp hid="HID_FUNC_STFEHLERYX">Returns the standard error of the predicted y value for each x in the regression.</ahelp></paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph xml-lang="en-US" id="par_id3151267" role="code">STEYX(DataY; DataX)</paragraph> + <paragraph xml-lang="en-US" id="par_id3147313" role="paragraph"> + <emph>DataY</emph> is the array or matrix of Y data.</paragraph> + <paragraph xml-lang="en-US" id="par_id3156097" role="paragraph"> + <emph>DataX</emph> is the array or matrix of X data.</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph xml-lang="en-US" id="par_id3156131" role="paragraph"> + <item type="input">=STEYX(A1:A50;B1:B50)</item> + </paragraph> + </section> + <section id="devsq"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3150873"><bookmark_value>DEVSQ function</bookmark_value> + <bookmark_value>sums;of squares of deviations</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_SUMQUADABW" id="bm_id3156317" localize="false"/> +<h2 id="hd_id3150873">DEVSQ</h2> + <paragraph xml-lang="en-US" id="par_id3154748" role="paragraph"><ahelp hid="HID_FUNC_SUMQUADABW">Returns the sum of squares of deviations based on a sample mean.</ahelp></paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph xml-lang="en-US" id="par_id3146790" role="code">DEVSQ(<embedvar href="text/scalc/01/ful_func.xhp#number255_1" markup="keep"/>)</paragraph> + <embed href="text/scalc/01/ful_func.xhp#number255"/> + <embed href="text/scalc/01/common_func.xhp#datenumbersequencenote"/> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph xml-lang="en-US" id="par_id3149136" role="paragraph"> + <item type="input">=DEVSQ(A1:A50)</item> + </paragraph> + </section> + <section id="tinv"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3149579"><bookmark_value>TINV function</bookmark_value> + <bookmark_value>inverse of t-distribution</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_TINV" id="bm_id3153155" localize="false"/> +<h2 id="hd_id3149579">TINV</h2> + <paragraph xml-lang="en-US" id="par_id3143232" role="paragraph"><ahelp hid="HID_FUNC_TINV">Returns the inverse of the t-distribution.</ahelp></paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph xml-lang="en-US" id="par_id3149289" role="code">TINV(Number; DegreesFreedom)</paragraph> + <paragraph xml-lang="en-US" id="par_id3154070" role="paragraph"> + <emph>Number</emph> is the probability associated with the two-tailed t-distribution.</paragraph> + <paragraph xml-lang="en-US" id="par_id3155315" role="paragraph"> + <emph>DegreesFreedom</emph> is the number of degrees of freedom for the t-distribution.</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph xml-lang="en-US" id="par_id3156010" role="paragraph"> + <item type="input">=TINV(0.1;6)</item> returns 1.94</paragraph> + </section> +<section id="tdotinv"> + <bookmark xml-lang="en-US" branch="index" id="bm_id2949579"> + <bookmark_value>T.INV function</bookmark_value> + <bookmark_value>one tailed inverse of t-distribution</bookmark_value> + </bookmark> + <bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_TINV_MS" id="bm_id2953155" localize="false"/> + <h2 id="hd_id2949579">T.INV</h2> + <paragraph xml-lang="en-US" id="par_id2943232" role="paragraph"><ahelp hid="HID_FUNC_TINV_MS">Returns the one tailed inverse of the t-distribution.</ahelp></paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph xml-lang="en-US" id="par_id2949289" role="code">T.INV(Number; DegreesFreedom)</paragraph> + <paragraph xml-lang="en-US" id="par_id2954070" role="paragraph"><emph>Number</emph> is the probability associated with the one-tailed t-distribution.</paragraph> + <paragraph xml-lang="en-US" id="par_id2955315" role="paragraph"><emph>DegreesFreedom</emph> is the number of degrees of freedom for the t-distribution.</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph xml-lang="en-US" id="par_id2956010" role="paragraph"><item type="input">=T.INV(0.1;6)</item> returns -1.4397557473.</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectiontechinfo"/> + <embed href="text/scalc/00/avail_release.xhp#4.3"/> + <embed href="text/scalc/01/common_func.xhp#notODFF"/> + <paragraph role="paragraph" id="par_id341000873986703" localize="false"><literal>COM.MICROSOFT.T.INV</literal></paragraph> +</section> +<section id="tdotinvdot2t"> + <bookmark xml-lang="en-US" branch="index" id="bm_id2849579"> + <bookmark_value>T.INV.2T function</bookmark_value> + <bookmark_value>inverse of two tailed t-distribution</bookmark_value> + </bookmark> + <bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_TINV_2T" id="bm_id2853155" localize="false"/> + <h2 id="hd_id2849579">T.INV.2T</h2> + <paragraph xml-lang="en-US" id="par_id2843232" role="paragraph"><ahelp hid="HID_FUNC_TINV_2T">Calculates the inverse of the two-tailed Student's T Distribution </ahelp>, which is a continuous probability distribution that is frequently used for testing hypotheses on small sample data sets.</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph xml-lang="en-US" id="par_id2849289" role="code">T.INV.2T(Number; DegreesFreedom)</paragraph> + <paragraph xml-lang="en-US" id="par_id2854070" role="paragraph"><emph>Number</emph> is the probability associated with the two-tailed t-distribution.</paragraph> + <paragraph xml-lang="en-US" id="par_id2855315" role="paragraph"><emph>DegreesFreedom</emph> is the number of degrees of freedom for the t-distribution.</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph xml-lang="en-US" id="par_id2856010" role="paragraph"><item type="input">=T.INV.2T(0.25; 10)</item> returns 1.221255395.</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectiontechinfo"/> + <embed href="text/scalc/00/avail_release.xhp#4.3"/> + <embed href="text/scalc/01/common_func.xhp#notODFF"/> + <paragraph role="paragraph" id="par_id341640873986003" localize="false"><literal>COM.MICROSOFT.T.INV.2T</literal></paragraph> +</section> + <section id="ttest"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3154129"><bookmark_value>TTEST function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_TTEST" id="bm_id3153981" localize="false"/> +<h2 id="hd_id3154129">TTEST</h2> + <paragraph xml-lang="en-US" id="par_id3159184" role="paragraph"><ahelp hid="HID_FUNC_TTEST">Returns the probability associated with a Student's t-Test.</ahelp></paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph xml-lang="en-US" id="par_id3151175" role="code">TTEST(Data1; Data2; Mode; Type)</paragraph> + <paragraph xml-lang="en-US" id="par_id3149202" role="paragraph"> + <emph>Data1</emph> is the dependent array or range of data for the first record.</paragraph> + <paragraph xml-lang="en-US" id="par_id3145666" role="paragraph"> + <emph>Data2</emph> is the dependent array or range of data for the second record.</paragraph> + <paragraph xml-lang="en-US" id="par_id3153903" role="paragraph"> + <emph>Mode</emph> = 1 calculates the one-tailed test, <emph>Mode</emph> = 2 the two- tailed test.</paragraph> + <paragraph xml-lang="en-US" id="par_id3155327" role="paragraph"> + <emph>Type</emph> is the kind of t-test to perform. Type 1 means paired. Type 2 means two samples, equal variance (homoscedastic). Type 3 means two samples, unequal variance (heteroscedastic).</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph xml-lang="en-US" id="par_id3150119" role="paragraph"> + <item type="input">=TTEST(A1:A50;B1:B50;2;2)</item> + </paragraph> + </section> +<section id="tdottest"> + <bookmark xml-lang="en-US" branch="index" id="bm_id2954129"> + <bookmark_value>T.TEST function</bookmark_value> + </bookmark> + <bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_TTEST_MS" id="bm_id2953981" localize="false"/> + <h2 id="hd_id2954129">T.TEST</h2> + <paragraph xml-lang="en-US" id="par_id2959184" role="paragraph"><ahelp hid="HID_FUNC_TTEST_MS">Returns the probability associated with a Student's t-Test.</ahelp></paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph xml-lang="en-US" id="par_id2951175" role="code">T.TEST(Data1; Data2; Mode; Type)</paragraph> + <paragraph xml-lang="en-US" id="par_id2949202" role="paragraph"><emph>Data1</emph> is the dependent array or range of data for the first record.</paragraph> + <paragraph xml-lang="en-US" id="par_id2945666" role="paragraph"><emph>Data2</emph> is the dependent array or range of data for the second record.</paragraph> + <paragraph xml-lang="en-US" id="par_id2953903" role="paragraph"><emph>Mode</emph> = 1 calculates the one-tailed test, <emph>Mode</emph> = 2 the two- tailed test.</paragraph> + <paragraph xml-lang="en-US" id="par_id2955327" role="paragraph"><emph>Type</emph> is the kind of t-test to perform. Type 1 means paired. Type 2 means two samples, equal variance (homoscedastic). Type 3 means two samples, unequal variance (heteroscedastic).</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph xml-lang="en-US" id="par_id2950119" role="paragraph"><item type="input">=T.TEST(A1:A50;B1:B50;2;2)</item></paragraph> + <embed href="text/scalc/01/common_func.xhp#sectiontechinfo"/> + <embed href="text/scalc/00/avail_release.xhp#4.3"/> + <embed href="text/scalc/01/common_func.xhp#notODFF"/> + <paragraph role="paragraph" id="par_id341640844986703" localize="false"><literal>COM.MICROSOFT.T.TEST</literal></paragraph> +</section> + <section id="tdist"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3154930"><bookmark_value>TDIST function</bookmark_value> + <bookmark_value>t-distribution</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_TVERT" id="bm_id3153095" localize="false"/> +<h2 id="hd_id3154930">TDIST</h2> + <paragraph xml-lang="en-US" id="par_id3153372" role="paragraph"><ahelp hid="HID_FUNC_TVERT">Returns the t-distribution.</ahelp></paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph xml-lang="en-US" id="par_id3150521" role="code">TDIST(Number; DegreesFreedom; Mode)</paragraph> + <paragraph xml-lang="en-US" id="par_id3146991" role="paragraph"> + <emph>Number</emph> is the value for which the t-distribution is calculated.</paragraph> + <paragraph xml-lang="en-US" id="par_id3148824" role="paragraph"> + <emph>DegreesFreedom</emph> is the number of degrees of freedom for the t-distribution.</paragraph> + <paragraph xml-lang="en-US" id="par_id3149340" role="paragraph"> + <emph>Mode</emph> = 1 returns the one-tailed test, <emph>Mode</emph> = 2 returns the two-tailed test.</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph xml-lang="en-US" id="par_id3149773" role="paragraph"> + <item type="input">=TDIST(12;5;1)</item> + </paragraph> + </section> +<section id="tdotdist"> + <bookmark xml-lang="en-US" branch="index" id="bm_id2954930"> + <bookmark_value>T.DIST function</bookmark_value> + <bookmark_value>t-distribution</bookmark_value> + </bookmark> + <bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_TDIST_MS" id="bm_id2953095" localize="false"/> + <h2 id="hd_id2954930">T.DIST</h2> + <paragraph xml-lang="en-US" id="par_id2953372" role="paragraph"><ahelp hid="HID_FUNC_TDIST_MS">Returns the t-distribution.</ahelp></paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph xml-lang="en-US" id="par_id2950521" role="code">T.DIST(Number; DegreesFreedom; Cumulative)</paragraph> + <paragraph xml-lang="en-US" id="par_id2946991" role="paragraph"><emph>Number</emph> is the value for which the t-distribution is calculated.</paragraph> + <paragraph xml-lang="en-US" id="par_id2948824" role="paragraph"><emph>DegreesFreedom</emph> is the number of degrees of freedom for the t-distribution.</paragraph> + <paragraph xml-lang="en-US" id="par_id2949340" role="paragraph"><emph>Cumulative</emph> = 0 or FALSE returns the probability density function, 1 or TRUE returns the cumulative distribution function.</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph xml-lang="en-US" id="par_id2949773" role="paragraph"><item type="input">=T.DIST(1; 10; TRUE)</item> returns 0.8295534338</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectiontechinfo"/> + <embed href="text/scalc/00/avail_release.xhp#4.3"/> + <embed href="text/scalc/01/common_func.xhp#notODFF"/> + <paragraph role="paragraph" id="par_id341330873986703" localize="false"><literal>COM.MICROSOFT.T.DIST</literal></paragraph> +</section> +<section id="tdotdistdot2t"> + <bookmark xml-lang="en-US" branch="index" id="bm_id2854930"> + <bookmark_value>T.DIST.2T function</bookmark_value> + <bookmark_value>two tailed t-distribution</bookmark_value> + </bookmark> + <bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_TDIST_2T" id="bm_id2853095" localize="false"/> + <h2 id="hd_id2854930">T.DIST.2T</h2> + <paragraph xml-lang="en-US" id="par_id2853372" role="paragraph"><ahelp hid="HID_FUNC_TDIST_2T">Calculates the two-tailed Student's T Distribution, which is a continuous probability distribution that is frequently used for testing hypotheses on small sample data sets.</ahelp></paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph xml-lang="en-US" id="par_id2850521" role="code">T.DIST.2T(Number; DegreesFreedom)</paragraph> + <paragraph xml-lang="en-US" id="par_id2846991" role="paragraph"><emph>Number</emph> is the value for which the t-distribution is calculated.</paragraph> + <paragraph xml-lang="en-US" id="par_id2848824" role="paragraph"><emph>DegreesFreedom</emph> is the number of degrees of freedom for the t-distribution.</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph xml-lang="en-US" id="par_id2849773" role="paragraph"><item type="input">=T.DIST.2T(1; 10)</item> returns 0.3408931323.</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectiontechinfo"/> + <embed href="text/scalc/00/avail_release.xhp#4.3"/> + <embed href="text/scalc/01/common_func.xhp#notODFF"/> + <paragraph role="paragraph" id="par_id341655873986703" localize="false"><literal>COM.MICROSOFT.T.DIST.2T</literal></paragraph> +</section> +<section id="tdotdistdotrt"> + <bookmark xml-lang="en-US" branch="index" id="bm_id274930"> + <bookmark_value>T.DIST.RT function</bookmark_value> + <bookmark_value>right tailed t-distribution</bookmark_value> + </bookmark> + <bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_TDIST_RT" id="bm_id273095" localize="false"/> + <h2 id="hd_id274930">T.DIST.RT</h2> + <paragraph xml-lang="en-US" id="par_id2753372" role="paragraph"><ahelp hid="HID_FUNC_TDIST_RT">Calculates the right-tailed Student's T Distribution, which is a continuous probability distribution that is frequently used for testing hypotheses on small sample data sets.</ahelp></paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph xml-lang="en-US" id="par_id2750521" role="code">T.DIST.RT(Number; DegreesFreedom)</paragraph> + <paragraph xml-lang="en-US" id="par_id2746991" role="paragraph"><emph>Number</emph> is the value for which the t-distribution is calculated.</paragraph> + <paragraph xml-lang="en-US" id="par_id2748824" role="paragraph"><emph>DegreesFreedom</emph> is the number of degrees of freedom for the t-distribution.</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph xml-lang="en-US" id="par_id2749773" role="paragraph"><item type="input">=T.DIST.RT(1; 10)</item> returns 0.1704465662.</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectiontechinfo"/> + <embed href="text/scalc/00/avail_release.xhp#4.3"/> + <embed href="text/scalc/01/common_func.xhp#notODFF"/> + <paragraph role="paragraph" id="par_id341640873911703" localize="false"><literal>COM.MICROSOFT.T.DIST.RT</literal></paragraph> +</section> + <section id="var"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3153828"><bookmark_value>VAR function</bookmark_value> + <bookmark_value>variances</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_VARIANZ" id="bm_id3154898" localize="false"/> +<h2 id="hd_id3153828">VAR</h2> + <paragraph xml-lang="en-US" id="par_id3159165" role="paragraph"><ahelp hid="HID_FUNC_VARIANZ">Estimates the variance based on a sample.</ahelp></paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + + <paragraph xml-lang="en-US" id="par_id3153054" role="code">VAR(<embedvar href="text/scalc/01/ful_func.xhp#number255_1" markup="keep"/>)</paragraph> + <embed href="text/scalc/01/ful_func.xhp#number255"/> + <paragraph id="par_id721585215582420" role="paragraph" xml-lang="en-US">The parameters should specify at least two values.</paragraph> + <embed href="text/scalc/01/common_func.xhp#datenumbersequencenote"/> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph xml-lang="en-US" id="par_id3153575" role="paragraph"> + <item type="input">=VAR(A1:A50)</item> + </paragraph> + </section> +<section id="vardots"> + <bookmark xml-lang="en-US" branch="index" id="bm_id2953828"> + <bookmark_value>VAR.S function</bookmark_value> + <bookmark_value>variances</bookmark_value> + </bookmark> + <bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_VAR_S" id="bm_id2954898" localize="false"/> + <h2 id="hd_id2953828">VAR.S</h2> + <paragraph xml-lang="en-US" id="par_id2959165" role="paragraph"><ahelp hid="HID_FUNC_VAR_S">Estimates the variance based on a sample.</ahelp></paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph xml-lang="en-US" id="par_id2953054" role="code">VAR.S(<embedvar href="text/scalc/01/ful_func.xhp#number255_1" markup="keep"/>)</paragraph> + <embed href="text/scalc/01/ful_func.xhp#number255"/> + <paragraph id="par_id891585215590756" role="paragraph" xml-lang="en-US">The parameters should specify at least two values.</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph xml-lang="en-US" id="par_id2953575" role="paragraph"><item type="input">=VAR.S(A1:A50)</item></paragraph> + <embed href="text/scalc/01/common_func.xhp#sectiontechinfo"/> + <embed href="text/scalc/00/avail_release.xhp#4.2"/> + <embed href="text/scalc/01/common_func.xhp#notODFF"/> + <paragraph role="paragraph" id="par_id111640873986703" localize="false"><literal>COM.MICROSOFT.VAR.S</literal></paragraph> +</section> + <section id="vara"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3151045"><bookmark_value>VARA function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_VARIANZA" id="bm_id3148473" localize="false"/> +<h2 id="hd_id3151045">VARA</h2> + <paragraph xml-lang="en-US" id="par_id3155122" role="paragraph"><ahelp hid="HID_FUNC_VARIANZA">Estimates a variance based on a sample. The value of text is 0.</ahelp></paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph xml-lang="en-US" id="par_id3149999" role="code">VARA(<embedvar href="text/scalc/01/ful_func.xhp#number255_1" markup="keep"/>)</paragraph> + <embed href="text/scalc/01/ful_func.xhp#number255"/> + <paragraph id="par_id451585215586628" role="paragraph" xml-lang="en-US">The parameters should specify at least two values.</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph xml-lang="en-US" id="par_id3154279" role="paragraph"> + <item type="input">=VARA(A1:A50)</item> + </paragraph> + </section> + <section id="varp"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3166441"><bookmark_value>VARP function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_VARIANZEN" id="bm_id3152359" localize="false"/> +<h2 id="hd_id3166441">VARP</h2> + <paragraph xml-lang="en-US" id="par_id3159199" role="paragraph"><ahelp hid="HID_FUNC_VARIANZEN">Calculates a variance based on the entire population.</ahelp></paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph xml-lang="en-US" id="par_id3147282" role="code">VARP(<embedvar href="text/scalc/01/ful_func.xhp#number255_1" markup="keep"/>)</paragraph> + <embed href="text/scalc/01/ful_func.xhp#number255"/> + <embed href="text/scalc/01/common_func.xhp#datenumbersequencenote"/> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph xml-lang="en-US" id="par_id3153385" role="paragraph"> + <item type="input">=VARP(A1:A50)</item> + </paragraph> + </section> +<section id="vardotp"> + <bookmark xml-lang="en-US" branch="index" id="bm_id2966441"> + <bookmark_value>VAR.P function</bookmark_value> + </bookmark> + <bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_VAR_P_MS" id="bm_id2952359" localize="false"/> + <h2 id="hd_id2966441">VAR.P</h2> + <paragraph xml-lang="en-US" id="par_id2959199" role="paragraph"><ahelp hid="HID_FUNC_VAR_P_MS">Calculates a variance based on the entire population.</ahelp></paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph xml-lang="en-US" id="par_id2947282" role="code">VAR.P(<embedvar href="text/scalc/01/ful_func.xhp#number255_1" markup="keep"/>)</paragraph> + <embed href="text/scalc/01/ful_func.xhp#number255"/> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph xml-lang="en-US" id="par_id2953385" role="paragraph"><item type="input">=VAR.P(A1:A50)</item></paragraph> + <embed href="text/scalc/01/common_func.xhp#sectiontechinfo"/> + <embed href="text/scalc/00/avail_release.xhp#4.2"/> + <embed href="text/scalc/01/common_func.xhp#notODFF"/> + <paragraph role="paragraph" id="par_id341640873933703" localize="false"><literal>COM.MICROSOFT.VAR.P</literal></paragraph> +</section> + <section id="varpa"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3153688"><bookmark_value>VARPA function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_VARIANZENA" id="bm_id3159276" localize="false"/> +<h2 id="hd_id3153688">VARPA</h2> + <paragraph xml-lang="en-US" id="par_id3149109" role="paragraph"><ahelp hid="HID_FUNC_VARIANZENA">Calculates the variance based on the entire population. The value of text is 0.</ahelp></paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph xml-lang="en-US" id="par_id3149967" role="code">VARPA(<embedvar href="text/scalc/01/ful_func.xhp#number255_1" markup="keep"/>)</paragraph> + <embed href="text/scalc/01/ful_func.xhp#number255"/> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph xml-lang="en-US" id="par_id3156203" role="paragraph"> + <item type="input">=VARPA(A1:A50)</item> + </paragraph> + </section> + <section id="permut"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3154599"><bookmark_value>PERMUT function</bookmark_value> + <bookmark_value>number of permutations</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_VARIATIONEN" id="bm_id3154610" localize="false"/> +<h2 id="hd_id3154599">PERMUT</h2> + <paragraph xml-lang="en-US" id="par_id3154334" role="paragraph"><ahelp hid="HID_FUNC_VARIATIONEN">Returns the number of permutations for a given number of objects.</ahelp></paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph xml-lang="en-US" id="par_id3148466" role="code">PERMUT(Count1; Count2)</paragraph> + <paragraph xml-lang="en-US" id="par_id3148656" role="paragraph"> + <emph>Count1</emph> is the total number of objects.</paragraph> + <paragraph xml-lang="en-US" id="par_id3150826" role="paragraph"> + <emph>Count2</emph> is the number of objects in each permutation.</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph xml-lang="en-US" id="par_id3150424" role="paragraph"> + <item type="input">=PERMUT(6;3)</item> returns 120. There are 120 different possibilities, to pick a sequence of 3 playing cards out of 6 playing cards.</paragraph> + </section> + <section id="permutationa"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3143276"><bookmark_value>PERMUTATIONA function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_VARIATIONEN2" id="bm_id3153531" localize="false"/> +<h2 id="hd_id3143276">PERMUTATIONA</h2> + <paragraph xml-lang="en-US" id="par_id3144759" role="paragraph"><ahelp hid="HID_FUNC_VARIATIONEN2">Returns the number of permutations for a given number of objects (repetition allowed).</ahelp></paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph xml-lang="en-US" id="par_id3149298" role="code">PERMUTATIONA(Count1; Count2)</paragraph> + <paragraph xml-lang="en-US" id="par_id3156139" role="paragraph"> + <emph>Count1</emph> is the total number of objects.</paragraph> + <paragraph xml-lang="en-US" id="par_id3149519" role="paragraph"> + <emph>Count2</emph> is the number of objects in each permutation.</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph xml-lang="en-US" id="par_id3153949" role="paragraph">How often can 2 objects be selected from a total of 11 objects?</paragraph> + <paragraph xml-lang="en-US" id="par_id3149233" role="paragraph"> + <item type="input">=PERMUTATIONA(11;2)</item> returns 121.</paragraph> + <paragraph xml-lang="en-US" id="par_id3150622" role="paragraph"> + <item type="input">=PERMUTATIONA(6;3)</item> returns 216. There are 216 different possibilities to put a sequence of 3 playing cards together out of six playing cards if every card is returned before the next one is drawn.</paragraph> + </section> + <section id="prob"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3152952"><bookmark_value>PROB function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_WAHRSCHBEREICH" id="bm_id3152963" localize="false"/> +<h2 id="hd_id3152952">PROB</h2> + <paragraph xml-lang="en-US" id="par_id3154110" role="paragraph"><ahelp hid="HID_FUNC_WAHRSCHBEREICH">Returns the probability that values in a range are between two limits.</ahelp> If there is no <item type="literal">End</item> value, this function calculates the probability based on the principle that the Data values are equal to the value of <item type="literal">Start</item>.</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph xml-lang="en-US" id="par_id3147330" role="code">PROB(Data; Probability; Start [; End])</paragraph> + <paragraph xml-lang="en-US" id="par_id3154573" role="paragraph"> + <emph>Data</emph> is the array or range of data in the sample.</paragraph> + <paragraph xml-lang="en-US" id="par_id3156334" role="paragraph"> + <emph>Probability</emph> is the array or range of the corresponding probabilities.</paragraph> + <paragraph xml-lang="en-US" id="par_id3151107" role="paragraph"> + <emph>Start</emph> is the start value of the interval whose probabilities are to be summed.</paragraph> + <paragraph xml-lang="en-US" id="par_id3153694" role="paragraph"> + <emph>End</emph> (optional) is the end value of the interval whose probabilities are to be summed. If this parameter is missing, the probability for the <emph>Start</emph> value is calculated.</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph xml-lang="en-US" id="par_id3153666" role="paragraph"> + <item type="input">=PROB(A1:A50;B1:B50;50;60)</item> returns the probability with which a value within the range of A1:A50 is also within the limits between 50 and 60. Every value within the range of A1:A50 has a probability within the range of B1:B50.</paragraph> + </section> + <section id="weibull"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3150941"><bookmark_value>WEIBULL function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_WEIBULL" id="bm_id3150405" localize="false"/> +<h2 id="hd_id3150941">WEIBULL</h2> + <paragraph xml-lang="en-US" id="par_id3154916" role="paragraph"><ahelp hid="HID_FUNC_WEIBULL">Returns the values of the Weibull distribution.</ahelp></paragraph> + <paragraph xml-lang="en-US" id="par_id0305200911372767" role="paragraph">The Weibull distribution is a continuous probability distribution, with parameters Alpha > 0 (shape) and Beta > 0 (scale).</paragraph> + <paragraph xml-lang="en-US" id="par_id0305200911372777" role="paragraph">If C is 0, WEIBULL calculates the probability density function.</paragraph> + <paragraph xml-lang="en-US" id="par_id0305200911372743" role="paragraph">If C is 1, WEIBULL calculates the cumulative distribution function.</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph xml-lang="en-US" id="par_id3154478" role="code">WEIBULL(Number; Alpha; Beta; C)</paragraph> + <paragraph xml-lang="en-US" id="par_id3151317" role="paragraph"> + <emph>Number</emph> is the value at which to calculate the Weibull distribution.</paragraph> + <paragraph xml-lang="en-US" id="par_id3158436" role="paragraph"> + <emph>Alpha </emph>is the shape parameter of the Weibull distribution.</paragraph> + <paragraph xml-lang="en-US" id="par_id3154668" role="paragraph"> + <emph>Beta</emph> is the scale parameter of the Weibull distribution.</paragraph> + <paragraph xml-lang="en-US" id="par_id3154825" role="paragraph"> + <emph>C</emph> indicates the type of function.</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph xml-lang="en-US" id="par_id3146077" role="paragraph"> + <item type="input">=WEIBULL(2;1;1;1)</item> returns 0.86.</paragraph> + <paragraph xml-lang="en-US" id="par_id0305200911372899" role="paragraph">See also the <link href="https://wiki.documentfoundation.org/Documentation/How_Tos/Calc:_WEIBULL_function" name="wiki.documentfoundation.org Documentation/HowTo/Calc/WEIBULL function">Wiki page</link>.</paragraph> + </section> +<section id="weibulldotdist"> + <bookmark xml-lang="en-US" branch="index" id="bm_id2950941"> + <bookmark_value>WEIBULL.DIST function</bookmark_value> + </bookmark> + <bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_WEIBULL_DIST_MS" id="bm_id3150406" localize="false"/> + <h2 id="hd_id2950941">WEIBULL.DIST</h2> + <paragraph xml-lang="en-US" id="par_id2954916" role="paragraph"><ahelp hid="HID_FUNC_WEIBULL_DIST_MS">Returns the values of the Weibull distribution.</ahelp></paragraph> + <paragraph xml-lang="en-US" id="par_id2905200911372767" role="paragraph">The Weibull distribution is a continuous probability distribution, with parameters Alpha > 0 (shape) and Beta > 0 (scale). </paragraph> + <paragraph xml-lang="en-US" id="par_id2905200911372777" role="paragraph">If C is 0, WEIBULL.DIST calculates the probability density function.</paragraph> + <paragraph xml-lang="en-US" id="par_id2905200911372743" role="paragraph">If C is 1, WEIBULL.DIST calculates the cumulative distribution function.</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph xml-lang="en-US" id="par_id2954478" role="code">WEIBULL.DIST(Number; Alpha; Beta; C)</paragraph> + <paragraph xml-lang="en-US" id="par_id2951317" role="paragraph"><emph>Number</emph> is the value at which to calculate the Weibull distribution.</paragraph> + <paragraph xml-lang="en-US" id="par_id2958436" role="paragraph"><emph>Alpha </emph>is the shape parameter of the Weibull distribution.</paragraph> + <paragraph xml-lang="en-US" id="par_id2954668" role="paragraph"><emph>Beta</emph> is the scale parameter of the Weibull distribution.</paragraph> + <paragraph xml-lang="en-US" id="par_id2954825" role="paragraph"><emph>C</emph> indicates the type of function.</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph xml-lang="en-US" id="par_id2946077" role="paragraph"><item type="input">=WEIBULL.DIST(2;1;1;1)</item> returns 0.8646647168.</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectiontechinfo"/> + <embed href="text/scalc/00/avail_release.xhp#4.2"/> + <paragraph xml-lang="en-US" id="par_id2905200911372899" role="paragraph">See also the <link href="https://wiki.documentfoundation.org/Documentation/How_Tos/Calc:_WEIBULL_function" name="wiki.documentfoundation.org Documentation/HowTo/Calc/WEIBULL function">Wiki page</link>.</paragraph> + <embed href="text/scalc/01/common_func.xhp#notODFF"/> + <paragraph role="paragraph" id="par_id341640873977703" localize="false"><literal>COM.MICROSOFT.WEIBULL.DIST</literal></paragraph> +</section> +</sort> +<section id="relatedtopics"> + <embed href="text/scalc/01/04060100.xhp#drking"/> + </section> + </body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/04060199.xhp b/helpcontent2/source/text/scalc/01/04060199.xhp new file mode 100644 index 000000000..b30def43f --- /dev/null +++ b/helpcontent2/source/text/scalc/01/04060199.xhp @@ -0,0 +1,297 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . + --> +<helpdocument version="1.0"> +<meta> +<topic id="textscalc0104060199xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Operators in $[officename] Calc</title> +<filename>/text/scalc/01/04060199.xhp</filename> +</topic> +</meta> +<body> +<bookmark xml-lang="en-US" branch="index" id="bm_id3156445"><bookmark_value>formulas; operators</bookmark_value> +<bookmark_value>operators; formula functions</bookmark_value> +<bookmark_value>division sign, see also operators</bookmark_value> +<bookmark_value>multiplication sign, see also operators</bookmark_value> +<bookmark_value>minus sign, see also operators</bookmark_value> +<bookmark_value>plus sign, see also operators</bookmark_value> +<bookmark_value>text operators</bookmark_value> +<bookmark_value>comparisons;operators in Calc</bookmark_value> +<bookmark_value>arithmetical operators</bookmark_value> +<bookmark_value>reference operators</bookmark_value> +</bookmark><comment>mw added 7 new index entries</comment><h1 id="hd_id3156445">Operators in $[officename] Calc</h1> +<paragraph role="paragraph" id="par_id3155812" xml-lang="en-US">You can use the following operators in $[officename] Calc:</paragraph> +<h2 id="hd_id3153066">Arithmetical Operators</h2> +<paragraph role="paragraph" id="par_id3148601" xml-lang="en-US">These operators return numerical results.</paragraph> +<table id="tbl_id3151240"> +<tablerow> +<tablecell> +<paragraph role="tablehead" id="par_id3144768" xml-lang="en-US">Operator</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablehead" id="par_id3157982" xml-lang="en-US">Name</paragraph> +</tablecell> +<tablecell> + <paragraph role="tablehead" id="par_id401599494815994">Example</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph role="tablecontent" id="par_id3149126" xml-lang="en-US">+ (Plus)</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablecontent" id="par_id3150892" xml-lang="en-US">Addition</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablecontent" id="par_id3153247" localize="false" xml-lang="en-US">1+1</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph role="tablecontent" id="par_id3159204" xml-lang="en-US">- (Minus)</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablecontent" id="par_id3145362" xml-lang="en-US">Subtraction</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablecontent" id="par_id3153554" localize="false" xml-lang="en-US">2-1</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph role="tablecontent" id="par_id3153808" xml-lang="en-US">- (Minus)</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablecontent" id="par_id3151193" xml-lang="en-US">Negation</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablecontent" id="par_id3154712" localize="false" xml-lang="en-US">-5</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph role="tablecontent" id="par_id3149873" xml-lang="en-US">* (asterisk)</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablecontent" id="par_id3147504" xml-lang="en-US">Multiplication</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablecontent" id="par_id3149055" localize="false" xml-lang="en-US">2*2</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph role="tablecontent" id="par_id3151341" xml-lang="en-US">/ (Slash)</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablecontent" id="par_id3159260" xml-lang="en-US">Division</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablecontent" id="par_id3153027" localize="false" xml-lang="en-US">9/3</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph role="tablecontent" id="par_id3156396" xml-lang="en-US">% (Percent)</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablecontent" id="par_id3150372" xml-lang="en-US">Percent</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablecontent" id="par_id3145632" localize="false" xml-lang="en-US">15%</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph role="tablecontent" id="par_id3149722" xml-lang="en-US">^ (Caret)</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablecontent" id="par_id3159127" xml-lang="en-US">Exponentiation</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablecontent" id="par_id3157873" localize="false" xml-lang="en-US">3^2</paragraph> +</tablecell> +</tablerow> +</table> + +<note id="par_id881623862728559">Prefix "-" (negation) has a higher precedence than "^" (exponentiation). For example -3^2 equals 9, which is the square of a negative number.</note> + +<h2 id="hd_id3152981">Comparative operators</h2> +<paragraph role="paragraph" id="par_id3157902" xml-lang="en-US">These operators return either true or false.</paragraph> +<table id="tbl_id3148725"> +<tablerow> +<tablecell> +<paragraph role="tablehead" id="par_id3149889" xml-lang="en-US">Operator</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablehead" id="par_id3150743" xml-lang="en-US">Name</paragraph> +</tablecell> +<tablecell> + <paragraph role="tablehead" id="par_id201599495083374">Example</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph role="tablecontent" id="par_id3148888" xml-lang="en-US">= (equal sign)</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablecontent" id="par_id3154845" xml-lang="en-US">Equal</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablecontent" id="par_id3154546" localize="false" xml-lang="en-US">A1=B1</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph role="tablecontent" id="par_id3154807" xml-lang="en-US">> (Greater than)</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablecontent" id="par_id3148580" xml-lang="en-US">Greater than</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablecontent" id="par_id3145138" localize="false" xml-lang="en-US">A1>B1</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph role="tablecontent" id="par_id3149507" xml-lang="en-US">< (Less than)</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablecontent" id="par_id3150145" xml-lang="en-US">Less than</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablecontent" id="par_id3150901" localize="false" xml-lang="en-US">A1<B1</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph role="tablecontent" id="par_id3153078" xml-lang="en-US">>= (Greater than or equal to)</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablecontent" id="par_id3150866" xml-lang="en-US">Greater than or equal to</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablecontent" id="par_id3153111" localize="false" xml-lang="en-US">A1>=B1</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph role="tablecontent" id="par_id3153004" xml-lang="en-US"><= (Less than or equal to)</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablecontent" id="par_id3150335" xml-lang="en-US">Less than or equal to</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablecontent" id="par_id3148760" localize="false" xml-lang="en-US">A1<=B1</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph role="tablecontent" id="par_id3157994" xml-lang="en-US"><> (Inequality)</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablecontent" id="par_id3150019" xml-lang="en-US">Inequality</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablecontent" id="par_id3149878" localize="false" xml-lang="en-US">A1<>B1</paragraph> +</tablecell> +</tablerow> +</table> +<h2 id="hd_id3145241">Text operators</h2> +<paragraph role="paragraph" id="par_id3155438" xml-lang="en-US">The operator combines separate texts into one text.</paragraph> +<table id="tbl_id3156061"> +<tablerow> +<tablecell> +<paragraph role="tablehead" id="par_id3150566" xml-lang="en-US">Operator</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablehead" id="par_id3153048" xml-lang="en-US">Name</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablehead" id="par_id201599494708332">Example</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph role="tablecontent" id="par_id3148769" xml-lang="en-US">& (And)</paragraph> +</tablecell> +<tablecell> +<bookmark xml-lang="en-US" branch="index" id="bm_id3157975"><bookmark_value>text concatenation AND</bookmark_value> +</bookmark> +<paragraph role="tablecontent" id="par_id3157975" xml-lang="en-US">text concatenation AND</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablecontent" id="par_id3157993" xml-lang="en-US">"Sun" & "day" is "Sunday"</paragraph> +</tablecell> +</tablerow> +</table> +<h2 id="hd_id3153550">Reference operators</h2> +<paragraph role="paragraph" id="par_id3149024" xml-lang="en-US">These operators return a cell range of zero, one or more cells.</paragraph> +<paragraph role="paragraph" id="par_id2324900" xml-lang="en-US">Range has the highest precedence, then intersection, and then finally union.</paragraph> +<table id="tbl_id3154633"> +<tablerow> +<tablecell> +<paragraph role="tablehead" id="par_id3158416" xml-lang="en-US">Operator</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablehead" id="par_id3152822" xml-lang="en-US">Name</paragraph> +</tablecell> +<tablecell> + <paragraph role="tablehead" id="par_id521599494740206">Example</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph role="tablecontent" id="par_id3156257" xml-lang="en-US">: (Colon)</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablecontent" id="par_id3153924" xml-lang="en-US">Range</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablecontent" id="par_id3148432" localize="false" xml-lang="en-US">A1:C108</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph role="tablecontent" id="par_id3152592" xml-lang="en-US">! (Exclamation point)</paragraph> +</tablecell> +<tablecell> +<bookmark xml-lang="en-US" branch="index" id="bm_id3150606"><bookmark_value>intersection operator</bookmark_value> +</bookmark> +<paragraph role="tablecontent" id="par_id3150606" xml-lang="en-US">Intersection</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablecontent" id="par_id3083445" xml-lang="en-US">SUM(A1:B6!B5:C12)</paragraph> +<paragraph role="tablecontent" id="par_id3150385" xml-lang="en-US">Calculates the sum of all cells in the intersection; in this example, the result yields the sum of cells B5 and B6.</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph role="tablecontent" id="par_id4003723" xml-lang="en-US">~ (Tilde)</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablecontent" id="par_id838953" xml-lang="en-US">Concatenation or union</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablecontent" id="par_id2511978" xml-lang="en-US">Takes two references and returns a reference list, which is a concatenation of the left reference followed by the right reference. Double entries are referenced twice. See note below this table.</paragraph> +</tablecell> +</tablerow> +</table> +<note id="par_id181890">Reference concatenation using a tilde character was implemented lately. When a formula with the tilde operator exists in a document that is opened in old versions of the software, an error is returned. A reference list is not allowed inside an array expression.</note> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/04070000.xhp b/helpcontent2/source/text/scalc/01/04070000.xhp new file mode 100644 index 000000000..5aed37738 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/04070000.xhp @@ -0,0 +1,47 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . + --> +<helpdocument version="1.0"> +<meta> +<topic id="textscalc0104070000xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Named Ranges and Expressions</title> +<filename>/text/scalc/01/04070000.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +</history> +</meta> +<body> +<section id="namen"> +<bookmark xml-lang="en-US" branch="hid/.uno:NamesMenu" id="bm_id2043214" localize="false"/> +<h1 id="hd_id3153951"><link href="text/scalc/01/04070000.xhp" name="Names">Named Ranges and Expressions</link></h1> +<paragraph role="paragraph" id="par_id3145801" xml-lang="en-US"><ahelp hid=".">Allows you to name the different sections of your spreadsheet document.</ahelp> By naming the different sections, you can easily <link href="text/scalc/01/02110000.xhp" name="navigate">navigate</link> through the spreadsheet documents and find specific information.</paragraph> +</section> +<section id="howtoget"> + <embed href="text/scalc/00/00000404.xhp#einamen"/> +</section> +<h2 id="hd_id3153878"><link href="text/scalc/01/04070100.xhp" name="Define">Define</link></h2> +<embed href="text/scalc/01/04070100.xhp#namenfestlegentext"/> +<h2 id="hd_id3146969"><link href="text/scalc/01/04070200.xhp" name="Insert">Insert</link></h2> +<embed href="text/scalc/01/04070200.xhp#nameneinfuegentext"/> +<h2 id="hd_id3155764"><link href="text/scalc/01/04070300.xhp" name="Apply">Apply</link></h2> +<embed href="text/scalc/01/04070300.xhp#namenuebernehmentext"/> +<h2 id="hd_id3156382"><link href="text/scalc/01/04070400.xhp" name="Labels">Labels</link></h2> +<embed href="text/scalc/01/04070400.xhp#beschtext"/> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/04070100.xhp b/helpcontent2/source/text/scalc/01/04070100.xhp new file mode 100644 index 000000000..ca27918f7 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/04070100.xhp @@ -0,0 +1,87 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> + +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . + --> + + +<meta> +<topic id="textscalc0104070100xml" indexer="include"> +<title id="tit" xml-lang="en-US">Define Names</title> +<filename>/text/scalc/01/04070100.xhp</filename> +</topic> +</meta> +<body> +<bookmark xml-lang="en-US" branch="hid/.uno:DefineName" id="bm_id4757802" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/definename/DefineNameDialog" id="bm_id3155922" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/definename/@@nowidget@@" id="bm_id3155922" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/managenamesdialog/ManageNamesDialog" id="bm_id3155923" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/managenamesdialog/@@nowidget@@" id="bm_id3155923" localize="false"/> +<paragraph role="heading" id="hd_id3156330" xml-lang="en-US" level="1">Define Names</paragraph> +<paragraph role="paragraph" id="par_id3154366" xml-lang="en-US"><variable id="namenfestlegentext"><ahelp hid=".uno:DefineName">Opens a dialog where you can specify a name for a selected area or a name for a formula expression.</ahelp> +</variable></paragraph> +<paragraph role="paragraph" id="par_id3154123" xml-lang="en-US">Use the mouse to define ranges or type the reference into the <emph>Define Name </emph>dialog fields.</paragraph> +<section id="howtoget"> +<embed href="text/scalc/00/00000404.xhp#define_name"/> +</section> +<paragraph role="paragraph" id="par_id3155131" xml-lang="en-US">The <emph>Sheet Area</emph> box on the Formula bar contains a list of defined names for the ranges or formula expressions and their scope between parenthesis. Click a name from this box to highlight the corresponding reference on the spreadsheet. Names given formulas or parts of a formula are not listed here.</paragraph> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/definename/edit" id="bm_id3151114" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/managenamesdialog/name" id="bm_id3151115" localize="false"/> +<paragraph role="heading" id="hd_id3151118" xml-lang="en-US" level="2">Name</paragraph> +<paragraph role="paragraph" id="par_id3163712" xml-lang="en-US"><ahelp hid=".">Enter the name of the area for which you want to define a reference or a formula expression.</ahelp> All area names already defined in the spreadsheet are listed in the text field above. If you click a name on the list, the corresponding reference in the document will be shown with a blue frame. If multiple cell ranges belong to the same area name, they are displayed with different colored frames.</paragraph> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/definename/range" id="bm_id3145750" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/managenamesdialog/range" id="bm_id3145751" localize="false"/> +<paragraph role="heading" id="hd_id3153728" xml-lang="en-US" level="2">Range or formula expression</paragraph> +<paragraph role="paragraph" id="par_id3147435" xml-lang="en-US"><ahelp hid=".">The reference of the selected area name is shown here as an absolute value.</ahelp></paragraph> +<paragraph role="paragraph" id="par_id3146986" xml-lang="en-US">To insert a new area reference, place the cursor in this field and use your mouse to select the desired area in any sheet of your spreadsheet document. To insert a new named formula, type the formula expression.</paragraph> +<embed href="text/shared/00/00000001.xhp#shrink_maximize"/> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/definename/scope" id="bm_id3148455" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/managenamesdialog/scope" id="bm_id3148456" localize="false"/> +<paragraph role="heading" id="hd_id31547290" xml-lang="en-US" level="2">Scope</paragraph> +<paragraph role="paragraph" id="hd_id31547291" xml-lang="en-US" level="2"><ahelp hid=".">Select the scope of the named range or named formula. Document (Global) means the name is valid for the whole document.</ahelp> Any other sheet name selected will restrict the scope of the named range or formula expression to that sheet. </paragraph> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/definename/more" id="bm_id3148457" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/managenamesdialog/more" id="bm_id3148458" localize="false"/> +<paragraph role="heading" id="hd_id3154729" xml-lang="en-US" level="2">Range options</paragraph> +<paragraph role="paragraph" id="par_id3149958" xml-lang="en-US"><ahelp hid=".">Allows you to specify the <emph>Area type</emph> (optional) for the reference.</ahelp></paragraph> +<paragraph role="paragraph" id="par_id3155416" xml-lang="en-US">Defines additional options related to the type of reference area.</paragraph> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/definename/printarea" id="bm_id3146972" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/managenamesdialog/printrange" id="bm_id3146973" localize="false"/> +<paragraph role="heading" id="hd_id3150716" xml-lang="en-US" level="4">Print range</paragraph> +<paragraph role="paragraph" id="par_id3150751" xml-lang="en-US"><ahelp hid=".">Defines the area as a print range.</ahelp></paragraph> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/definename/filter" id="bm_id3155446" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/managenamesdialog/filter" id="bm_id3155447" localize="false"/> +<paragraph role="heading" id="hd_id3153764" xml-lang="en-US" level="4">Filter</paragraph> +<paragraph role="paragraph" id="par_id3155766" xml-lang="en-US"><ahelp hid=".">Defines the selected area to be used in an <link href="text/scalc/01/12040300.xhp" name="advanced filter">advanced filter</link>.</ahelp></paragraph> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/definename/colheader" id="bm_id3147344" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/managenamesdialog/colheader" id="bm_id3147345" localize="false"/> +<paragraph role="heading" id="hd_id3159267" xml-lang="en-US" level="4">Repeat column</paragraph> +<paragraph role="paragraph" id="par_id3149565" xml-lang="en-US"><ahelp hid=".">Defines the area as a repeating column.</ahelp></paragraph> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/definename/rowheader" id="bm_id3154021" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/managenamesdialog/rowheader" id="bm_id3154022" localize="false"/> +<paragraph role="heading" id="hd_id3153966" xml-lang="en-US" level="4">Repeat row</paragraph> +<paragraph role="paragraph" id="par_id3150300" xml-lang="en-US"><ahelp hid=".">Defines the area as a repeating row.</ahelp></paragraph> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/definename/add" id="bm_id3150207" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/managenamesdialog/add" id="bm_id3150208" localize="false"/> +<paragraph role="heading" id="hd_id3155112" xml-lang="en-US" level="2">Add</paragraph> +<paragraph role="paragraph" id="par_id3159236" xml-lang="en-US"><ahelp hid=".">Click the <emph>Add</emph> button to add a new defined name.</ahelp></paragraph> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/managenamesdialog/delete" id="bm_id3150209" localize="false"/> +<embed href="text/shared/00/00000001.xhp#delete"/> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/managenamesdialog/names" id="bm_id3150210" localize="false"/> +<paragraph role="paragraph" id="par_id3150301" xml-lang="en-US"><ahelp hid="modules/scalc/ui/managenamesdialog/names" visibility="hidden">Select a named range or named formula from the list to modify its properties.</ahelp></paragraph> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/04070200.xhp b/helpcontent2/source/text/scalc/01/04070200.xhp new file mode 100644 index 000000000..24dafe521 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/04070200.xhp @@ -0,0 +1,59 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . + --> + +<helpdocument version="1.0"> +<meta> +<topic id="textscalc0104070200xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Paste Names</title> +<filename>/text/scalc/01/04070200.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +</history> +</meta> +<body> +<bookmark xml-lang="en-US" branch="index" id="bm_id3153195"><bookmark_value>cell ranges; inserting named ranges</bookmark_value> +<bookmark_value>inserting; cell ranges</bookmark_value> <bookmark_value>pasting; cell ranges</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/.uno:InsertName" id="bm_id3154910" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/insertname/InsertNameDialog" id="bm_id3154910" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/insertname/@@nowidget@@" id="bm_id3154910" localize="false"/> +<paragraph role="heading" id="hd_id3153195" xml-lang="en-US" level="1">Paste Names</paragraph> +<paragraph role="paragraph" id="par_id3150011" xml-lang="en-US"><variable id="nameneinfuegentext"><ahelp hid=".uno:InsertName">Inserts a defined named cell range at the current cursor's position.</ahelp> +</variable></paragraph> +<paragraph role="note" id="par_id3149412" xml-lang="en-US">You can only insert a cell area after having defined a name for the area.</paragraph> +<section id="howtoget"> + <embed href="text/scalc/00/00000404.xhp#einaei"/> +</section> + +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/insertname/ctrl" id="bm_id3155415" localize="false"/> +<paragraph role="heading" id="hd_id3153160" xml-lang="en-US" level="2">Table area</paragraph> +<paragraph role="paragraph" id="par_id3154944" xml-lang="en-US"><ahelp hid="modules/scalc/ui/insertname/ctrl">Lists all defined cell areas. Double-click an entry to insert the named area into the active sheet at the current cursor position.</ahelp></paragraph> + +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/insertname/pasteall" id="bm_id3153707" localize="false"/> +<paragraph role="heading" id="hd_id3153418" xml-lang="en-US" level="2">Paste All</paragraph> +<paragraph role="paragraph" id="par_id3155066" xml-lang="en-US"><ahelp hid="modules/scalc/ui/insertname/pasteall">Inserts a list of all named areas and the corresponding cell references at the current cursor position.</ahelp></paragraph> + +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/insertname/paste" id="bm_id3153708" localize="false"/> +<paragraph role="heading" id="hd_id3153419" xml-lang="en-US" level="2">Paste</paragraph> +<paragraph role="paragraph" id="par_id3155067" xml-lang="en-US"><ahelp hid="modules/scalc/ui/insertname/paste">Inserts the selected named area and the corresponding cell reference at the current cursor position.</ahelp></paragraph> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/04070300.xhp b/helpcontent2/source/text/scalc/01/04070300.xhp new file mode 100644 index 000000000..f98549434 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/04070300.xhp @@ -0,0 +1,61 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . + --> + +<helpdocument version="1.0"> +<meta> +<topic id="textscalc0104070300xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Creating Names</title> +<filename>/text/scalc/01/04070300.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +</history> +</meta> +<body> +<bookmark xml-lang="en-US" branch="index" id="bm_id3147264"><bookmark_value>cell ranges;creating names automatically</bookmark_value> +<bookmark_value>names; for cell ranges</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/.uno:CreateNames" id="bm_id8912439" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/createnamesdialog/CreateNamesDialog" id="bm_id3150398" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/createnamesdialog/@@nowidget@@" id="bm_id3150398" localize="false"/> +<paragraph role="heading" id="hd_id3147264" xml-lang="en-US" level="1">Creating Names</paragraph> +<paragraph role="paragraph" id="par_id3153969" xml-lang="en-US"><variable id="namenuebernehmentext"><ahelp hid=".uno:CreateNames">Allows you to automatically name multiple cell ranges.</ahelp> +</variable></paragraph> +<section id="howtoget"> + <embed href="text/scalc/00/00000404.xhp#einaueb"/> +</section> +<paragraph role="paragraph" id="par_id3156280" xml-lang="en-US">Select the area containing all the ranges that you want to name. Then choose <emph>Sheet - Named Ranges and Expressions - Create</emph>. This opens the <emph>Create Names</emph> dialog, from which you can select the naming options that you want.</paragraph> +<paragraph role="heading" id="hd_id3151116" xml-lang="en-US" level="2">Create names from</paragraph> +<paragraph role="paragraph" id="par_id3152597" xml-lang="en-US">Defines which part of the spreadsheet is to be used for creating the name.</paragraph> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/createnamesdialog/top" id="bm_id3156444" localize="false"/> +<paragraph role="heading" id="hd_id3153729" xml-lang="en-US" level="3">Top row</paragraph> +<paragraph role="paragraph" id="par_id3149263" xml-lang="en-US"><ahelp hid="modules/scalc/ui/createnamesdialog/top">Creates the range names from the header row of the selected range.</ahelp> Each column receives a separated name and cell reference.</paragraph> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/createnamesdialog/left" id="bm_id3145749" localize="false"/> +<paragraph role="heading" id="hd_id3146984" xml-lang="en-US" level="3">Left Column</paragraph> +<paragraph role="paragraph" id="par_id3153190" xml-lang="en-US"><ahelp hid="modules/scalc/ui/createnamesdialog/left">Creates the range names from the entries in the first column of the selected sheet range.</ahelp> Each row receives a separated name and cell reference.</paragraph> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/createnamesdialog/bottom" id="bm_id3145645" localize="false"/> +<paragraph role="heading" id="hd_id3156284" xml-lang="en-US" level="3">Bottom row</paragraph> +<paragraph role="paragraph" id="par_id3147124" xml-lang="en-US"><ahelp hid="modules/scalc/ui/createnamesdialog/bottom">Creates the range names from the entries in the last row of the selected sheet range.</ahelp> Each column receives a separated name and cell reference.</paragraph> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/createnamesdialog/right" id="bm_id3145253" localize="false"/> +<paragraph role="heading" id="hd_id3154731" xml-lang="en-US" level="3">Right Column</paragraph> +<paragraph role="paragraph" id="par_id3153158" xml-lang="en-US"><ahelp hid="modules/scalc/ui/createnamesdialog/right">Creates the range names from the entries in the last column of the selected sheet range.</ahelp> Each row receives a separated name and cell reference.</paragraph> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/04070400.xhp b/helpcontent2/source/text/scalc/01/04070400.xhp new file mode 100644 index 000000000..3cc0ad738 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/04070400.xhp @@ -0,0 +1,69 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> + +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . + --> + + +<meta> +<topic id="textscalc0104070400xml" indexer="include"> +<title id="tit" xml-lang="en-US">Define Label Range</title> +<filename>/text/scalc/01/04070400.xhp</filename> +</topic> +</meta> +<body> +<bookmark xml-lang="en-US" branch="index" id="bm_id3150791"><bookmark_value>sheets; defining label ranges</bookmark_value> +<bookmark_value>label ranges in sheets</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/.uno:DefineLabelRange" id="bm_id9319643" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/namerangesdialog/NameRangesDialog" id="bm_id3150447" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/namerangesdialog/@@nowidget@@" id="bm_id3150447" localize="false"/> +<paragraph role="heading" id="hd_id3150791" xml-lang="en-US" level="1"><variable id="define_label_range"><link href="text/scalc/01/04070400.xhp">Define Label Range</link> +</variable></paragraph> +<paragraph role="paragraph" id="par_id3150868" xml-lang="en-US"><variable id="beschtext"><ahelp hid=".uno:DefineLabelRange">Opens a dialog in which you can define a label range.</ahelp> +</variable></paragraph> +<section id="howtoget"> +<embed href="text/scalc/00/00000404.xhp#einabesch"/> +</section> +<embed href="text/scalc/guide/address_auto.xhp#address_auto"/> +<paragraph role="paragraph" id="par_id3155411" xml-lang="en-US">The cell contents of a label range can be used like names in formulas - $[officename] recognizes these names in the same manner that it does the predefined names of the weekdays and months. These names are automatically completed when typed into a formula. In addition, the names defined by label ranges will have priority over names defined by automatically generated ranges.</paragraph> +<paragraph role="note" id="par_id3147435" xml-lang="en-US">You can set label ranges that contain the same labels on different sheets. $[officename] first searches the label ranges of the current sheet and, following a failed search, the ranges of other sheets.</paragraph> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/namerangesdialog/range" id="bm_id3149958" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/namerangesdialog/edassign" id="bm_id3148457" localize="false"/> +<paragraph role="heading" id="hd_id3145801" xml-lang="en-US" level="2">Range</paragraph> +<paragraph role="paragraph" id="par_id3154731" xml-lang="en-US"><ahelp hid="modules/scalc/ui/namerangesdialog/edassign">Displays the cell reference of each label range.</ahelp> In order to remove a label range from the list box, select it and then click <emph>Delete</emph>.</paragraph> +<embed href="text/shared/00/00000001.xhp#shrink_maximize"/> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/namerangesdialog/colhead" id="bm_id3155064" localize="false"/> +<paragraph role="heading" id="hd_id3149121" xml-lang="en-US" level="3">Contains column labels</paragraph> +<paragraph role="paragraph" id="par_id3150330" xml-lang="en-US"><ahelp hid="modules/scalc/ui/namerangesdialog/colhead">Includes column labels in the current label range.</ahelp></paragraph> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/namerangesdialog/rowhead" id="bm_id3145642" localize="false"/> +<paragraph role="heading" id="hd_id3149020" xml-lang="en-US" level="3">Contains row labels</paragraph> +<paragraph role="paragraph" id="par_id3154754" xml-lang="en-US"><ahelp hid="modules/scalc/ui/namerangesdialog/rowhead">Includes row labels in the current label range.</ahelp></paragraph> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/namerangesdialog/edassign2" id="bm_id3146919" localize="false"/> +<paragraph role="heading" id="hd_id3159264" xml-lang="en-US" level="3">For data range</paragraph> +<paragraph role="paragraph" id="par_id3154703" xml-lang="en-US"><ahelp hid="modules/scalc/ui/namerangesdialog/edassign2">Sets the data range for which the selected label range is valid. To modify it, click in the sheet and select another range with the mouse.</ahelp></paragraph> +<embed href="text/shared/00/00000001.xhp#shrink_maximize"/> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/namerangesdialog/add" id="bm_id3150299" localize="false"/> +<paragraph role="heading" id="hd_id3145789" xml-lang="en-US" level="2">Add</paragraph> +<paragraph role="paragraph" id="par_id3147005" xml-lang="en-US"><ahelp hid="modules/scalc/ui/namerangesdialog/add">Adds the current label range to the list.</ahelp></paragraph> +<embed href="text/shared/00/00000001.xhp#delete"/> +<section id="relatedtopics"> +<embed href="text/scalc/guide/address_auto.xhp#address_auto"/> +</section> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/04080000.xhp b/helpcontent2/source/text/scalc/01/04080000.xhp new file mode 100644 index 000000000..6d9c5831f --- /dev/null +++ b/helpcontent2/source/text/scalc/01/04080000.xhp @@ -0,0 +1,71 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . +--> + +<meta> + <topic id="textscalc0104080000xml" indexer="include" status="PUBLISH"> + <title id="tit" xml-lang="en-US">Function List</title> + <filename>/text/scalc/01/04080000.xhp</filename> + </topic> +</meta> + +<body> + +<bookmark xml-lang="en-US" branch="index" id="bm_id3154126"> + <bookmark_value>formula list window</bookmark_value> + <bookmark_value>function list window</bookmark_value> + <bookmark_value>inserting functions; function list window</bookmark_value> +</bookmark> + +<bookmark xml-lang="en-US" branch="hid/.uno:FunctionBox" id="bm_id998166" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/functionpanel/@@nowidget@@" id="bm_id314550752" localize="false"/> + +<h1 id="hd_id3154126"><variable id="function_list_title"><link href="text/scalc/01/04080000.xhp" name="Function List">Function List</link></variable></h1> +<paragraph id="par_id3151118" role="paragraph" xml-lang="en-US"><variable id="function_list_text"><ahelp hid="HID_SC_FUNCTIONLIST">Opens the Function List deck of the Sidebar, which displays all functions that can be inserted into your document.</ahelp></variable> The <emph>Function List</emph> deck is similar to the <emph>Functions</emph> tab page of the <link href="text/scalc/01/04060000.xhp" name="Function Wizard">Function Wizard</link>. The functions are inserted with placeholders to be replaced with your own values.</paragraph> + +<section id="howtoget"> + <embed href="text/scalc/00/00000403.xhp#functionlist"/> +</section> +<paragraph id="par_id3152576" role="paragraph" xml-lang="en-US">The <emph>Function List</emph> window is a resizable <link href="text/shared/00/00000005.xhp#docking" name="dockable window">dockable window</link>. Use it to quickly enter functions in the spreadsheet. By double-clicking an entry in the functions list, the respective function is directly inserted with all parameters.</paragraph> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/functionpanel/category" id="bm_id3149960" localize="false"/> + +<h2 id="hd_id3145799">Category List</h2> +<embed href="text/scalc/01/04060000.xhp#kategorienliste"/> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/functionpanel/funclist" id="bm_id3147126" localize="false"/> + +<h2 id="hd_id3153160">Function List</h2> +<paragraph id="par_id3149412" role="paragraph" xml-lang="en-US"><ahelp hid="modules/scalc/ui/functionpanel/funclist">Displays the available functions.</ahelp> When you select a function, the area below the list box displays a short description. To insert the selected function double-click it or click the <emph>Insert Function into calculation sheet</emph> icon.</paragraph> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/functionpanel/insert" id="bm_id3150752" localize="false"/> + +<h2 id="hd_id3146971">Insert Function into calculation sheet</h2> + +<table id="tbl_id3153711"> + <tablerow> + <tablecell> + <paragraph id="par_id3150043" role="paragraph" xml-lang="en-US"> <image id="img_id3159267" src="sc/res/fx.png" width="1cm" height="1cm"><alt id="alt_id3159267" xml-lang="en-US">Icon Insert Function</alt></image></paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3147345" role="paragraph" xml-lang="en-US"><ahelp hid="modules/scalc/ui/functionpanel/insert">Inserts the selected function into the document.</ahelp></paragraph> + </tablecell> + </tablerow> +</table> + +</body> + +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/04090000.xhp b/helpcontent2/source/text/scalc/01/04090000.xhp new file mode 100644 index 000000000..e78f7a721 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/04090000.xhp @@ -0,0 +1,58 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> + +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . + --> + + +<meta> + <topic id="textscalc0104090000xml" indexer="include" status="PUBLISH"> + <title xml-lang="en-US" id="tit">External Links</title> + <filename>/text/scalc/01/04090000.xhp</filename> + </topic> + </meta> + <body> + <section id="extdata"> + <paragraph xml-lang="en-US" id="par_id3153361" role="paragraph" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/externaldata/browse" id="bm_id3151041" localize="false"/> +<paragraph xml-lang="en-US" id="par_id3153192" role="paragraph"><ahelp hid="modules/scalc/ui/externaldata/browse" visibility="hidden">Open a file dialog to locate the file containing the data you want to insert.</ahelp></paragraph> +<bookmark xml-lang="en-US" branch="hid/.uno:InsertExternalDataSource" id="bm_id3748965" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/externaldata/ExternalDataDialog" id="bm_id3150441" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/externaldata/@@nowidget@@" id="bm_id3150441" localize="false"/> +<paragraph xml-lang="en-US" id="hd_id3145785" role="heading" level="1"><link href="text/scalc/01/04090000.xhp" name="External Data">External Links</link></paragraph> + <paragraph xml-lang="en-US" id="par_id3149262" role="paragraph"><ahelp hid=".uno:InsertExternalDataSourc">Inserts data from an HTML, Calc, CSV or Excel file into the current sheet as a link. The data must be located within a named range.</ahelp></paragraph> + </section> + <section id="howtoget"> + <embed href="text/scalc/00/00000404.xhp#eiextdata"/> + </section> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/externaldata/url" id="bm_id3148577" localize="false"/> +<paragraph xml-lang="en-US" id="hd_id3146984" role="heading" level="2">URL of external data source.</paragraph> +<paragraph xml-lang="en-US" id="par_id3145366" role="paragraph"><ahelp hid="modules/scalc/ui/externaldata/url">Enter the URL or the file name that contains the data that you want to insert, and then press Enter.</ahelp> Alternatively, click <emph>Browse</emph> button to select the file name from a file dialog that opens. Only then will the URL be requested from the network or file system.</paragraph> +<paragraph xml-lang="en-US" id="par_id621519313666202" role="note"><link href="text/shared/00/00000208.xhp" name="linkname">A dialog for CSV data import</link> appears when linking to external CSV file.</paragraph> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/externaldata/ranges" id="bm_id3153876" localize="false"/> +<paragraph xml-lang="en-US" id="hd_id3145251" role="heading" level="2">Available tables/ranges</paragraph> + <paragraph xml-lang="en-US" id="par_id3147397" role="paragraph"><ahelp hid="modules/scalc/ui/externaldata/ranges">Select the table or the data range that you want to insert.</ahelp> If the selected Calc or Excel document contains no named range, spreadsheet data cannot be inserted and <emph>OK</emph> button will remain inactive </paragraph> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/externaldata/reload" id="bm_id3153418" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/externaldata/delay" id="bm_id3150718" localize="false"/> +<paragraph xml-lang="en-US" id="hd_id3154492" role="heading" level="2">Update every</paragraph> + <paragraph xml-lang="en-US" id="par_id3154017" role="paragraph"><ahelp hid="modules/scalc/ui/externaldata/delay">Enter the number of seconds to wait before the external data are reloaded into the current document.</ahelp></paragraph> + <section id="relatedtopics"> + <embed href="text/scalc/guide/webquery.xhp#webquery"/> + </section> + </body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/05020000.xhp b/helpcontent2/source/text/scalc/01/05020000.xhp new file mode 100644 index 000000000..ed2b49968 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/05020000.xhp @@ -0,0 +1,57 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . + --> +<helpdocument version="1.0"> +<meta> +<topic id="textscalc0105020000xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Format Cells</title> +<filename>/text/scalc/01/05020000.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +</history> +</meta> +<body> +<bookmark xml-lang="en-US" branch="index" id="bm_id3148663"><bookmark_value>cell attributes</bookmark_value> +<bookmark_value>attributes;cells</bookmark_value> +<bookmark_value>formatting;cells</bookmark_value> +<bookmark_value>cells;formatting dialog</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/.uno:FormatCellDialog" id="bm_id6056664" localize="false"/> +<h1 id="hd_id3148663">Format Cells</h1> +<paragraph role="paragraph" id="par_id3150448" xml-lang="en-US"><variable id="zellattributetext"><ahelp hid=".uno:FormatCellDialog">Allows you to specify a variety of formatting options and to apply attributes to the selected cells.</ahelp> +</variable></paragraph> +<section id="howtoget"> + <embed href="text/scalc/00/00000405.xhp#format_cells"/> +</section> +<embed href="text/shared/01/05020300.xhp#numbersh1"/> +<embed href="text/shared/01/05020100.xhp#characters"/> +<switch select="appl"> +<case select="CHART"> +</case> +<default><embed href="text/shared/01/05020200.xhp#font_effects"/> +</default> +</switch> +<embed href="text/shared/01/05340300.xhp#alignment"/> +<embed href="text/shared/01/05020700.xhp#asitypo"/> +<embed href="text/shared/01/05030500.xhp#borders"/> +<embed href="text/shared/01/05210100.xhp#area"/> +<embed href="text/scalc/01/05020600.xhp#cell_protection"/> +<embed href="text/shared/00/00000001.xhp#reset"/> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/05020600.xhp b/helpcontent2/source/text/scalc/01/05020600.xhp new file mode 100644 index 000000000..011b07e9c --- /dev/null +++ b/helpcontent2/source/text/scalc/01/05020600.xhp @@ -0,0 +1,59 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . + --> + +<helpdocument version="1.0"> +<meta> +<topic id="textscalc0105020600xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Cell Protection</title> +<filename>/text/scalc/01/05020600.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +</history> +</meta> +<body> +<section id="cell_protection"> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/cellprotectionpage/CellProtectionPage" id="bm_id3151385" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/cellprotectionpage/@@nowidget@@" id="bm_id3151385" localize="false"/> +<paragraph role="heading" id="hd_id3145119" xml-lang="en-US" level="1"><link href="text/scalc/01/05020600.xhp" name="Cell Protection">Cell Protection</link></paragraph> +<paragraph role="paragraph" id="par_id3150398" xml-lang="en-US"><ahelp hid="modules/scalc/ui/cellprotectionpage/CellProtectionPage">Defines protection options for selected cells.</ahelp></paragraph> +</section> +<section id="howtoget"> + <embed href="text/scalc/00/00000405.xhp#fozelstz"/> +</section> +<paragraph role="heading" id="hd_id3150447" xml-lang="en-US" level="2">Protection</paragraph> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/cellprotectionpage/checkHideAll" id="bm_id3153192" localize="false"/> +<paragraph role="heading" id="hd_id3125864" xml-lang="en-US" level="3">Hide all</paragraph> +<paragraph role="paragraph" id="par_id3153768" xml-lang="en-US"><ahelp hid="modules/scalc/ui/cellprotectionpage/checkHideAll">Hides formulas and contents of the selected cells.</ahelp></paragraph> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/cellprotectionpage/checkProtected" id="bm_id3149260" localize="false"/> +<paragraph role="heading" id="hd_id3153190" xml-lang="en-US" level="3">Protected</paragraph> +<paragraph role="paragraph" id="par_id3151119" xml-lang="en-US"><ahelp hid="modules/scalc/ui/cellprotectionpage/checkProtected">Prevents the selected cells from being modified.</ahelp></paragraph> +<paragraph role="note" id="par_id3156283" xml-lang="en-US">This cell protection only takes effect if you also protect the sheet (<emph>Tools - Protect Sheet</emph>).</paragraph> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/cellprotectionpage/checkHideFormula" id="bm_id3149958" localize="false"/> +<paragraph role="heading" id="hd_id3149377" xml-lang="en-US" level="3">Hide formula</paragraph> +<paragraph role="paragraph" id="par_id3154510" xml-lang="en-US"><ahelp hid="modules/scalc/ui/cellprotectionpage/checkHideFormula">Hides formulas in the selected cells.</ahelp></paragraph> +<paragraph role="heading" id="hd_id3155602" xml-lang="en-US" level="2">Print</paragraph> +<paragraph role="paragraph" id="par_id3153836" xml-lang="en-US">Defines print options for the sheet.</paragraph> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/cellprotectionpage/checkHidePrinting" id="bm_id3153715" localize="false"/> +<paragraph role="heading" id="hd_id3155065" xml-lang="en-US" level="3">Hide when printing</paragraph> +<paragraph role="paragraph" id="par_id3155443" xml-lang="en-US"><ahelp hid="modules/scalc/ui/cellprotectionpage/checkHidePrinting">Keeps the selected cells from being printed.</ahelp></paragraph> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/05030000.xhp b/helpcontent2/source/text/scalc/01/05030000.xhp new file mode 100644 index 000000000..4fa978e17 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/05030000.xhp @@ -0,0 +1,48 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . + --> + +<helpdocument version="1.0"> +<meta> +<topic id="textscalc0105030000xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Row</title> +<filename>/text/scalc/01/05030000.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +</history> +</meta> +<body> +<section id="row"> +<bookmark xml-lang="en-US" branch="hid/.uno:RowMenu" id="bm_id8181096" localize="false"/> +<paragraph role="heading" id="hd_id3147228" xml-lang="en-US" level="1"><link href="text/scalc/01/05030000.xhp" name="Row">Row</link></paragraph> +<paragraph role="paragraph" id="par_id3154685" xml-lang="en-US"><ahelp hid=".">Sets the row height and hides or shows selected rows.</ahelp></paragraph> +</section> +<section id="howtoget"> + <embed href="text/scalc/00/00000405.xhp#fozei"/> +</section> +<paragraph role="heading" id="hd_id3155132" xml-lang="en-US" level="2"><link href="text/shared/01/05340100.xhp" name="Height">Height</link></paragraph> +<embed href="text/shared/01/05340100.xhp#zeilenhoehetext"/> +<paragraph role="heading" id="hd_id3155854" xml-lang="en-US" level="2"><link href="text/scalc/01/05030200.xhp" name="Optimal Height">Optimal Height</link></paragraph> +<embed href="text/scalc/01/05030200.xhp#optitext"/> +<embed href="text/scalc/01/05030300.xhp#hide"/> +<embed href="text/scalc/01/05030400.xhp#show"/> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/05030200.xhp b/helpcontent2/source/text/scalc/01/05030200.xhp new file mode 100644 index 000000000..dbca42674 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/05030200.xhp @@ -0,0 +1,53 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . + --> + +<helpdocument version="1.0"> +<meta> +<topic id="textscalc0105030200xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Optimal Row Heights</title> +<filename>/text/scalc/01/05030200.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +</history> +</meta> +<body> +<bookmark xml-lang="en-US" branch="index" id="bm_id3148491"><bookmark_value>sheets; optimal row heights</bookmark_value> +<bookmark_value>rows; optimal heights</bookmark_value> +<bookmark_value>optimal row heights</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/optimalrowheightdialog/OptimalRowHeightDialog" id="bm_id1299843" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/optimalrowheightdialog/@@nowidget@@" id="bm_id1299843" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/.uno:SetOptimalRowHeight" id="bm_id3145673" localize="false"/> +<paragraph role="heading" id="hd_id3148491" xml-lang="en-US" level="1">Optimal Row Heights</paragraph> +<paragraph role="paragraph" id="par_id3154758" xml-lang="en-US"><variable id="optitext"><ahelp hid=".uno:SetOptimalRowHeight">Determines the optimal row height for the selected rows.</ahelp> +</variable> The optimal row height depends on the font size of the largest character in the row. You can use various <link href="text/shared/00/00000003.xhp#measurement_units" name="units of measure">units of measure</link>.</paragraph> +<section id="howtoget"> + <embed href="text/scalc/00/00000405.xhp#fozeiophoe"/> +</section> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/optimalrowheightdialog/value" id="bm_id3156280" localize="false"/> +<paragraph role="heading" id="hd_id3154908" xml-lang="en-US" level="2">Add</paragraph> +<paragraph role="paragraph" id="par_id3151044" xml-lang="en-US"><ahelp hid="modules/scalc/ui/optimalrowheightdialog/value">Sets additional spacing between the largest character in a row and the cell boundaries.</ahelp></paragraph> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/optimalrowheightdialog/default" id="bm_id3145271" localize="false"/> +<paragraph role="heading" id="hd_id3150439" xml-lang="en-US" level="2">Default value</paragraph> +<paragraph role="paragraph" id="par_id3146984" xml-lang="en-US"><ahelp hid="modules/scalc/ui/optimalrowheightdialog/default">Restores the default value for the optimal row height.</ahelp></paragraph> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/05030300.xhp b/helpcontent2/source/text/scalc/01/05030300.xhp new file mode 100644 index 000000000..bf465e4ab --- /dev/null +++ b/helpcontent2/source/text/scalc/01/05030300.xhp @@ -0,0 +1,64 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . + --> + +<helpdocument version="1.0"> +<meta> +<topic id="textscalc0105030300xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Hide</title> +<filename>/text/scalc/01/05030300.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +</history> +</meta> +<body> +<section id="hide"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3147265"><bookmark_value>spreadsheets; hiding functions</bookmark_value> +<bookmark_value>hiding; rows</bookmark_value> +<bookmark_value>hiding; columns</bookmark_value> +<bookmark_value>hiding; sheets</bookmark_value> +<bookmark_value>sheets;hiding</bookmark_value> +<bookmark_value>columns;hiding</bookmark_value> +<bookmark_value>rows;hiding</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/.uno:HideRow" id="bm_id3154760" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/.uno:HideColumn" id="bm_id3148663" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/.uno:Hide" id="bm_id3149457" localize="false"/> +<paragraph role="heading" id="hd_id3147265" xml-lang="en-US" level="1"><link href="text/scalc/01/05030300.xhp" name="Hide">Hide</link></paragraph> +<paragraph role="paragraph" id="par_id3156281" xml-lang="en-US"><ahelp hid=".">Hides selected rows, columns or individual sheets.</ahelp></paragraph> +</section> +<section id="howtoget"> + <embed href="text/scalc/00/00000405.xhp#hide"/> +</section> +<paragraph role="paragraph" id="par_id3148645" xml-lang="en-US">Select the rows or columns that you want to hide, and then choose <emph>Format - Rows - Hide </emph>or<emph> Format - Columns - Hide</emph>.</paragraph> +<paragraph role="paragraph" id="par_id3147427" xml-lang="en-US">You can hide a sheet by selecting the sheet tab and then choosing <emph>Format - Sheet - Hide</emph>. Hidden sheets are not printed unless they occur within a <link href="text/scalc/01/05080000.xhp" name="print range">print range</link>.</paragraph> +<paragraph role="note" id="par_id3153157" xml-lang="en-US">A break in the row or column header indicates whether the row or column is hidden.</paragraph> +<paragraph role="paragraph" id="par_id3145251" xml-lang="en-US">To display hidden rows, columns or sheets</paragraph> +<list type="ordered"> +<listitem> +<paragraph role="paragraph" id="par_id8337046" xml-lang="en-US">Select the range that includes the hidden objects. You can also use the box in the corner above row 1 and beside column A. For sheets, this step is not necessary.<comment>UFI: fixes #i18582#</comment></paragraph> +</listitem> +<listitem> +<paragraph role="paragraph" id="par_id5532090" xml-lang="en-US">Choose <link href="text/scalc/01/05030400.xhp" name="Format - Rows/Columns - Show">Format - Rows/Columns - Show</link> or <link href="text/scalc/01/05050300.xhp" name="Format - Sheet - Show">Format - Sheet - Show</link>.</paragraph> +</listitem> +</list> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/05030400.xhp b/helpcontent2/source/text/scalc/01/05030400.xhp new file mode 100644 index 000000000..02d47ef6b --- /dev/null +++ b/helpcontent2/source/text/scalc/01/05030400.xhp @@ -0,0 +1,50 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . + --> + +<helpdocument version="1.0"> +<meta> +<topic id="textscalc0105030400xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Show</title> +<filename>/text/scalc/01/05030400.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +</history> +</meta> +<body> +<section id="show"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3147264"><bookmark_value>spreadsheets; showing columns</bookmark_value> +<bookmark_value>showing; columns</bookmark_value> +<bookmark_value>showing; rows</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/.uno:ShowRow" id="bm_id3154760" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/.uno:ShowColumn" id="bm_id3149456" localize="false"/> +<paragraph role="heading" id="hd_id3147264" xml-lang="en-US" level="1"><link href="text/scalc/01/05030400.xhp" name="Show">Show</link></paragraph> +<paragraph role="paragraph" id="par_id3150447" xml-lang="en-US"><ahelp hid=".">Choose this command to show previously hidden rows or columns.</ahelp></paragraph> +</section> +<section id="howtoget"> + <embed href="text/scalc/00/00000405.xhp#show"/> +</section> +<paragraph role="paragraph" id="par_id3155131" xml-lang="en-US">To show a column or row, select the range of rows or columns containing the hidden elements, then choose <emph>Format - Rows - Show</emph> or <emph>Format - Columns - Show</emph>.</paragraph> +<paragraph role="paragraph" id="par_id3155132" xml-lang="en-US">For example, to show the column B, click on the header of the column A, expand the selection to the column C, then chose <emph>Format - Columns - Show</emph>. To show the column A previously hidden, click on the header of the column B, keep the mouse button pressed and drag on the left. The selected range displayed in the name area changes from B1:B1048576 to A1:B1048576. Choose <emph>Format - Columns - Show</emph>. Proceed the same way with rows.</paragraph> +<paragraph role="paragraph" id="par_id3145748" xml-lang="en-US">To show all hidden cells, first click in the field in the upper left corner. This selects all cells of the table.</paragraph> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/05040000.xhp b/helpcontent2/source/text/scalc/01/05040000.xhp new file mode 100644 index 000000000..ee3e1a861 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/05040000.xhp @@ -0,0 +1,48 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . + --> + +<helpdocument version="1.0"> +<meta> +<topic id="textscalc0105040000xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Column</title> +<filename>/text/scalc/01/05040000.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +</history> +</meta> +<body> +<section id="column"> +<bookmark xml-lang="en-US" branch="hid/.uno:ColumnMenu" id="bm_id9955137" localize="false"/> +<paragraph role="heading" id="hd_id3155628" xml-lang="en-US" level="1"><link href="text/scalc/01/05040000.xhp" name="Column">Column</link></paragraph> +<paragraph role="paragraph" id="par_id3148946" xml-lang="en-US"><ahelp hid=".">Sets the column width and hides or shows selected columns.</ahelp></paragraph> +</section> +<section id="howtoget"> + <embed href="text/scalc/00/00000405.xhp#fospa"/> +</section> +<paragraph role="heading" id="hd_id3150398" xml-lang="en-US" level="2"><link href="text/shared/01/05340200.xhp" name="Width">Width</link></paragraph> +<embed href="text/shared/01/05340200.xhp#spaltetext"/> +<paragraph role="heading" id="hd_id3145171" xml-lang="en-US" level="2"><link href="text/scalc/01/05040200.xhp" name="Optimal Width">Optimal Width</link></paragraph> +<embed href="text/scalc/01/05040200.xhp#optitext"/> +<embed href="text/scalc/01/05030300.xhp#hide"/> +<embed href="text/scalc/01/05030400.xhp#show"/> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/05040200.xhp b/helpcontent2/source/text/scalc/01/05040200.xhp new file mode 100644 index 000000000..980f26279 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/05040200.xhp @@ -0,0 +1,54 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . + --> + +<helpdocument version="1.0"> +<meta> +<topic id="textscalc0105040200xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Optimal Column Width</title> +<filename>/text/scalc/01/05040200.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +</history> +</meta> +<body> +<bookmark xml-lang="en-US" branch="index" id="bm_id3155628"><bookmark_value>spreadsheets; optimal column widths</bookmark_value> +<bookmark_value>columns; optimal widths</bookmark_value> +<bookmark_value>optimal column widths</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/optimalcolwidthdialog/OptimalColWidthDialog" id="bm_id2742569" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/optimalcolwidthdialog/@@nowidget@@" id="bm_id2742569" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/.uno:SetOptimalColumnWidth" id="bm_id3156326" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/.uno:SetOptimalColumnWidthDirect" id="bm_id3153254" localize="false"/> +<paragraph role="heading" id="hd_id3155628" xml-lang="en-US" level="1">Optimal Column Width</paragraph> +<paragraph role="paragraph" id="par_id3145068" xml-lang="en-US"><variable id="optitext"><ahelp hid=".uno:SetOptimalColumnWidthDi">Defines the optimal column width for selected columns.</ahelp> +</variable> The optimal column width depends on the longest entry within a column. You can choose from the available <link href="text/shared/00/00000003.xhp#metrik" name="measurement units">measurement units</link>.</paragraph> +<section id="howtoget"> + <embed href="text/scalc/00/00000405.xhp#optimal_column_width"/> +</section> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/optimalcolwidthdialog/value" id="bm_id3153192" localize="false"/> +<paragraph role="heading" id="hd_id3150767" xml-lang="en-US" level="2">Add</paragraph> +<paragraph role="paragraph" id="par_id3150449" xml-lang="en-US"><ahelp hid="modules/scalc/ui/optimalcolwidthdialog/value">Defines additional spacing between the longest entry in a column and the vertical column borders.</ahelp></paragraph> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/optimalcolwidthdialog/default" id="bm_id3155855" localize="false"/> +<paragraph role="heading" id="hd_id3145785" xml-lang="en-US" level="2">Default value</paragraph> +<paragraph role="paragraph" id="par_id3146120" xml-lang="en-US"><ahelp hid="modules/scalc/ui/optimalcolwidthdialog/default">Defines the optimal column width in order to display the entire contents of the column.</ahelp> The additional spacing for the optimal column width is preset to 2 mm.</paragraph> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/05050000.xhp b/helpcontent2/source/text/scalc/01/05050000.xhp new file mode 100644 index 000000000..664ff6426 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/05050000.xhp @@ -0,0 +1,55 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . + --> + +<helpdocument version="1.0"> +<meta> +<topic id="textscalc0105050000xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Sheet</title> +<filename>/text/scalc/01/05050000.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +</history> +</meta> +<body> +<section id="sheet"> +<bookmark xml-lang="en-US" branch="index" id="bm_id1245460"><bookmark_value>CTL;right-to-left sheets</bookmark_value> +<bookmark_value>sheets;right-to-left</bookmark_value> +<bookmark_value>right-to-left text;spreadsheets</bookmark_value> +</bookmark><comment>mw changed "right-to-left;..."</comment> +<bookmark xml-lang="en-US" branch="hid/.uno:SheetMenu" id="bm_id5620899" localize="false"/> +<paragraph role="heading" id="hd_id3155923" xml-lang="en-US" level="1"><link href="text/scalc/01/05050000.xhp" name="Sheet">Sheet</link></paragraph> +<paragraph role="paragraph" id="par_id3154758" xml-lang="en-US"><ahelp hid=".">Sets the sheet name and hides or shows selected sheets.</ahelp></paragraph> +</section> +<section id="howtoget"> + <embed href="text/scalc/00/00000405.xhp#fot"/> +</section> +<paragraph role="heading" id="hd_id3156280" xml-lang="en-US" level="2"><link href="text/scalc/01/05050100.xhp" name="Rename">Rename</link></paragraph> +<embed href="text/scalc/01/05050100.xhp#umbenennentext"/> +<embed href="text/scalc/01/05030300.xhp#hide"/> +<paragraph role="heading" id="hd_id3145787" xml-lang="en-US" level="2"><link href="text/scalc/01/05050300.xhp" name="Show">Show</link></paragraph> +<embed href="text/scalc/01/05050300.xhp#tabeintext"/> +<paragraph role="paragraph" id="par_id3150542" xml-lang="en-US">If a sheet has been hidden, the Show Sheet dialog opens, which allows you to select a sheet to be shown again.</paragraph> +<bookmark xml-lang="en-US" branch="hid/.uno:SheetRightToLeft" id="bm_id9923771" localize="false"/> +<paragraph role="heading" id="par_idN10656" xml-lang="en-US" level="2">Right-To-Left</paragraph> +<paragraph role="paragraph" id="par_idN1065A" xml-lang="en-US"><ahelp hid=".uno:SheetRightToLeft">Changes the orientation of the current sheet to Right-To-Left if <link href="text/shared/optionen/01150300.xhp">CTL</link> support is enabled.</ahelp></paragraph> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/05050100.xhp b/helpcontent2/source/text/scalc/01/05050100.xhp new file mode 100644 index 000000000..525d60862 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/05050100.xhp @@ -0,0 +1,56 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> + +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . + --> + + +<meta> +<topic id="textscalc0105050100xml" indexer="include"> +<title id="tit" xml-lang="en-US">Rename Sheet</title> +<filename>/text/scalc/01/05050100.xhp</filename> +</topic> +</meta> +<body> +<bookmark xml-lang="en-US" branch="index" id="bm_id3147336"><bookmark_value>worksheet names</bookmark_value> +<bookmark_value>changing; sheet names</bookmark_value> +<bookmark_value>sheets; renaming</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/inputstringdialog/InputStringDialog" id="bm_id3149166" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/inputstringdialog/@@nowidget@@" id="bm_id3149166" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/.uno:Name" id="bm_id3153252" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/.uno:RenameTable" id="bm_id9504501" localize="false"/> +<paragraph role="heading" id="hd_id3147336" xml-lang="en-US" level="1">Rename Sheet</paragraph> +<paragraph role="paragraph" id="par_id3150792" xml-lang="en-US"><variable id="umbenennentext"><ahelp hid=".uno:RenameTable">This command opens a dialog where you can assign a different name to the current sheet.</ahelp> +</variable></paragraph> +<section id="howtoget"> +<embed href="text/scalc/00/00000405.xhp#fotu"/> +</section> +<bookmark xml-lang="en-US" branch="hid/SC_HID_SC_RENAME_NAME" id="bm_id3156280" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/inputstringdialog/name_entry" id="bm_id3154908" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/SC_HID_SC_APPEND_NAME" id="bm_id3151041" localize="false"/> +<paragraph role="heading" id="hd_id3153968" xml-lang="en-US" level="2">Name</paragraph> +<paragraph role="paragraph" id="par_id3155131" xml-lang="en-US"><ahelp hid="HID_SC_APPEND_NAME">Enter a new name for the sheet here.</ahelp></paragraph> +<paragraph role="tip" id="par_id3153092" xml-lang="en-US">You can also open the<emph> Rename Sheet </emph>dialog through the context menu by positioning the mouse pointer over a sheet tab at the bottom of the window and <switchinline select="sys"><caseinline select="MAC">clicking while pressing Control</caseinline><defaultinline>clicking the right mouse button</defaultinline></switchinline>.</paragraph> +<paragraph role="tip" id="par_id3147396" xml-lang="en-US">Alternatively, click the sheet tab while pressing the <switchinline select="sys"><caseinline select="MAC">Command</caseinline><defaultinline>Alt</defaultinline></switchinline> key. Now you can change the name directly. <switchinline select="sys"><caseinline select="UNIX"><embedvar href="text/shared/00/00000099.xhp#winmanager"/> +</caseinline></switchinline></paragraph> +<section id="relatedtopics"> +<embed href="text/scalc/guide/rename_table.xhp#rename_table"/> +</section> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/05050300.xhp b/helpcontent2/source/text/scalc/01/05050300.xhp new file mode 100644 index 000000000..f0628b62b --- /dev/null +++ b/helpcontent2/source/text/scalc/01/05050300.xhp @@ -0,0 +1,47 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . + --> + +<helpdocument version="1.0"> +<meta> +<topic id="textscalc0105050300xml" indexer="include" status="PUBLISH"> +<title xml-lang="en-US" id="tit">Show Sheet</title> +<filename>/text/scalc/01/05050300.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +</history> +</meta> +<body> + + + <bookmark branch="index" xml-lang="en-US" id="bm_id3148946"><bookmark_value>sheets; displaying</bookmark_value><bookmark_value>displaying; sheets</bookmark_value></bookmark> +<bookmark branch="hid/.uno:Show" xml-lang="en-US" id="bm_id3150542" localize="false"/> +<paragraph role="heading" level="1" id="hd_id3148946" xml-lang="en-US">Show Sheet</paragraph> + <paragraph xml-lang="en-US" role="paragraph" id="par_id3148799"><variable id="tabeintext"><ahelp visibility="visible" hid=".uno:Show">Displays sheets that were previously hidden with the <emph>Hide Sheets</emph> command.</ahelp></variable> Select one sheet only to call the command. The current sheet is always selected. If a sheet other than the current sheet is selected, you can deselect it by pressing <switchinline select="sys"> <caseinline select="MAC">Command</caseinline> <defaultinline>Ctrl</defaultinline> </switchinline> while clicking the corresponding sheet tab at the bottom of the window.</paragraph> + <section id="howtoget"> + <embed href="text/scalc/00/00000405.xhp#fotenb"/> +</section> + <bookmark branch="hid/modules/scalc/ui/showsheetdialog/ShowSheetDialog" xml-lang="en-US" id="bm_id3149260" localize="false"/> + <bookmark branch="hid/modules/scalc/ui/showsheetdialog/@@nowidget@@" xml-lang="en-US" id="bm_id3149260" localize="false"/> + <paragraph role="heading" level="2" id="hd_id3151112" xml-lang="en-US">Hidden sheets</paragraph> + <paragraph role="paragraph" id="par_id3145273" xml-lang="en-US"><ahelp hid="modules/scalc/ui/showsheetdialog/ShowSheetDialog" visibility="visible">Displays a list of all hidden sheets in your spreadsheet document.</ahelp> To show a certain sheet, click the corresponding entry on the list and confirm with OK.</paragraph> + </body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/05060000.xhp b/helpcontent2/source/text/scalc/01/05060000.xhp new file mode 100644 index 000000000..b01c72240 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/05060000.xhp @@ -0,0 +1,88 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . + --> +<helpdocument version="1.0"> +<meta> +<topic id="textscalc0105060000xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Merge and Center Cells</title> +<filename>/text/scalc/01/05060000.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +</history> +</meta> +<body> +<bookmark xml-lang="en-US" branch="index" id="bm_id501632012952361"> + <bookmark_value>toggle merge and center cells</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/.uno:ToggleMergeCells" id="bm_id8030335" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/mergecellsdialog/MergeCellsDialog" id="bm_id2745673" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/mergecellsdialog/@@nowidget@@" id="bm_id2745673" localize="false"/> +<h1 id="hd_id3149785"><variable id="togglemergecells"><link href="text/scalc/01/05060000.xhp" name="Merge and Center Cells">Merge and Center Cells</link></variable></h1> +<paragraph role="paragraph" id="par_id3151246" xml-lang="en-US"><ahelp hid=".">This is a toggleable control that joins all cells in a rectangular selection into a single cell, or returns merged cells to the original individual cells. When merging it will format the merged cell as center aligned.</ahelp></paragraph> +<paragraph role="paragraph" id="par_id541633057818950" xml-lang="en-US">The control is shown toggled-on whenever there are merged cells in the selection, indicating that clicking the control will unmerge those cells.</paragraph> +<section id="mergecells_warning"> +<warning id="par_id3153718">Merging cells can lead to calculation errors in formulas in the table.</warning> +</section> +<section id="howtoget"> +<paragraph role="paragraph" id="par_id441632808439621" xml-lang="en-US">Do one of the following:</paragraph> +<paragraph role="paragraph" id="par_id691632803588118" xml-lang="en-US">In the <emph>Formatting</emph> toolbar, click:</paragraph> +<table id="tab_id451632804983642"> +<tablerow> +<tablecell> +<paragraph role="paragraph" id="par_id521632804983642" xml-lang="en-US"> +<image id="img_id811632804983642" src="cmd/sc_togglemergecells.png" width="1cm" height="1cm"><alt id="alt_id921632804983642" xml-lang="en-US">Icon Merge and Center Cells</alt></image></paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id491632804983642" xml-lang="en-US">Merge and Center Cells</paragraph> +</tablecell> +</tablerow> +</table> +<paragraph role="paragraph" id="par_id3154020" xml-lang="en-US">Or, choose <variable id="format_mergecells_menu"><menuitem>Format - Merge and Unmerge Cells - </menuitem></variable><menuitem> Merge and Center Cells</menuitem>.</paragraph> +</section> +<section id="mergenotes"> +<paragraph role="paragraph" id="par_id3149665" xml-lang="en-US">Cells cannot be merged again without first unmerging them.</paragraph> +<note id="par_id581632979766784">Merging a cell selection that partially includes merged cells is generally possible with <emph>Unmerge Cells</emph> followed by <emph>Merge Cells</emph>, without altering the initial selection. The result will be largely depend on previous choices when merging cells made with the <emph>Merge Cells Dialog</emph> options described below.</note> +<paragraph role="paragraph" id="par_id3148552" xml-lang="en-US">Multiple selection is not supported, that is, the selection must be rectangular.</paragraph> +<paragraph role="paragraph" id="par_id211632985508898">The merged cell receives the name and content of the first cell of the selection.</paragraph> +<paragraph role="paragraph" id="par_id271632985709781">If more than one cell to be merged has content the <emph>Merge Cells</emph> dialog opens.</paragraph> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/mergecellsdialog/move-cells-radio" id="bm_id274567" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/mergecellsdialog/keep-content-radio" id="bm_id274567" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/mergecellsdialog/empty-cells-radio" id="bm_id274567" localize="false"/> +<h3 id="par_id391632360383197">Merge Cells Dialog Options</h3> +<paragraph role="paragraph" id="par_id1001240" xml-lang="en-US">Three options are available:</paragraph> +<list type="unordered"> + <listitem> + <paragraph id="par_id3155879" role="listitem" xml-lang="en-US"><emph>Move the contents of the hidden cells into the first cell</emph>: <ahelp hid=".">The actual contents of the hidden cells are concatenated to the first cell, and hidden cells are emptied; the results of formulas referring to the hidden cells or the first cell will be updated.</ahelp></paragraph> + </listitem> + <listitem> + <paragraph id="par_id3155878" role="listitem" xml-lang="en-US"><emph>Keep the contents of the hidden cells</emph>: <ahelp hid=".">The contents of the hidden cells are kept; the results of formulas referring to the hidden cells will not change.</ahelp></paragraph> + </listitem> + <listitem> + <paragraph id="par_id3155877" role="listitem" xml-lang="en-US"><emph>Empty the contents of the hidden cells</emph>: <ahelp hid=".">The contents of the hidden cells are removed; the results of formulas referring to the hidden cells will be updated.</ahelp></paragraph> + </listitem> +</list> +</section> +<section id="relatedtopics"> +<embed href="text/shared/01/05100100.xhp#mergecells"/> +<embed href="text/shared/01/05100200.xhp#unmergecells"/> +<embed href="text/scalc/guide/table_cellmerge.xhp#table_cellmerge"/> +<embed href="text/scalc/guide/cellreferences.xhp#cellreferences"/> +</section> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/05070000.xhp b/helpcontent2/source/text/scalc/01/05070000.xhp new file mode 100644 index 000000000..d4d81913a --- /dev/null +++ b/helpcontent2/source/text/scalc/01/05070000.xhp @@ -0,0 +1,53 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . + --> +<helpdocument version="1.0"> +<meta> +<topic id="textscalc0105070000xml" indexer="include" status="PUBLISH"> +<title xml-lang="en-US" id="tit">Page Style</title> +<filename>/text/scalc/01/05070000.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +</history> +</meta> +<body> +<bookmark xml-lang="en-US" branch="index" id="bm_id651593596384469"> +<bookmark_value>style;page</bookmark_value> +<bookmark_value>page;style</bookmark_value> +<bookmark_value>format;page</bookmark_value> +<bookmark_value>formatting;page</bookmark_value> +</bookmark> +<bookmark branch="hid/.uno:PageFormatDialog" xml-lang="en-US" id="bm_id3153561" localize="false"/> +<section id="pagestyle"> +<h1 id="hd_id3157910"><link href="text/scalc/01/05070000.xhp" name="Page Style">Page Style</link></h1> +<paragraph role="paragraph" id="par_id3156023" xml-lang="en-US"><variable id="seitetext"><ahelp hid=".uno:PageFormatDialog" visibility="visible">Opens a dialog where you can define the appearance of all pages in your document.</ahelp></variable></paragraph> +</section> +<section id="howtoget"> + <embed href="text/swriter/00/00000405.xhp#formatpage"/> +</section> + <embed href="text/shared/01/05040100.xhp#organizer"/> + <embed href="text/shared/01/05040200.xhp#page"/> + <embed href="text/shared/01/05030500.xhp#borders"/> + <embed href="text/shared/01/05210100.xhp#area"/> + <embed href="text/shared/01/05040300.xhp#header"/> + <embed href="text/shared/01/05040400.xhp#footer"/> + <embed href="text/scalc/01/05070500.xhp#sheet"/> + <embed href="text/shared/00/00000001.xhp#reset2"/> + </body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/05070500.xhp b/helpcontent2/source/text/scalc/01/05070500.xhp new file mode 100644 index 000000000..9ef68735e --- /dev/null +++ b/helpcontent2/source/text/scalc/01/05070500.xhp @@ -0,0 +1,100 @@ +<?xml version="1.0" encoding="UTF-8"?> + + + +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . + --> + + + <helpdocument version="1.0"> +<meta> +<topic id="textscalc0105070500xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Sheet</title> +<filename>/text/scalc/01/05070500.xhp</filename> +</topic> +</meta> +<body> +<section id="sheet"> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/sheetprintpage/SheetPrintPage" id="bm_id3147335" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/sheetprintpage/@@nowidget@@" id="bm_id3147335" localize="false"/> +<bookmark xml-lang="en-US" branch="index" id="bm_id3150542"><bookmark_value>pages; order when printing</bookmark_value> +<bookmark_value>printing; page order</bookmark_value> +</bookmark><comment>mw deletes three "printing;..." entries and copies 4 index entries to Calc guide print_details.xhp</comment><paragraph role="heading" id="hd_id3156329" xml-lang="en-US" level="1"><link href="text/scalc/01/05070500.xhp" name="Sheet">Sheet</link></paragraph> +<paragraph role="paragraph" id="par_id3151384" xml-lang="en-US"><ahelp hid="modules/scalc/ui/sheetprintpage/SheetPrintPage">Specifies the elements to be included in the printout of all sheets with the current Page Style. Additionally, you can set the print order, the first page number, and the page scale.</ahelp></paragraph> +</section> +<section id="howtoget"> + <embed href="text/scalc/00/00000405.xhp#fostel"/> +</section> +<paragraph role="heading" id="hd_id3150542" xml-lang="en-US" level="2">Print</paragraph> +<paragraph role="paragraph" id="par_id3125863" xml-lang="en-US">Defines which elements of the spreadsheet are to be printed.</paragraph> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/sheetprintpage/checkBTN_HEADER" id="bm_id3150767" localize="false"/><paragraph role="heading" id="hd_id3151041" xml-lang="en-US" level="3">Column and row headers</paragraph> +<paragraph role="paragraph" id="par_id3147228" xml-lang="en-US"><ahelp hid="modules/scalc/ui/sheetprintpage/checkBTN_HEADER">Specifies whether you want the column and row headers to be printed.</ahelp></paragraph> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/sheetprintpage/checkBTN_GRID" id="bm_id3154320" localize="false"/><paragraph role="heading" id="hd_id3150439" xml-lang="en-US" level="3">Grid</paragraph> +<paragraph role="paragraph" id="par_id3147436" xml-lang="en-US"><ahelp hid="modules/scalc/ui/sheetprintpage/checkBTN_GRID">Prints out the borders of the individual cells as a grid.</ahelp> For the view on screen, make your choice under <switchinline select="sys"><caseinline select="MAC"><emph>%PRODUCTNAME - Preferences</emph></caseinline><defaultinline><emph>Tools - Options</emph></defaultinline></switchinline><emph> - %PRODUCTNAME Calc</emph> - <link href="text/shared/optionen/01060100.xhp" name="View"><emph>View</emph></link> - <emph>Grid lines</emph>.</paragraph> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/sheetprintpage/checkBTN_NOTES" id="bm_id3159153" localize="false"/><paragraph role="heading" id="hd_id3145750" xml-lang="en-US" level="3">Comments</paragraph> +<paragraph role="paragraph" id="par_id3150010" xml-lang="en-US"><ahelp hid="modules/scalc/ui/sheetprintpage/checkBTN_NOTES">Prints the comments defined in your spreadsheet.</ahelp> They will be printed on a separate page, along with the corresponding cell reference.</paragraph> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/sheetprintpage/checkBTN_OBJECTS" id="bm_id3144764" localize="false"/><paragraph role="heading" id="hd_id3154944" xml-lang="en-US" level="3">Objects/images</paragraph> +<paragraph role="paragraph" id="par_id3149581" xml-lang="en-US"><ahelp hid="modules/scalc/ui/sheetprintpage/checkBTN_OBJECTS">Includes all inserted objects (if printable) and graphics with the printed document.</ahelp></paragraph> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/sheetprintpage/checkBTN_CHARTS" id="bm_id3156283" localize="false"/><paragraph role="heading" id="hd_id3149377" xml-lang="en-US" level="3">Charts</paragraph> +<paragraph role="paragraph" id="par_id3148455" xml-lang="en-US"><ahelp hid="modules/scalc/ui/sheetprintpage/checkBTN_CHARTS">Prints the charts that have been inserted into your spreadsheet.</ahelp></paragraph> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/sheetprintpage/checkBTN_DRAWINGS" id="bm_id3153839" localize="false"/><paragraph role="heading" id="hd_id3153418" xml-lang="en-US" level="3">Drawing Objects</paragraph> +<paragraph role="paragraph" id="par_id3149122" xml-lang="en-US"><ahelp hid="modules/scalc/ui/sheetprintpage/checkBTN_DRAWINGS">Includes all drawing objects in the printed document.</ahelp></paragraph> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/sheetprintpage/checkBTN_FORMULAS" id="bm_id3155765" localize="false"/><paragraph role="heading" id="hd_id3150330" xml-lang="en-US" level="3">Formulas</paragraph> +<paragraph role="paragraph" id="par_id3153715" xml-lang="en-US"><ahelp hid="modules/scalc/ui/sheetprintpage/checkBTN_FORMULAS">Prints the formulas contained in the cells, instead of the results.</ahelp></paragraph> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/sheetprintpage/checkBTN_NULLVALS" id="bm_id3146314" localize="false"/><paragraph role="heading" id="hd_id3156385" xml-lang="en-US" level="3">Zero Values</paragraph> +<paragraph role="paragraph" id="par_id3149258" xml-lang="en-US"><ahelp hid="modules/scalc/ui/sheetprintpage/checkBTN_NULLVALS">Specifies that cells with a zero value are printed.</ahelp></paragraph> +<paragraph role="heading" id="hd_id3154022" xml-lang="en-US" level="2">Page Order</paragraph> +<paragraph role="paragraph" id="par_id3166423" xml-lang="en-US">Defines the order in which data in a sheet is numbered and printed when it does not fit on one printed page.</paragraph> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/sheetprintpage/radioBTN_TOPDOWN" id="bm_id3145258" localize="false"/><paragraph role="heading" id="hd_id3152580" xml-lang="en-US" level="3">Top to bottom, then right</paragraph> +<paragraph role="paragraph" id="par_id3150205" xml-lang="en-US"><ahelp hid="modules/scalc/ui/sheetprintpage/radioBTN_TOPDOWN">Prints vertically from the left column to the bottom of the sheet.</ahelp></paragraph> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/sheetprintpage/radioBTN_LEFTRIGHT" id="bm_id3150342" localize="false"/><paragraph role="heading" id="hd_id3150786" xml-lang="en-US" level="3">Left to right, then down</paragraph> +<paragraph role="paragraph" id="par_id3154657" xml-lang="en-US"><ahelp hid="modules/scalc/ui/sheetprintpage/radioBTN_LEFTRIGHT">Prints horizontally from the top row of the sheet to the right column.</ahelp></paragraph> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/sheetprintpage/checkBTN_PAGENO" id="bm_id3150367" localize="false"/><paragraph role="heading" id="hd_id3150887" xml-lang="en-US" level="3">First page number</paragraph> +<paragraph role="paragraph" id="par_id3155378" xml-lang="en-US"><ahelp hid="modules/scalc/ui/sheetprintpage/checkBTN_PAGENO">Select this option if you want this style to restart page numbering.</ahelp></paragraph> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/sheetprintpage/spinED_PAGENO" id="bm_id3156288" localize="false"/><paragraph role="paragraph" id="par_id3145389" xml-lang="en-US"><ahelp hid="modules/scalc/ui/sheetprintpage/spinED_PAGENO">Enter the number you want to restart at.</ahelp></paragraph> +<paragraph role="heading" id="hd_id3146978" xml-lang="en-US" level="2">Scale</paragraph> +<paragraph role="paragraph" id="par_id3149408" xml-lang="en-US">Defines a page scale for the printed spreadsheet.</paragraph> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/sheetprintpage/comboLB_SCALEMODE" id="bm_id8574175" localize="false"/><paragraph role="heading" id="par_idN1096D" xml-lang="en-US" level="3">Scaling mode</paragraph> +<paragraph role="paragraph" id="par_idN10971" xml-lang="en-US"><ahelp hid="modules/scalc/ui/sheetprintpage/comboLB_SCALEMODE">Select a scaling mode from the list box. Appropriate controls will be shown below the list box.</ahelp></paragraph> +<paragraph role="heading" id="hd_id3155089" xml-lang="en-US" level="4">Reduce/enlarge printout</paragraph> +<paragraph role="paragraph" id="par_id3159171" xml-lang="en-US">Specifies a scaling factor to scale all printed pages.</paragraph> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/sheetprintpage/spinED_SCALEALL" id="bm_id3153067" localize="false"/><paragraph role="heading" id="par_idN1099A" xml-lang="en-US" level="5">Scaling factor</paragraph> +<paragraph role="paragraph" id="par_id3152899" xml-lang="en-US"><ahelp hid="modules/scalc/ui/sheetprintpage/spinED_SCALEALL">Enter a scaling factor. Factors less than 100 reduce the pages, higher factors enlarge the pages.</ahelp></paragraph> +<paragraph role="heading" id="par_idN109B2" xml-lang="en-US" level="4">Fit print range(s) to width/height</paragraph> +<paragraph role="paragraph" id="par_idN109B5" xml-lang="en-US">Specifies the maximum number of pages horizontally (width) and vertically (height) on which every sheet with the current Page Style is to be printed. </paragraph> +<list type="unordered"> +<listitem> +<paragraph role="paragraph" id="par_idN109BB" xml-lang="en-US">The print ranges are always scaled proportionally, so the resulting number of pages may be less than specified.</paragraph> +</listitem> +<listitem> +<paragraph role="paragraph" id="par_idN109BF" xml-lang="en-US">You may disable one of the boxes, then the unspecified dimension will use as many pages as necessary.</paragraph> +</listitem> +<listitem> +<paragraph role="paragraph" id="par_idN109C3" xml-lang="en-US">If you disable both boxes, this will result in a scaling factor of 100%.</paragraph> +</listitem> +</list> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/sheetprintpage/spinED_SCALEPAGEWIDTH" id="bm_id7740714" localize="false"/><paragraph role="heading" id="par_idN109CE" xml-lang="en-US" level="5">Width in pages</paragraph> +<paragraph role="paragraph" id="par_idN109D1" xml-lang="en-US"><ahelp hid="modules/scalc/ui/sheetprintpage/spinED_SCALEPAGEWIDTH">Enter the maximum number of pages to be printed horizontally across.</ahelp></paragraph> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/sheetprintpage/spinED_SCALEPAGEHEIGHT" id="bm_id516983" localize="false"/><paragraph role="heading" id="par_idN109E8" xml-lang="en-US" level="5">Height in pages</paragraph> +<paragraph role="paragraph" id="par_idN109EB" xml-lang="en-US"><ahelp hid="modules/scalc/ui/sheetprintpage/spinED_SCALEPAGEHEIGHT">Enter the maximum number of pages to be printed vertically stacked.</ahelp></paragraph> +<paragraph role="heading" id="hd_id3148868" xml-lang="en-US" level="4">Fit print range(s) on number of pages</paragraph> +<paragraph role="paragraph" id="par_id3145074" xml-lang="en-US">Specifies the maximum number of pages on which every sheet with the current Page Style is to be printed. The scale will be reduced as necessary to fit the defined number of pages.<comment>UFI: fixes #112585#</comment></paragraph> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/sheetprintpage/spinED_SCALEPAGENUM" id="bm_id3157983" localize="false"/><paragraph role="heading" id="par_idN10A26" xml-lang="en-US" level="5">Number of pages</paragraph> +<paragraph role="paragraph" id="par_id3144507" xml-lang="en-US"><ahelp hid="modules/scalc/ui/sheetprintpage/spinED_SCALEPAGENUM">Enter the maximum number of pages to be printed.</ahelp></paragraph> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/05080000.xhp b/helpcontent2/source/text/scalc/01/05080000.xhp new file mode 100644 index 000000000..9ee25b7ab --- /dev/null +++ b/helpcontent2/source/text/scalc/01/05080000.xhp @@ -0,0 +1,48 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . + --> + +<helpdocument version="1.0"> +<meta> +<topic id="textscalc0105080000xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Print Ranges</title> +<filename>/text/scalc/01/05080000.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +</history> +</meta> +<body> +<bookmark xml-lang="en-US" branch="hid/.uno:PrintRangesMenu" id="bm_id4606769" localize="false"/> +<section id="printranges"> +<paragraph role="heading" id="hd_id3154013" xml-lang="en-US" level="1"><link href="text/scalc/01/05080000.xhp" name="Print Ranges">Print Ranges</link></paragraph> +<paragraph role="paragraph" id="par_id3155855" xml-lang="en-US"><ahelp hid=".">Manages print ranges. Only cells within the print ranges will be printed.</ahelp></paragraph> +</section> +<section id="howtoget"> + <embed href="text/scalc/00/00000405.xhp#fodrbe"/> +</section> +<paragraph role="note" id="par_id3146119" xml-lang="en-US">If you do not define any print range manually, Calc assigns an automatic print range to include all the cells that are not empty.</paragraph> +<embed href="text/scalc/01/05080100.xhp#define"/> +<embed href="text/scalc/01/05080400.xhp#add"/> +<embed href="text/scalc/01/05080200.xhp#clear"/> +<paragraph role="heading" id="hd_id3154729" xml-lang="en-US" level="2"><link href="text/scalc/01/05080300.xhp" name="Edit">Edit</link></paragraph> +<embed href="text/scalc/01/05080300.xhp#printrangestext"/> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/05080100.xhp b/helpcontent2/source/text/scalc/01/05080100.xhp new file mode 100644 index 000000000..d7645a6c5 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/05080100.xhp @@ -0,0 +1,42 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . + --> + +<helpdocument version="1.0"> +<meta> +<topic id="textscalc0105080100xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Define</title> +<filename>/text/scalc/01/05080100.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +</history> +</meta> +<body> +<section id="define"> +<bookmark xml-lang="en-US" branch="hid/.uno:DefinePrintArea" id="bm_id3153561" localize="false"/> +<paragraph role="heading" id="hd_id3145673" xml-lang="en-US" level="1"><link href="text/scalc/01/05080100.xhp" name="Define">Define</link></paragraph> +<paragraph role="paragraph" id="par_id3153896" xml-lang="en-US"><ahelp hid=".uno:DefinePrintArea">Defines an active cell or selected cell area as the print range.</ahelp></paragraph> +</section> +<section id="howtoget"> + <embed href="text/scalc/00/00000405.xhp#fodrfe"/> +</section> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/05080200.xhp b/helpcontent2/source/text/scalc/01/05080200.xhp new file mode 100644 index 000000000..cfd348d95 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/05080200.xhp @@ -0,0 +1,42 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . + --> + +<helpdocument version="1.0"> +<meta> +<topic id="textscalc0105080200xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Clear</title> +<filename>/text/scalc/01/05080200.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +</history> +</meta> +<body> +<section id="clear"> +<bookmark xml-lang="en-US" branch="hid/.uno:DeletePrintArea" id="bm_id3150275" localize="false"/> +<paragraph role="heading" id="hd_id3153562" xml-lang="en-US" level="1"><link href="text/scalc/01/05080200.xhp" name="Clear">Clear</link></paragraph> +<paragraph role="paragraph" id="par_id3148550" xml-lang="en-US"><ahelp hid=".uno:DeletePrintArea">Removes the defined print area.</ahelp></paragraph> +</section> +<section id="howtoget"> + <embed href="text/scalc/00/00000405.xhp#fodbah"/> +</section> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/05080300.xhp b/helpcontent2/source/text/scalc/01/05080300.xhp new file mode 100644 index 000000000..73e4084c4 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/05080300.xhp @@ -0,0 +1,63 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> + +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . + --> + + +<meta> +<topic id="textscalc0105080300xml" indexer="include"> +<title id="tit" xml-lang="en-US">Edit Print Ranges</title> +<filename>/text/scalc/01/05080300.xhp</filename> +</topic> +</meta> +<body> +<bookmark xml-lang="en-US" branch="hid/.uno:EditPrintArea" id="bm_id2248794" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/printareasdialog/PrintAreasDialog" id="bm_id3145673" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/printareasdialog/@@nowidget@@" id="bm_id3145673" localize="false"/> +<paragraph role="heading" id="hd_id3153088" xml-lang="en-US" level="1">Edit Print Ranges</paragraph> +<paragraph role="paragraph" id="par_id3159488" xml-lang="en-US"><variable id="printrangestext"><ahelp hid=".uno:EditPrintArea">Opens a dialog where you can specify the print range.</ahelp> +</variable> You can also set the rows or columns which are to be repeated in every page.</paragraph> +<section id="howtoget"> +<embed href="text/scalc/00/00000405.xhp#fodbbe"/> +</section> +<embed href="text/scalc/guide/print_title_row.xhp#print_title_row"/> +<paragraph role="paragraph" id="par_idN105AE" xml-lang="en-US" localize="false"> + <embedvar href="text/scalc/guide/printranges.xhp#printranges"/> +</paragraph> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/printareasdialog/lbprintarea" id="bm_id3154910" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/printareasdialog/edprintarea" id="bm_id3150447" localize="false"/> +<paragraph role="heading" id="hd_id3156281" xml-lang="en-US" level="2">Print range</paragraph> +<paragraph role="paragraph" id="par_id3147228" xml-lang="en-US"><ahelp hid="modules/scalc/ui/printareasdialog/edprintarea">Allows you to modify a defined print range.</ahelp></paragraph> +<paragraph role="paragraph" id="par_id3145174" xml-lang="en-US">Select <emph>-none-</emph> to remove a print range definition for the current spreadsheet. Select <emph>-entire sheet-</emph> to set the current sheet as a print range. Select <emph>-selection-</emph> to define the selected area of a spreadsheet as the print range. By selecting <emph>-user-defined-</emph>, you can define a print range that you have already defined using the <emph>Format - Print Ranges - Define</emph> command. If you have given a name to a range using the <emph>Sheet - Named Ranges and Expressions - Define</emph> command, this name will be displayed and can be selected from the list box.</paragraph> +<paragraph role="paragraph" id="par_id3145272" xml-lang="en-US">In the right-hand text box, you can enter a print range by reference or by name. If the cursor is in the <emph>Print range</emph> text box, you can also select the print range in the spreadsheet with your mouse.</paragraph> +<embed href="text/shared/00/00000001.xhp#shrink_maximize"/> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/printareasdialog/lbrepeatrow" id="bm_id3147435" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/printareasdialog/edrepeatrow" id="bm_id3153190" localize="false"/> +<paragraph role="heading" id="hd_id3149260" xml-lang="en-US" level="2">Rows to repeat</paragraph> +<paragraph role="paragraph" id="par_id3147426" xml-lang="en-US"><ahelp hid="modules/scalc/ui/printareasdialog/edrepeatrow">Choose one or more rows to print on every page. In the right text box enter the row reference, for example, "1" or "$1" or "$2:$3".</ahelp> The list box displays <emph>-user defined-</emph>. You can also select <emph>-none-</emph> to remove a defined repeating row.</paragraph> +<paragraph role="paragraph" id="par_id3155418" xml-lang="en-US">You can also define repeating rows by dragging the mouse in the spreadsheet, if the cursor is in the <emph>Rows to repeat</emph> text field in the dialog.</paragraph> +<embed href="text/shared/00/00000001.xhp#shrink_maximize"/> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/printareasdialog/lbrepeatcol" id="bm_id3153876" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/printareasdialog/edrepeatcol" id="bm_id3147396" localize="false"/> +<paragraph role="heading" id="hd_id3149581" xml-lang="en-US" level="2">Columns to repeat</paragraph> +<paragraph role="paragraph" id="par_id3155602" xml-lang="en-US"><ahelp hid="modules/scalc/ui/printareasdialog/edrepeatcol">Choose one or more columns to print on every page. In the right text box enter the column reference, for example, "A" or "AB" or "$C:$E".</ahelp> The list box then displays <emph>-user defined-</emph>. You can also select <emph>-none-</emph> to remove a defined repeating column.</paragraph> +<paragraph role="paragraph" id="par_id3150749" xml-lang="en-US">You can also define repeating columns by dragging the mouse in the spreadsheet, if the cursor is in the <emph>Columns to repeat</emph> text field in the dialog.</paragraph> +<embed href="text/shared/00/00000001.xhp#shrink_maximize"/> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/05080400.xhp b/helpcontent2/source/text/scalc/01/05080400.xhp new file mode 100644 index 000000000..0068cf860 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/05080400.xhp @@ -0,0 +1,42 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . + --> + +<helpdocument version="1.0"> +<meta> +<topic id="textscalc0105080400xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Add</title> +<filename>/text/scalc/01/05080400.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +</history> +</meta> +<body> +<section id="add"> +<bookmark xml-lang="en-US" branch="hid/.uno:AddPrintArea" id="bm_id3150543" localize="false"/> +<paragraph role="heading" id="hd_id3149457" xml-lang="en-US" level="1"><link href="text/scalc/01/05080400.xhp" name="Add">Add</link></paragraph> +<paragraph role="paragraph" id="par_id3156423" xml-lang="en-US"><ahelp hid=".uno:AddPrintArea">Adds the current selection to the defined print areas.</ahelp></paragraph> +</section> +<section id="howtoget"> + <embed href="text/scalc/00/00000405.xhp#fodrhin"/> +</section> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/05100000.xhp b/helpcontent2/source/text/scalc/01/05100000.xhp new file mode 100644 index 000000000..c99bafcbe --- /dev/null +++ b/helpcontent2/source/text/scalc/01/05100000.xhp @@ -0,0 +1,165 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . +--> + +<meta> + <topic id="textscalc0105100000xml" indexer="include" status="PUBLISH"> + <title id="tit" xml-lang="en-US">Styles in Calc</title> + <filename>/text/scalc/01/05100000.xhp</filename> + </topic> +</meta> + +<body> + +<section id="styles_and_formatting"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3150447"> +<bookmark_value>Stylist, see Styles window</bookmark_value> +<bookmark_value>Styles window</bookmark_value> +<bookmark_value>formats; Styles window</bookmark_value> +<bookmark_value>formatting; Styles window</bookmark_value> +<bookmark_value>paint can for applying styles</bookmark_value> +<bookmark_value>styles in spreadsheets</bookmark_value> +<bookmark_value>styles; in Calc</bookmark_value> +</bookmark> + +<h1 id="hd_id3150447"><link href="text/scalc/01/05100000.xhp" name="Styles">Styles</link></h1> +<paragraph id="par_id3147434" role="paragraph" xml-lang="en-US">Use the Styles deck of the Sidebar to assign styles to cells and pages. You can apply, update, and modify existing styles or create new styles.</paragraph> +</section> +<paragraph id="par_id3149665" role="paragraph" xml-lang="en-US">The Styles <link href="text/shared/00/00000005.xhp#docking" name="dockable window">dockable window</link> can remain open while editing the document.</paragraph> + +<section id="howtoget"> +<embed href="text/shared/00/00040500.xhp#stylewindow"/> +</section> + +<h2 id="hd_id3150012">How to apply a cell style:</h2> + +<list type="ordered"> + <listitem> + <paragraph id="par_id3159155" role="listitem" xml-lang="en-US">Select the cell or cell range.</paragraph> + </listitem> + <listitem> + <paragraph id="par_id3145749" role="listitem" xml-lang="en-US">Double-click the style in the Styles window.</paragraph> + </listitem> +</list> + +<embed href="text/scalc/01/cell_styles.xhp#cellstyleh1"/> +<paragraph id="par_id3145801" role="paragraph" xml-lang="en-US"><ahelp hid=".">Displays the list of the available Cell Styles.</ahelp></paragraph> +<table id="tbl_id3155602"> + <tablerow> + <tablecell> + <paragraph id="par_id3150751" role="paragraph" xml-lang="en-US"> <image id="img_id3153714" src="sc/res/sf01.png" width="1cm" height="1cm"><alt xml-lang="en-US" id="alt_id3153714">Icon Cell Styles</alt></image></paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3154255" role="paragraph" xml-lang="en-US">Cell Styles</paragraph> + </tablecell> + </tablerow> +</table> + +<bookmark xml-lang="en-US" branch="hid/.uno:PageStyle" id="bm_id3839136" localize="false"/> + +<h2 id="hd_id171593598056580"><link href="text/scalc/01/05070000.xhp" name="page styles">Page Styles</link></h2> +<paragraph id="par_id3147003" role="paragraph" xml-lang="en-US"><ahelp hid=".">Displays the Page Styles available.</ahelp></paragraph> + +<table id="tbl_id3145791"> + <tablerow> + <tablecell> + <paragraph id="par_id3159100" role="paragraph" xml-lang="en-US"> <image id="img_id3149814" src="sw/res/sf04.png" width="1cm" height="1cm"><alt xml-lang="en-US" id="alt_id3149814">Icon Page Styles</alt></image></paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3150361" role="paragraph" xml-lang="en-US">Page Styles</paragraph> + </tablecell> + </tablerow> +</table> + +<bookmark xml-lang="en-US" branch="hid/SFX2_HID_TEMPLDLG_WATERCAN" id="bm_id3150370" localize="false"/> + +<h2 id="hd_id3150202">Fill Format Mode</h2> +<paragraph id="par_id3155531" role="paragraph" xml-lang="en-US"><ahelp hid="SFX2_HID_TEMPLDLG_WATERCAN">Turns the Fill Format mode on and off. Use the paint can to assign the Style selected in the Styles window.</ahelp></paragraph> + +<table id="tbl_id3156445"> + <tablerow> + <tablecell> + <paragraph id="par_id3155087" role="paragraph" xml-lang="en-US"> <image id="img_id3153068" src="cmd/sc_fillstyle.png" width="1cm" height="1cm"><alt xml-lang="en-US" id="alt_id3153068">Icon Fill Format Mode</alt></image></paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3156198" role="paragraph" xml-lang="en-US">Fill Format Mode</paragraph> + </tablecell> + </tablerow> +</table> + +<h2 id="hd_id3148870">How to apply a new style with the paint can:</h2> + +<list type="ordered"> + <listitem> + <paragraph id="par_id3145078" role="listitem" xml-lang="en-US">Select the desired style from the Styles window.</paragraph> + </listitem> + <listitem> + <paragraph id="par_id3159098" role="listitem" xml-lang="en-US">Click the <emph>Fill Format Mode</emph> icon.</paragraph> + </listitem> + <listitem> + <paragraph id="par_id3148609" role="listitem" xml-lang="en-US">Click a cell to format it, or drag your mouse over a certain range to format the whole range. Repeat this action for other cells and ranges.</paragraph> + </listitem> + <listitem> + <paragraph id="par_id3149438" role="listitem" xml-lang="en-US">Click the <emph>Fill Format Mode</emph> icon again to exit this mode.</paragraph> + </listitem> +</list> +<bookmark xml-lang="en-US" branch="hid/SFX2_HID_TEMPLDLG_NEWBYEXAMPLE" id="bm_id3150891" localize="false"/> + +<h2 id="hd_id3153975">New Style from Selection</h2> +<paragraph id="par_id3149499" role="paragraph" xml-lang="en-US"><ahelp hid="SFX2_HID_TEMPLDLG_NEWBYEXAMPLE">Creates a new style based on the formatting of a selected object.</ahelp> Assign a name for the style in the <link href="text/shared/01/05140100.xhp" name="Create Style">Create Style</link> dialog.</paragraph> + +<table id="tbl_id3152873"> + <tablerow> + <tablecell> + <paragraph id="par_id3150050" role="paragraph" xml-lang="en-US"> <image id="img_id3154649" src="cmd/sc_stylenewbyexample.png" width="1cm" height="1cm"><alt xml-lang="en-US" id="alt_id3154649">Icon New Style from Selection</alt></image></paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3146963" role="paragraph" xml-lang="en-US">New Style from Selection</paragraph> + </tablecell> + </tablerow> +</table> + +<bookmark xml-lang="en-US" branch="hid/SFX2_HID_TEMPLDLG_UPDATEBYEXAMPLE" id="bm_id3153486" localize="false"/> + +<h2 id="hd_id3153813">Update Style</h2> +<paragraph id="par_id3154707" role="paragraph" xml-lang="en-US"><ahelp hid="SFX2_HID_TEMPLDLG_UPDATEBYEXAMPLE">Updates the Style selected in the Styles window with the current formatting of the selected object.</ahelp></paragraph> + +<table id="tbl_id3149317"> + <tablerow> + <tablecell> + <paragraph id="par_id3145118" role="paragraph" xml-lang="en-US"> <image id="img_id3155754" src="cmd/sc_styleupdatebyexample.png" width="1cm" height="1cm"><alt xml-lang="en-US" id="alt_id3155754">Icon Update Style</alt></image></paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3147501" role="paragraph" xml-lang="en-US">Update Style</paragraph> + </tablecell> + </tablerow> +</table> + +<bookmark xml-lang="en-US" branch="hid/SFX2_HID_TEMPLATE_FMT" id="bm_id3147436" localize="false"/> + +<h2 id="par_idN109BE">Style List</h2> +<paragraph id="par_idN109C2" role="paragraph" xml-lang="en-US"><ahelp hid="SFX2_HID_TEMPLATE_FMT">Displays the list of the styles from the selected style category.</ahelp></paragraph> +<paragraph id="par_idN109D1" role="paragraph" xml-lang="en-US">In the <link href="text/shared/00/00000005.xhp#contextmenu" name="context menu">context menu</link> you can choose commands to create a new style, delete a user-defined style, or change the selected style.</paragraph> +<bookmark xml-lang="en-US" branch="hid/SFX2_HID_TEMPLATE_FILTER" id="bm_id3151339" localize="false"/> + +<h2 id="hd_id3149053">Style Groups<comment>UFI: use "groups" to be consistent with Writer</comment></h2> +<paragraph id="par_id3147299" role="paragraph" xml-lang="en-US"><ahelp hid="SFX2_HID_TEMPLATE_FILTER">Lists the available style groups.</ahelp></paragraph> +</body> + +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/05110000.xhp b/helpcontent2/source/text/scalc/01/05110000.xhp new file mode 100644 index 000000000..2fe12c538 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/05110000.xhp @@ -0,0 +1,78 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . + --> + +<meta> + <topic id="textscalc0105110000xml" indexer="include"> + <title id="tit" xml-lang="en-US">AutoFormat</title> + <filename>/text/scalc/01/05110000.xhp</filename> + </topic> +</meta> + +<body> + <bookmark xml-lang="en-US" branch="hid/.uno:AutoFormat" id="bm_id9247611" localize="false"/> + <bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/autoformattable/AutoFormatTableDialog" id="bm_id2998138" localize="false"/> + <bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/autoformattable/@@nowidget@@" id="bm_id2998138" localize="false"/> + <h1 id="hd_id3149666"><variable id="autoformat"><link href="text/scalc/01/05110000.xhp" name="AutoFormat">AutoFormat</link></variable></h1> + <paragraph role="paragraph" id="par_id3145367" xml-lang="en-US"><variable id="autoformattext"><ahelp hid=".">Use this command to apply an AutoFormat to a selected sheet area or to define your own AutoFormats.</ahelp></variable></paragraph> + <section id="howtoget"> + <embed href="text/scalc/00/00000405.xhp#autoformat"/> + </section> + <note id="par_id181630332690300">The AutoFormat command is available only if a cell range with at least 3 columns and 3 rows are selected. Otherwise this command will appear grayed out in the menu.</note> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/autoformattable/formatlb" id="bm_id3145645" localize="false"/> +<paragraph role="heading" id="hd_id3148455" xml-lang="en-US" level="2">Format</paragraph> +<paragraph role="paragraph" id="par_id3145799" xml-lang="en-US"><ahelp hid="modules/scalc/ui/autoformattable/formatlb">Choose a predefined AutoFormat to apply to a selected area in your sheet.</ahelp></paragraph> +<embed href="text/shared/00/00000001.xhp#preview_field"/> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/autoformattable/add" id="bm_id3155600" localize="false"/> +<paragraph role="heading" id="hd_id3149410" xml-lang="en-US" level="2">Add</paragraph> +<paragraph role="paragraph" id="par_id3154017" xml-lang="en-US"><ahelp hid="modules/scalc/ui/autoformattable/add">Allows you to add the current formatting of a range of at least 4 x 4 cells to the list of predefined AutoFormats.</ahelp> The <emph>Add AutoFormat</emph> dialog then appears.</paragraph> +<bookmark xml-lang="en-US" branch="hid/SC_HID_SC_AUTOFMT_NAME" id="bm_id3153713" localize="false"/> +<paragraph role="paragraph" id="par_id3153708" xml-lang="en-US"><ahelp hid=".">Enter a name and click <emph>OK</emph>. </ahelp></paragraph> +<embed href="text/shared/00/00000001.xhp#delete"/> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/autoformattable/rename" id="bm_id3153309" localize="false"/> +<paragraph role="heading" id="hd_id3159223" xml-lang="en-US" level="2">Rename</paragraph> +<paragraph role="paragraph" id="par_id3153064" xml-lang="en-US"><ahelp hid=".">Opens a dialog where you can change the name of the selected AutoFormat.</ahelp></paragraph> +<bookmark xml-lang="en-US" branch="hid/SC_HID_SC_REN_AFMT_NAME" id="bm_id3148608" localize="false"/> +<paragraph role="paragraph" id="par_id3153912" xml-lang="en-US">The <emph>Rename AutoFormat</emph> dialog opens.<ahelp hid="."> Enter the new name of the AutoFormat here.</ahelp></paragraph> + +<paragraph role="heading" id="hd_id3155961" xml-lang="en-US" level="3">Formatting</paragraph> +<paragraph role="paragraph" id="par_id3153965" xml-lang="en-US">In this section you can select or deselect the available formatting options. If you want to keep any of the settings currently in your spreadsheet, deselect the corresponding option.</paragraph> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/autoformattable/numformatcb" id="bm_id3149210" localize="false"/> +<paragraph role="heading" id="hd_id3154021" xml-lang="en-US" level="3">Number format</paragraph> +<paragraph role="paragraph" id="par_id3159239" xml-lang="en-US"><ahelp hid="modules/scalc/ui/autoformattable/numformatcb">When marked, specifies that you want to retain the number format of the selected format.</ahelp></paragraph> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/autoformattable/bordercb" id="bm_id3150206" localize="false"/> +<paragraph role="heading" id="hd_id3149530" xml-lang="en-US" level="3">Borders</paragraph> +<paragraph role="paragraph" id="par_id3145259" xml-lang="en-US"><ahelp hid="modules/scalc/ui/autoformattable/bordercb">When marked, specifies that you want to retain the border of the selected format.</ahelp></paragraph> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/autoformattable/fontcb" id="bm_id3150364" localize="false"/> +<paragraph role="heading" id="hd_id3154657" xml-lang="en-US" level="3">Font</paragraph> +<paragraph role="paragraph" id="par_id3152990" xml-lang="en-US"><ahelp hid="modules/scalc/ui/autoformattable/fontcb">When marked, specifies that you want to retain the font of the selected format.</ahelp></paragraph> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/autoformattable/patterncb" id="bm_id3150515" localize="false"/> +<paragraph role="heading" id="hd_id3155379" xml-lang="en-US" level="3">Pattern</paragraph> +<paragraph role="paragraph" id="par_id3150368" xml-lang="en-US"><ahelp hid="modules/scalc/ui/autoformattable/patterncb">When marked, specifies that you want to retain the pattern of the selected format.</ahelp></paragraph> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/autoformattable/alignmentcb" id="bm_id3146978" localize="false"/> +<paragraph role="heading" id="hd_id3146115" xml-lang="en-US" level="3">Alignment</paragraph> +<paragraph role="paragraph" id="par_id3156445" xml-lang="en-US"><ahelp hid="modules/scalc/ui/autoformattable/alignmentcb">When marked, specifies that you want to retain the alignment of the selected format.</ahelp></paragraph> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/autoformattable/autofitcb" id="bm_id3152892" localize="false"/> +<paragraph role="heading" id="hd_id3155811" xml-lang="en-US" level="3">AutoFit width and height</paragraph> +<paragraph role="paragraph" id="par_id3148703" xml-lang="en-US"><ahelp hid="modules/scalc/ui/autoformattable/autofitcb">When marked, specifies that you want to retain the width and height of the selected cells of the selected format.</ahelp></paragraph> +<section id="relatedtopics"> + <embed href="text/scalc/guide/autoformat.xhp#autoformat"/> +</section> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/05120000.xhp b/helpcontent2/source/text/scalc/01/05120000.xhp new file mode 100644 index 000000000..9abe1ee3e --- /dev/null +++ b/helpcontent2/source/text/scalc/01/05120000.xhp @@ -0,0 +1,183 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> + +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . + --> + + +<meta> + <topic id="textscalc0105120000xml" indexer="include"> + <title xml-lang="en-US" id="tit">Conditional Formatting</title> + <filename>/text/scalc/01/05120000.xhp</filename> + </topic> + </meta> + <body> +<bookmark xml-lang="en-US" branch="hid/.uno:ConditionalFormatDialog" id="bm_id5008046" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/.uno:ConditionalFormatMenu" id="bm_id5008047" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/conditionalformatdialog/ConditionalFormatDialog" id="bm_id3152518" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/conditionalformatdialog/@@nowidget@@" id="bm_id3152518" localize="false"/> +<h1 id="hd_id3155132">Conditional Formatting</h1> + <paragraph xml-lang="en-US" id="par_id3163710" role="paragraph"><variable id="bedingtetext"><ahelp hid=".">Use <emph>Conditional Formatting</emph> to define range-based conditions that determine which cell style will be applied to each cell in a given range based on its contents.</ahelp></variable> The cell style corresponding to the first condition that evaluates to <emph>true</emph> is applied. Cell styles applied through Conditional Formatting override cell styles applied manually using the <link href="text/scalc/main0202.xhp" name="FormattingBar_link"><emph>Formatting Bar</emph></link> or the <emph>Styles</emph> sidebar.</paragraph> + <section id="howtoget"> + <embed href="text/scalc/00/00000405.xhp#bedingte"/> + </section> + <paragraph xml-lang="en-US" id="par_id3163711" role="paragraph">You can enter several conditions that query the cell values or results of formulas. The conditions are evaluated from first to the last. If <emph>Condition 1</emph> is true based on the current cell contents, the corresponding cell style is applied. Otherwise, <emph>Condition 2</emph> is evaluated to determine if its corresponding style will be applied. If none of the conditions match cell contents, then no changes are made to the cell format.</paragraph> + <paragraph role="paragraph" id="par_id431642031216368">Conditional formats do no overwrite cell styles and direct formatting applied manually. They remain saved as cell properties and are applied when the cell matches no conditions or when you remove all conditional formats.</paragraph> + <warning id="par_id2414014">To apply conditional formatting, AutoCalculate must be enabled. Choose <emph>Data - Calculate - AutoCalculate</emph> (you see a check mark next to the command when AutoCalculate is enabled).</warning> +<bookmark xml-lang="en-US" branch="index" id="bm_id3153189"><bookmark_value>conditional formatting; conditions</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/conditionalformatdialog/list" id="bm_id5008050" localize="false"/> +<h2 id="hd_id71624649758112">Condition list</h2> + <paragraph xml-lang="en-US" id="par_id3149413" role="paragraph">List of the conditions defined for the cell range in order of evaluation. You can define as many conditions as you want.</paragraph> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/conditionalformatdialog/up" id="bm_id5008053" localize="false"/> +<h3 id="hd_id41624649786605">Up</h3> +<paragraph xml-lang="en-US" id="par_id3149414" role="paragraph"><ahelp hid=".">Increase priority of the selected condition.</ahelp></paragraph> + <h3 id="hd_id861624649792266">Down</h3> + <bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/conditionalformatdialog/down" id="bm_id5008054" localize="false"/> + <paragraph xml-lang="en-US" id="par_id3149415" role="paragraph"><ahelp hid=".">Decrease priority of the selected condition.</ahelp></paragraph> + +<h2 id="hd_id31531891">Condition list entry</h2> + <paragraph xml-lang="en-US" id="par_id31494132" role="paragraph">Specify if conditional formatting is dependent on one of the entry listed on the drop down box:</paragraph> + <bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/conditionalformatdialog/add" id="bm_id5008051" localize="false"/> + <bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/conditionalformatdialog/delete" id="bm_id5008052" localize="false"/> + <bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/conditionalformatdialog/edassign" id="bm_id5008055" localize="false"/> + <list type="unordered"> + <listitem> + <paragraph xml-lang="en-US" id="par_id31494133" role="listitem">If you select <emph>All cells</emph>, see Color Scale, Data Bar or Icon Set explanations below, depending on which visual representation the conditional formatting should be represented.</paragraph> + </listitem> + <listitem> + <paragraph xml-lang="en-US" id="par_id31494134" role="listitem">If you select <emph>Cell value is</emph>:</paragraph> + <switch select="sys"><comment>FIXME: Hack to get a nested list</comment><default> + <list type="unordered"> + <listitem> + <paragraph xml-lang="en-US" id="par_id31494135" role="listitem">Select a condition in the drop down list for the format to be applied to the selected cells and enter the value.</paragraph> + </listitem> + <listitem> + <paragraph xml-lang="en-US" id="par_id31494136" role="listitem">In front of <emph>Apply Styles</emph>, select the desired style in the list or chose <emph>New Style</emph> to create one.</paragraph> + </listitem> + <listitem> + <paragraph xml-lang="en-US" id="par_id31494137" role="listitem"><ahelp hid=".">Click the <emph>Add</emph> button to add another condition, click the <emph>Remove</emph> button to remove a condition.</ahelp></paragraph> + </listitem> + <listitem> + <paragraph xml-lang="en-US" id="par_id31494138" role="listitem"><ahelp hid=".">In the <emph>Range</emph> field, define the range of cells concerned by the conditional formatting.</ahelp> Click on the <emph>Shrink</emph> button to minimize the dialog box. Click again on the button to come back to the dialog box once the range is selected.</paragraph> + </listitem> + </list> + </default></switch> + </listitem> + <listitem> + <paragraph xml-lang="en-US" id="par_id31494139" role="listitem">If you select <emph>Formula is</emph> as a reference, enter a cell reference. If the cell reference is a value other than zero, the condition matches.</paragraph> + </listitem> + <listitem> + <paragraph xml-lang="en-US" id="par_id3149413a" role="listitem">If you select <emph>Date is</emph>, see below explanations for Date.</paragraph> + </listitem> + </list> + +<h2 id="hd_id3147394">Color Scale</h2> + <paragraph xml-lang="en-US" id="par_id3155602" role="paragraph">This is the same dialog box as if you select <emph>All cells</emph> in the first sub menu entry <emph>Condition</emph>. +Apply a color scale to a range consist of displaying a bicolor or tricolor gradient on this range depending on the value of each cell. A typical example might be an array of temperatures, lower blue colored, warmer red with a gradient nuances to the intermediate values.</paragraph> + <paragraph xml-lang="en-US" id="par_id3155603" role="paragraph">You must choose the two "extreme" colors indicate the method of calculation. The calculation of the color applied will be made in relation to: Min - Max - Percentile - Value - Percent - Formula.</paragraph> + <paragraph xml-lang="en-US" id="par_id3155604" role="paragraph">The choices Min and Max are sufficient to themselves as found in the range. Other options need to be specified by a value (Percentile, Value, Percentage) or a cell reference or formula (Formula).</paragraph> + <paragraph xml-lang="en-US" id="par_id3155605" role="paragraph">For a detailed explanation and examples, please visit <link href="https://wiki.documentfoundation.org/Faq/Calc/142">How to apply a Color Scale Conditional Formatting page</link> in TDF Wiki.</paragraph> + +<h2 id="par_id991609782427459">Data Bar</h2> + <paragraph role="paragraph" id="par_id41609780964157">Data bar option will fill the cell with solid or gradient color corresponding to the numeric value in the cell. Default is blue for positive and red for negative. </paragraph> + <paragraph role="paragraph" id="par_id931609781970981">The calculation of the area of fill is based on Min - Max - Percentile - Value - Percent - Formula.</paragraph> + <paragraph role="paragraph" id="par_id981609782003841">The choices Min and Max are sufficient to themselves as found in the range. Other options need to be specified by a value (Percentile, Value, Percentage) or a cell reference or formula (Formula).</paragraph> + <paragraph role="paragraph" id="par_id281609781729359"><emph>More Options...</emph> opens a dialog to: </paragraph> + <list type="unordered"> + <listitem> + <paragraph id="par_id271609781812913" role="listitem">change colors</paragraph> + </listitem> + <listitem> + <paragraph id="par_id921609781838551" role="listitem"> change position of vertical axis within the cell</paragraph> + </listitem> + <listitem> + <paragraph id="par_id631609781859971" role="listitem"> the bar's minimum and maximum length in percentage</paragraph> + </listitem> + </list> + +<h2 id="hd_id3153709">Icon Set</h2> + <paragraph xml-lang="en-US" id="par_id3153764" role="paragraph">It is desired to plot the position of a value relative to the thresholds. The set of icons will help to indicate the thresholds and choose the type of icons. Available icon sets are:</paragraph> +<list type="unordered"> +<listitem> + <paragraph xml-lang="en-US" id="par_id31494140" role="listitem">3, 4 or 5 - arrows</paragraph> +</listitem> +<listitem> + <paragraph xml-lang="en-US" id="par_id31494141" role="listitem">3, 4 or 5 - gray arrows</paragraph> +</listitem> +<listitem> + <paragraph xml-lang="en-US" id="par_id31494142" role="listitem">3 - flags</paragraph> +</listitem> +<listitem> + <paragraph xml-lang="en-US" id="par_id31494143" role="listitem">3 - traffic lights 1 and 2 (two different designs)</paragraph> +</listitem> +<listitem> + <paragraph xml-lang="en-US" id="par_id31494144" role="listitem">3 - symbols (square, triangle, circle)</paragraph> +</listitem> +<listitem> + <paragraph xml-lang="en-US" id="par_id31494145" role="listitem">4 - circles from red to black</paragraph> +</listitem> +<listitem> + <paragraph xml-lang="en-US" id="par_id31494146" role="listitem">4 or 5 - ratings</paragraph> +</listitem> +<listitem> + <paragraph xml-lang="en-US" id="par_id31494147" role="ilistitem">5 - quarters</paragraph> +</listitem> +</list> + <paragraph xml-lang="en-US" id="par_id3153765" role="paragraph">Conditions to display each icon can be specified relative to a value (Value), a percentage of the number of values in the range (Percentage) as a percentage of range values (Percentile) or formula (Formula).</paragraph> + <paragraph xml-lang="en-US" id="par_id3155606" role="paragraph">For a detailed explanation and examples, please visit <link href="https://wiki.documentfoundation.org/Faq/Calc/141">How to use Icon Set Conditional Formatting page</link> in TDF Wiki.</paragraph> + +<h2 id="hd_id3156384">Dates</h2> + <paragraph xml-lang="en-US" id="par_id3145228" role="paragraph">This option will apply a defined style depending on a date that you choose in the drop down box: Today - Yesterday - Tomorrow - Last 7 days - This week - Last week.</paragraph> +<list type="unordered"> +<listitem> + <paragraph xml-lang="en-US" id="par_id31494157" role="listitem">In front of <emph>Apply Styles</emph>, select the desired style in the list or chose <emph>New Style</emph> to create one.</paragraph> +</listitem> +<listitem> + <paragraph xml-lang="en-US" id="par_id31494167" role="listitem">Click the <emph>Add</emph> button to add another condition, click the <emph>Remove</emph> button to remove a condition.</paragraph> +</listitem> +<listitem> + <paragraph xml-lang="en-US" id="par_id31494177" role="listitem">In the <emph>Range</emph> field, define the range of cells concerned by the conditional formatting. Click on the <emph>Shrink</emph> button to minimize the dialog box. Click again on the button to come back to the dialog box once the range is selected.</paragraph> +</listitem> +</list> + +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/condformatmanager/CondFormatManager" id="bm_id3152598" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/condformatmanager/@@nowidget@@" id="bm_id3152598" localize="false"/> +<h2 id="hd_id3153384">Manage Conditional Formatting</h2> +<paragraph xml-lang="en-US" id="par_id3155906" role="paragraph"><ahelp hid=".">This dialog allows you to see all the conditional formatting defined in the spreadsheet.</ahelp></paragraph> + + <section id="howtoget"> + <paragraph role="paragraph" id="par_id31546818" xml-lang="en-US">Choose <emph>Format - Conditional Formatting - Manage</emph>.</paragraph> + </section> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/condformatmanager/add" id="bm_id3152600" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/condformatmanager/edit" id="bm_id3152601" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/condformatmanager/remove" id="bm_id3152602" localize="false"/> +<paragraph xml-lang="en-US" id="par_id3155907" role="paragraph">The <emph>Manage Conditional Formatting</emph> dialog box opens. <ahelp hid=".">Here you can add, edit or remove one or several conditional formattings.</ahelp></paragraph> + +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/condformatmanager/CONTAINER" id="bm_id3152603" localize="false"/> +<paragraph xml-lang="en-US" id="par_id3155909" role="paragraph"><ahelp hid=".">The <emph>Conditional Formats</emph> list displays the active conditional formatting rules set in the current spreadsheet.</ahelp> Only the first rule for each cell range is listed, even if there are multiple rules defined for a given range.</paragraph> + +<paragraph xml-lang="en-US" id="par_id3155908" role="paragraph">If you have defined a conditional formatting on a cell range and you try now to define a new conditional formatting on a part of this range, a warning message will be displayed, asking if you want to edit the existing conditional formatting (on the whole range) or define a new conditional formatting overlapping it (on the selected range).</paragraph> + + <section id="relatedtopics"> + <paragraph xml-lang="en-US" id="par_idN107E1" role="paragraph" localize="false"> + <embedvar href="text/scalc/guide/cellstyle_conditional.xhp#cellstyle_conditional"/> + </paragraph> + </section> + </body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/06020000.xhp b/helpcontent2/source/text/scalc/01/06020000.xhp new file mode 100644 index 000000000..f63951511 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/06020000.xhp @@ -0,0 +1,71 @@ +<?xml version="1.0" encoding="UTF-8"?> + +<helpdocument version="1.0"> + +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . + --> + + +<meta> +<topic id="textscalc0106020000xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Hyphenation</title> +<filename>/text/scalc/01/06020000.xhp</filename> +</topic> +</meta> +<body> +<bookmark xml-lang="en-US" branch="index" id="bm_id3159399"><bookmark_value>automatic hyphenation in spreadsheets</bookmark_value> +<bookmark_value>hyphenation; in spreadsheets</bookmark_value> +<bookmark_value>syllables in spreadsheets</bookmark_value> +</bookmark><comment>mw made "hyphenation..." a two level entry</comment> +<bookmark xml-lang="en-US" branch="hid/.uno:Hyphenate" id="bm_id7241058" localize="false"/> +<paragraph role="heading" id="hd_id3159399" xml-lang="en-US" level="1">Hyphenation</paragraph> +<paragraph role="paragraph" id="par_id3145068" xml-lang="en-US"><variable id="silben"><ahelp hid=".uno:Hyphenate">The <emph>Hyphenation </emph>command calls the dialog for setting the hyphenation in $[officename] Calc.</ahelp> +</variable></paragraph> +<section id="howtoget"> +<embed href="text/scalc/00/00000406.xhp#silbentrennungc"/> +</section> +<paragraph role="paragraph" id="par_id3154366" xml-lang="en-US">You can only turn on the automatic hyphenation in $[officename] Calc when the <link href="text/shared/01/05340300.xhp" name="row break">row break</link> feature is active.</paragraph> +<paragraph role="heading" id="hd_id3153192" xml-lang="en-US" level="2">Hyphenation for selected cells.</paragraph> +<list type="ordered"> +<listitem> +<paragraph role="listitem" id="par_id3150868" xml-lang="en-US">Select the cells for which you want to change the hyphenation.</paragraph> +</listitem> +<listitem> +<paragraph role="listitem" id="par_id3150440" xml-lang="en-US">Choose <emph>Tools - Language - Hyphenation</emph>.</paragraph> +</listitem> +<listitem> +<paragraph role="listitem" id="par_id3156441" xml-lang="en-US">The <emph>Format Cells</emph> dialog appears with the <emph>Alignment</emph> tab page open.</paragraph> +</listitem> +<listitem> +<paragraph role="listitem" id="par_id3149260" xml-lang="en-US">Mark the <emph>Wrap text automatically</emph> and <emph>Hyphenation active</emph> check boxes.</paragraph> +</listitem> +</list> +<paragraph role="heading" id="hd_id3153094" xml-lang="en-US" level="2">Hyphenation for Drawing Objects</paragraph> +<list type="ordered"> +<listitem> +<paragraph role="listitem" id="par_id3148577" xml-lang="en-US">Select a drawing object.</paragraph> +</listitem> +<listitem> +<paragraph role="listitem" id="par_id3156285" xml-lang="en-US">Choose <emph>Tools - Language - Hyphenation</emph>.</paragraph> +</listitem> +<listitem> +<paragraph role="listitem" id="par_id3147394" xml-lang="en-US">Each time you call the command you turn the hyphenation for the drawing object on or off. A check mark shows the current status.</paragraph> +</listitem> +</list> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/06030000.xhp b/helpcontent2/source/text/scalc/01/06030000.xhp new file mode 100644 index 000000000..c34d8ad4b --- /dev/null +++ b/helpcontent2/source/text/scalc/01/06030000.xhp @@ -0,0 +1,55 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> + +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . + --> + + +<meta> + <topic id="textscalc0106030000xml" indexer="include" status="PUBLISH"> + <title xml-lang="en-US" id="tit">Detective</title> + <filename>/text/scalc/01/06030000.xhp</filename> + </topic> + </meta> + <body> + <section id="detective"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3151245"><bookmark_value>cell links search</bookmark_value> + <bookmark_value>searching; links in cells</bookmark_value> + <bookmark_value>traces;precedents and dependents</bookmark_value> + <bookmark_value>Formula Auditing,see Detective</bookmark_value> + <bookmark_value>Detective</bookmark_value> +</bookmark><comment>MW added "Detective" and a cross-reference</comment> +<paragraph xml-lang="en-US" id="hd_id3151245" role="heading" level="1"><link href="text/scalc/01/06030000.xhp" name="Detective">Detective</link></paragraph> + <paragraph xml-lang="en-US" id="par_id3151211" role="paragraph">This command activates the Spreadsheet Detective. With the Detective, you can trace the dependencies from the current formula cell to the cells in the spreadsheet.</paragraph> + </section> + <section id="howtoget"> + <embed href="text/scalc/00/00000406.xhp#exdektv"/> + </section> + <paragraph xml-lang="en-US" id="par_id3150447" role="paragraph">Once you have defined a trace, you can point with the mouse cursor to the trace. The mouse cursor will change its shape. Double-click the trace with this cursor to select the referenced cell at the end of the trace. <comment>If you define an icon in the spreadsheet, you can put your cursor on it. It will change into a magnifying glass with reference arrows. Double-click the visible icon to select the cell at the furthest end of the icon.</comment></paragraph> + <embed href="text/scalc/01/06030100.xhp#trace_precedents"/> + <embed href="text/scalc/01/06030200.xhp#remove_precedents"/> + <embed href="text/scalc/01/06030300.xhp#trace_dependents"/> + <embed href="text/scalc/01/06030400.xhp#remove_dependents"/> + <embed href="text/scalc/01/06030500.xhp#remove_all_traces"/> + <embed href="text/scalc/01/06030600.xhp#trace_error"/> + <embed href="text/scalc/01/06030800.xhp#mark_invalid_data"/> + <embed href="text/scalc/01/06030900.xhp#spurenaktualisieren"/> + <embed href="text/scalc/01/06031000.xhp#autorefresh"/> + <embed href="text/scalc/01/06030700.xhp#fill_mode"/> + </body> +</helpdocument>
\ No newline at end of file diff --git a/helpcontent2/source/text/scalc/01/06030100.xhp b/helpcontent2/source/text/scalc/01/06030100.xhp new file mode 100644 index 000000000..a301cb6c4 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/06030100.xhp @@ -0,0 +1,47 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . + --> + +<helpdocument version="1.0"> +<meta> +<topic id="textscalc0106030100xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Trace Precedents</title> +<filename>/text/scalc/01/06030100.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +</history> +</meta> +<body> +<section id="trace_precedents"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3155628"><bookmark_value>cells; tracing precedents</bookmark_value> +<bookmark_value>formula cells;tracing precedents</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/.uno:ShowPrecedents" id="bm_id3145673" localize="false"/> +<paragraph role="heading" id="hd_id3155628" xml-lang="en-US" level="1"><link href="text/scalc/01/06030100.xhp" name="Trace Precedents">Trace Precedents</link></paragraph> +<paragraph role="paragraph" id="par_id3153542" xml-lang="en-US"><ahelp hid=".uno:ShowPrecedents">This function shows the relationship between the current cell containing a formula and the cells used in the formula.</ahelp></paragraph> +</section> +<paragraph role="paragraph" id="par_id3147265" xml-lang="en-US">Traces are displayed in the sheet with marking arrows. At the same time, the range of all the cells contained in the formula of the current cell is highlighted with a blue frame.</paragraph> +<section id="howtoget"> + <embed href="text/scalc/00/00000406.xhp#trace_precedents"/> +</section> +<paragraph role="note" id="par_id3154321" xml-lang="en-US">This function is based on a principle of layers. For example, if the precedent cell to a formula is already indicated with a tracer arrow, when you repeat this command, the tracer arrows are drawn to the precedent cells of this cell.</paragraph> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/06030200.xhp b/helpcontent2/source/text/scalc/01/06030200.xhp new file mode 100644 index 000000000..a11ac9c2a --- /dev/null +++ b/helpcontent2/source/text/scalc/01/06030200.xhp @@ -0,0 +1,45 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . + --> + +<helpdocument version="1.0"> +<meta> +<topic id="textscalc0106030200xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Remove Precedents</title> +<filename>/text/scalc/01/06030200.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +</history> +</meta> +<body> +<section id="remove_precedents"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3155628"><bookmark_value>cells; removing precedents</bookmark_value> +<bookmark_value>formula cells;removing precedents</bookmark_value> +</bookmark><comment>mw changed "formula..." entry</comment> +<bookmark xml-lang="en-US" branch="hid/.uno:ClearArrowPrecedents" id="bm_id8005825" localize="false"/> +<paragraph role="heading" id="hd_id3155628" xml-lang="en-US" level="1"><link href="text/scalc/01/06030200.xhp" name="Remove Precedents">Remove Precedents</link></paragraph> +<paragraph role="paragraph" id="par_id3149456" xml-lang="en-US"><ahelp hid=".uno:ClearArrowPrecedents">Deletes one level of the trace arrows that were inserted with the <emph>Trace Precedents</emph> command.</ahelp></paragraph> +</section> +<section id="howtoget"> + <embed href="text/scalc/00/00000406.xhp#exdvore"/> +</section> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/06030300.xhp b/helpcontent2/source/text/scalc/01/06030300.xhp new file mode 100644 index 000000000..3c26b4597 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/06030300.xhp @@ -0,0 +1,47 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . + --> +<helpdocument version="1.0"> +<meta> +<topic id="textscalc0106030300xml" indexer="include" status="PUBLISH"> +<title xml-lang="en-US" id="tit">Trace Dependents</title> +<filename>/text/scalc/01/06030300.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +</history> +</meta> +<body> + + + <section id="trace_dependents"> + <bookmark xml-lang="en-US" branch="index" id="bm_id3153252"><bookmark_value>cells; tracing dependents</bookmark_value></bookmark> +<bookmark branch="hid/.uno:ShowDependents" xml-lang="en-US" id="bm_id3143267" localize="false"/> +<paragraph id="hd_id3153252" role="heading" level="1" xml-lang="en-US"><link href="text/scalc/01/06030300.xhp" name="Trace Dependents">Trace Dependents</link></paragraph> + <paragraph role="paragraph" id="par_id3156024" xml-lang="en-US"><ahelp hid=".uno:ShowDependents" visibility="visible">Draws tracer arrows to the active cell from formulas that depend on values in the active cell.</ahelp></paragraph> + </section> + <paragraph role="paragraph" id="par_id3148948" xml-lang="en-US">The area of all cells that are used together with the active cell in a formula is highlighted by a blue frame.</paragraph> + <section id="howtoget"> + <embed href="text/scalc/00/00000406.xhp#trace_dependents"/> +</section> + <paragraph xml-lang="en-US" role="note" id="par_id3151112">This function works per level. For instance, if one level of traces has already been activated to show the precedents (or dependents), then you would see the next dependency level by activating the <emph>Trace</emph> function again.</paragraph> + + </body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/06030400.xhp b/helpcontent2/source/text/scalc/01/06030400.xhp new file mode 100644 index 000000000..345c24430 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/06030400.xhp @@ -0,0 +1,45 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . + --> + +<helpdocument version="1.0"> +<meta> +<topic id="textscalc0106030400xml" indexer="include" status="PUBLISH"> +<title xml-lang="en-US" id="tit">Remove Dependents</title> +<filename>/text/scalc/01/06030400.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +</history> +</meta> +<body> + + + <section id="remove_dependents"> + <bookmark xml-lang="en-US" branch="index" id="bm_id3147335"><bookmark_value>cells; removing dependents</bookmark_value></bookmark> +<bookmark branch="hid/.uno:ClearArrowDependents" xml-lang="en-US" id="bm_id3148552" localize="false"/> +<paragraph id="hd_id3147335" role="heading" level="1" xml-lang="en-US"><link href="text/scalc/01/06030400.xhp" name="Remove Dependents">Remove Dependents</link></paragraph> + <paragraph role="paragraph" id="par_id3148663" xml-lang="en-US"><ahelp visibility="visible" hid=".uno:ClearArrowDependents">Deletes one level of tracer arrows created with <emph>Trace Dependents</emph>.</ahelp></paragraph> + </section> + <section id="howtoget"> + <embed href="text/scalc/00/00000406.xhp#exdszne"/> +</section> + </body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/06030500.xhp b/helpcontent2/source/text/scalc/01/06030500.xhp new file mode 100644 index 000000000..8bb1bf550 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/06030500.xhp @@ -0,0 +1,45 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . + --> + +<helpdocument version="1.0"> +<meta> +<topic id="textscalc0106030500xml" indexer="include" status="PUBLISH"> +<title xml-lang="en-US" id="tit">Remove All Traces</title> +<filename>/text/scalc/01/06030500.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +</history> +</meta> +<body> + + + <section id="remove_all_traces"> + <bookmark xml-lang="en-US" branch="index" id="bm_id3153088"><bookmark_value>cells; removing traces</bookmark_value></bookmark> +<bookmark branch="hid/.uno:ClearArrows" xml-lang="en-US" id="bm_id3153541" localize="false"/> +<paragraph id="hd_id3153088" role="heading" level="1" xml-lang="en-US"><link href="text/scalc/01/06030500.xhp" name="Remove All Traces">Remove All Traces</link></paragraph> + <paragraph role="paragraph" id="par_id3151246" xml-lang="en-US"><ahelp hid=".uno:ClearArrows" visibility="visible">Removes all tracer arrows from the spreadsheet.</ahelp></paragraph> + </section> + <section id="howtoget"> + <embed href="text/scalc/00/00000406.xhp#exdase"/> +</section> + </body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/06030600.xhp b/helpcontent2/source/text/scalc/01/06030600.xhp new file mode 100644 index 000000000..7b112100d --- /dev/null +++ b/helpcontent2/source/text/scalc/01/06030600.xhp @@ -0,0 +1,45 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . + --> + +<helpdocument version="1.0"> +<meta> +<topic id="textscalc0106030600xml" indexer="include" status="PUBLISH"> +<title xml-lang="en-US" id="tit">Trace Error</title> +<filename>/text/scalc/01/06030600.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +</history> +</meta> +<body> + + + <section id="trace_error"> + <bookmark branch="index" xml-lang="en-US" id="bm_id3153561"><bookmark_value>cells; tracing errors</bookmark_value><bookmark_value>tracing errors</bookmark_value><bookmark_value>error tracing</bookmark_value></bookmark> +<bookmark branch="hid/.uno:ShowErrors" xml-lang="en-US" id="bm_id3153541" localize="false"/> +<paragraph id="hd_id3153561" role="heading" level="1" xml-lang="en-US"><link href="text/scalc/01/06030600.xhp" name="Trace Error">Trace Error</link></paragraph> + <paragraph role="paragraph" id="par_id3148550" xml-lang="en-US"><ahelp hid=".uno:ShowErrors" visibility="visible">Draws tracer arrows to all precedent cells which cause an error value in a selected cell.</ahelp></paragraph> + </section> + <section id="howtoget"> + <embed href="text/scalc/00/00000406.xhp#exdszfe"/> +</section> + </body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/06030700.xhp b/helpcontent2/source/text/scalc/01/06030700.xhp new file mode 100644 index 000000000..1036bb500 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/06030700.xhp @@ -0,0 +1,46 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . + --> + +<helpdocument version="1.0"> +<meta> +<topic id="textscalc0106030700xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Fill Mode</title> +<filename>/text/scalc/01/06030700.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +</history> +</meta> +<body> +<section id="fill_mode"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3145119"><bookmark_value>cells; trace fill mode</bookmark_value> +<bookmark_value>traces; precedents for multiple cells</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/.uno:AuditingFillMode" id="bm_id3148491" localize="false"/> +<paragraph role="heading" id="hd_id3145119" xml-lang="en-US" level="1"><link href="text/scalc/01/06030700.xhp" name="Fill Mode">Fill Mode</link></paragraph> +<paragraph role="paragraph" id="par_id3151246" xml-lang="en-US"><ahelp hid=".uno:AuditingFillMode">Activates the Fill Mode in the Detective. The mouse pointer changes to a special symbol, and you can click any cell to see a trace to the precedent cell.</ahelp> To exit this mode, press Escape or click the <emph>End Fill Mode</emph> command in the context menu.</paragraph> +</section> +<section id="howtoget"> + <embed href="text/scalc/00/00000406.xhp#fuellmodus"/> +</section> +<paragraph role="paragraph" id="par_id3151211" xml-lang="en-US">The <emph>Fill Mode</emph> function is identical to the <link href="text/scalc/01/06030100.xhp" name="Trace Precedent">Trace Precedent</link> command if you call this mode for the first time. Use the context menu to select further options for the Fill Mode and to exit this mode.</paragraph> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/06030800.xhp b/helpcontent2/source/text/scalc/01/06030800.xhp new file mode 100644 index 000000000..4f9905b92 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/06030800.xhp @@ -0,0 +1,46 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . + --> + +<helpdocument version="1.0"> +<meta> +<topic id="textscalc0106030800xml" indexer="include" status="PUBLISH"> +<title xml-lang="en-US" id="tit">Mark Invalid Data</title> +<filename>/text/scalc/01/06030800.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +</history> +</meta> +<body> + + + <section id="mark_invalid_data"> + <bookmark branch="index" xml-lang="en-US" id="bm_id3153821"><bookmark_value>cells; invalid data</bookmark_value><bookmark_value>data; showing invalid data</bookmark_value><bookmark_value>invalid data;marking</bookmark_value></bookmark> +<bookmark branch="hid/.uno:ShowInvalid" xml-lang="en-US" id="bm_id3157909" localize="false"/> +<paragraph id="hd_id3153821" role="heading" level="1" xml-lang="en-US"><link href="text/scalc/01/06030800.xhp" name="Mark Invalid Data">Mark Invalid Data</link></paragraph> + <paragraph role="paragraph" id="par_id3147264" xml-lang="en-US"><ahelp hid=".uno:ShowInvalid" visibility="visible">Marks all cells in the sheet that contain values outside the validation rules.</ahelp></paragraph> + </section> + <section id="howtoget"> + <embed href="text/scalc/00/00000406.xhp#dateneinkreisen"/> +</section> + <paragraph xml-lang="en-US" role="paragraph" id="par_id3151211">The <link href="text/scalc/01/12120000.xhp" name="validity rules">validity rules</link> restrict the input of numbers, dates, time values and text to certain values. However, it is possible to enter invalid values or copy invalid values into the cells if the <emph>Stop</emph> option is not selected. When you assign a validity rule, existing values in a cell will not be modified.</paragraph> + </body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/06030900.xhp b/helpcontent2/source/text/scalc/01/06030900.xhp new file mode 100644 index 000000000..495c0abff --- /dev/null +++ b/helpcontent2/source/text/scalc/01/06030900.xhp @@ -0,0 +1,58 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . + --> + +<helpdocument version="1.0"> +<meta> +<topic id="textscalc0106030900xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Refresh Traces</title> +<filename>/text/scalc/01/06030900.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +</history> +</meta> +<body> +<section id="spurenaktualisieren"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3152349"><bookmark_value>cells; refreshing traces</bookmark_value> +<bookmark_value>traces; refreshing</bookmark_value> +<bookmark_value>updating;traces</bookmark_value> +</bookmark><comment>mw made "updating..." a two level entry</comment> +<bookmark xml-lang="en-US" branch="hid/.uno:RefreshArrows" id="bm_id9951902" localize="false"/> +<paragraph role="heading" id="hd_id3152349" xml-lang="en-US" level="1"><link href="text/scalc/01/06030900.xhp" name="Refresh Traces">Refresh Traces</link></paragraph> +<paragraph role="paragraph" id="par_id3148947" xml-lang="en-US"><ahelp hid=".uno:RefreshArrows">Redraws all traces in the sheet. Formulas modified when traces are redrawn are taken into account.</ahelp></paragraph> +</section> +<section id="howtoget"> + <embed href="text/scalc/00/00000406.xhp#spurenaktualisieren"/> +</section> +<section id="arrows"> +<paragraph role="paragraph" id="par_id3148798" xml-lang="en-US">Detective arrows in the document are updated under the following circumstances:</paragraph> +<list type="unordered"> +<listitem> +<paragraph role="listitem" id="par_id3153192" xml-lang="en-US">Starting <emph>Tools - Detective - Update Refresh Traces</emph> +</paragraph> +</listitem> +<listitem> +<paragraph role="listitem" id="par_id3151041" xml-lang="en-US">If <emph>Tools - Detective - AutoRefresh</emph> is turned on, every time formulas are changed in the document.</paragraph> +</listitem> +</list> +</section> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/06031000.xhp b/helpcontent2/source/text/scalc/01/06031000.xhp new file mode 100644 index 000000000..30bd550ad --- /dev/null +++ b/helpcontent2/source/text/scalc/01/06031000.xhp @@ -0,0 +1,46 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . + --> + +<helpdocument version="1.0"> +<meta> +<topic id="textscalc0106031000xml" indexer="include" status="PUBLISH"> +<title xml-lang="en-US" id="tit">AutoRefresh</title> +<filename>/text/scalc/01/06031000.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +</history> +</meta> +<body> + + + <section id="autorefresh"> + <bookmark branch="index" xml-lang="en-US" id="bm_id3154515"><bookmark_value>cells; autorefreshing traces</bookmark_value><bookmark_value>traces; autorefreshing</bookmark_value></bookmark> +<bookmark branch="hid/.uno:AutoRefreshArrows" xml-lang="en-US" id="bm_id3153821" localize="false"/> +<paragraph id="hd_id3154515" role="heading" level="1" xml-lang="en-US"><link href="text/scalc/01/06031000.xhp" name="AutoRefresh">AutoRefresh</link></paragraph> + <paragraph role="paragraph" id="par_id3147264" xml-lang="en-US"><ahelp hid=".uno:AutoRefreshArrows" visibility="visible">Automatically refreshes all the traces in the sheet whenever you modify a formula.</ahelp></paragraph> + </section> + <section id="howtoget"> + <embed href="text/scalc/00/00000406.xhp#automatisch"/> +</section> + <embed href="text/scalc/01/06030900.xhp#arrows"/> + </body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/06040000.xhp b/helpcontent2/source/text/scalc/01/06040000.xhp new file mode 100644 index 000000000..9d773a5ac --- /dev/null +++ b/helpcontent2/source/text/scalc/01/06040000.xhp @@ -0,0 +1,52 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> + +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . + --> + + +<meta> +<topic id="textscalc0106040000xml" indexer="include"> +<title id="tit" xml-lang="en-US">Goal Seek</title> +<filename>/text/scalc/01/06040000.xhp</filename> +</topic> +</meta> +<body> +<bookmark xml-lang="en-US" branch="hid/.uno:GoalSeekDialog" id="bm_id4741970" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/goalseekdlg/GoalSeekDialog" id="bm_id3153088" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/goalseekdlg/@@nowidget@@" id="bm_id3153088" localize="false"/> +<paragraph role="heading" id="hd_id3155629" xml-lang="en-US" level="1">Goal Seek</paragraph> +<paragraph role="paragraph" id="par_id3145119" xml-lang="en-US"><variable id="zielwertsuchetext"><ahelp hid=".uno:GoalSeekDialog">Opens a dialog where you can solve an equation with a variable.</ahelp> +</variable> After a successful search, a dialog with the results opens, allowing you to apply the result and the target value directly to the cell.</paragraph> +<section id="howtoget"> +<embed href="text/scalc/00/00000406.xhp#exzws"/> +</section> +<paragraph role="heading" id="hd_id3149656" xml-lang="en-US" level="2">Default</paragraph> +<paragraph role="paragraph" id="par_id3151211" xml-lang="en-US">In this section, you can define the variables in your formula.</paragraph> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/goalseekdlg/formulaedit" id="bm_id3145171" localize="false"/> +<paragraph role="heading" id="hd_id3150869" xml-lang="en-US" level="3">Formula cell</paragraph> +<paragraph role="paragraph" id="par_id3153194" xml-lang="en-US"><ahelp hid="modules/scalc/ui/goalseekdlg/formulaedit">In the formula cell, enter the reference of the cell which contains the formula. It contains the current cell reference.</ahelp> Click another cell in the sheet to apply its reference to the text box.</paragraph> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/goalseekdlg/target" id="bm_id3150441" localize="false"/> +<paragraph role="heading" id="hd_id3154685" xml-lang="en-US" level="3">Target value</paragraph> +<paragraph role="paragraph" id="par_id3146984" xml-lang="en-US"><ahelp hid="modules/scalc/ui/goalseekdlg/target">Specifies the value you want to achieve as a new result.</ahelp></paragraph> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/goalseekdlg/varedit" id="bm_id3154013" localize="false"/> +<paragraph role="heading" id="hd_id3150012" xml-lang="en-US" level="3">Variable cell</paragraph> +<paragraph role="paragraph" id="par_id3147427" xml-lang="en-US"><ahelp hid="modules/scalc/ui/goalseekdlg/varedit">Specifies the reference for the cell that contains the value you want to adjust in order to reach the target.</ahelp></paragraph> +<embed href="text/shared/00/00000001.xhp#shrink_maximize"/> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/06050000.xhp b/helpcontent2/source/text/scalc/01/06050000.xhp new file mode 100644 index 000000000..fd5b9366f --- /dev/null +++ b/helpcontent2/source/text/scalc/01/06050000.xhp @@ -0,0 +1,80 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . + --> + +<helpdocument version="1.0"> +<meta> +<topic id="textscalc0106050000xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Create Scenario</title> +<filename>/text/scalc/01/06050000.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +</history> +</meta> +<body> +<bookmark xml-lang="en-US" branch="hid/.uno:ScenarioManager" id="bm_id3154490" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/scenariodialog/ScenarioDialog" id="bm_id3145068" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/scenariodialog/@@nowidget@@" id="bm_id3145068" localize="false"/> +<paragraph role="heading" id="hd_id3156023" xml-lang="en-US" level="1">Create Scenario</paragraph> +<paragraph role="paragraph" id="par_id3150541" xml-lang="en-US"><variable id="szenariotext"><ahelp hid=".">Defines a scenario for the selected sheet area.</ahelp> +</variable></paragraph> +<section id="howtoget"> + <embed href="text/scalc/00/00000406.xhp#exsze"/> +</section> +<paragraph role="paragraph" id="par_idN10637" xml-lang="en-US" localize="false"> + <embedvar href="text/scalc/guide/scenario.xhp#scenario"/> +</paragraph> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/scenariodialog/name" id="bm_id3154123" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/SC_HID_SC_SCENWIN_TOP" id="bm_id3153195" localize="false"/> +<paragraph role="heading" id="hd_id3156280" xml-lang="en-US" level="2">Name of scenario</paragraph> +<paragraph role="paragraph" id="par_id3151041" xml-lang="en-US"><ahelp hid=".">Defines the name for the scenario. Use a clear and unique name so you can easily identify the scenario.</ahelp> You can also modify a scenario name in the Navigator through the <emph>Properties </emph>context menu command.</paragraph> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/scenariodialog/comment" id="bm_id3152596" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/SC_HID_SC_SCENWIN_BOTTOM" id="bm_id3156444" localize="false"/> +<paragraph role="heading" id="hd_id3153954" xml-lang="en-US" level="2">Comment</paragraph> +<paragraph role="paragraph" id="par_id3155411" xml-lang="en-US"><ahelp hid=".">Specifies additional information about the scenario. This information will be displayed in the <link href="text/scalc/01/02110000.xhp" name="Navigator">Navigator</link> when you click the <emph>Scenarios</emph> icon and select the desired scenario.</ahelp> You can also modify this information in the Navigator through the <emph>Properties </emph>context menu command.</paragraph> +<paragraph role="heading" id="hd_id3145273" xml-lang="en-US" level="2">Settings</paragraph> +<paragraph role="paragraph" id="par_id3153364" xml-lang="en-US">This section is used to define some of the settings used in the scenario display.</paragraph> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/scenariodialog/showframe" id="bm_id3151119" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/scenariodialog/bordercolor" id="bm_id3151118" localize="false"/> +<paragraph role="heading" id="hd_id3145367" xml-lang="en-US" level="3">Display border<comment>UFI: #i38688#</comment></paragraph> +<paragraph role="paragraph" id="par_id3151073" xml-lang="en-US"><ahelp hid=".">Highlights the scenario in your table with a border. The color for the border is specified in the field to the right of this option.</ahelp> The border will have a title bar displaying the name of the last scenario. The button on the right of the scenario border offers you an overview of all the scenarios in this area, if several have been defined. You can choose any of the scenarios from this list without restrictions.</paragraph> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/scenariodialog/copyback" id="bm_id3147124" localize="false"/> +<paragraph role="heading" id="hd_id3149582" xml-lang="en-US" level="3">Copy back</paragraph> +<paragraph role="paragraph" id="par_id3154942" xml-lang="en-US"><ahelp hid="modules/scalc/ui/scenariodialog/copyback">Copies the values of cells that you change into the active scenario. If you do not select this option, the scenario is not changed when you change cell values. The behavior of the <emph>Copy back</emph> setting depends on the cell protection, the sheet protection, and the <emph>Prevent changes</emph> settings.</ahelp></paragraph> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/scenariodialog/copysheet" id="bm_id3153418" localize="false"/> +<paragraph role="heading" id="hd_id3149402" xml-lang="en-US" level="3">Copy entire sheet</paragraph> +<paragraph role="paragraph" id="par_id3146969" xml-lang="en-US"><ahelp hid="modules/scalc/ui/scenariodialog/copysheet">Copies the entire sheet into an additional scenario sheet. </ahelp></paragraph> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/scenariodialog/preventchanges" id="bm_id3014007" localize="false"/> +<paragraph role="heading" id="par_idN1075A" xml-lang="en-US" level="3">Prevent changes</paragraph> +<paragraph role="paragraph" id="par_idN1075E" xml-lang="en-US"><ahelp hid="modules/scalc/ui/scenariodialog/preventchanges">Prevents changes to the active scenario. The behavior of the <emph>Copy back</emph> setting depends on the cell protection, the sheet protection, and the <emph>Prevent changes</emph> settings.</ahelp></paragraph> +<list type="unordered"> +<listitem> +<paragraph role="paragraph" id="par_idN10778" xml-lang="en-US">You can only change the scenario properties if the <emph>Prevent changes</emph> option is not selected and if the sheet is not protected.</paragraph> +</listitem> +<listitem> +<paragraph role="paragraph" id="par_idN10780" xml-lang="en-US">You can only edit cell values if the <emph>Prevent changes</emph> option is selected, if the <emph>Copy back</emph> is option is not selected, and if the cells are not protected.</paragraph> +</listitem> +<listitem> +<paragraph role="paragraph" id="par_idN1078C" xml-lang="en-US">You can only change scenario cell values and write them back into the scenario if the <emph>Prevent changes</emph> option is not selected, if the <emph>Copy back</emph> option is selected, and if the cells are not protected.</paragraph> +</listitem> +</list> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/06060000.xhp b/helpcontent2/source/text/scalc/01/06060000.xhp new file mode 100644 index 000000000..ae03dc323 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/06060000.xhp @@ -0,0 +1,51 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . + --> + +<helpdocument version="1.0"> +<meta> +<topic id="textscalc0106060000xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Protect Document</title> +<filename>/text/scalc/01/06060000.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +</history> +</meta> +<body> +<section id="protect_document"> +<paragraph role="heading" id="hd_id3148946" xml-lang="en-US" level="1"><link href="text/scalc/01/06060000.xhp" name="Protect Document">Protect Document</link></paragraph> +<paragraph role="paragraph" id="par_id3153362" xml-lang="en-US">The <emph>Protect Sheet</emph> or <emph>Protect Spreadsheet Structure</emph> commands prevent changes from being made to cells in the sheets or to sheets in a document. As an option, you can define a password. If a password is defined, removal of the protection is only possible if the user enters the correct password.</paragraph> +</section> +<section id="howtoget"> + <embed href="text/scalc/00/00000406.xhp#protect_sheet"/> + <embed href="text/scalc/00/00000406.xhp#protect_spreadsheet"/> +</section> +<paragraph role="heading" id="hd_id3147228" xml-lang="en-US" level="2"><link href="text/scalc/01/06060100.xhp" name="Sheets">Sheets</link></paragraph> +<embed href="text/scalc/01/06060100.xhp#tabelletext"/> +<paragraph role="heading" id="hd_id3153768" xml-lang="en-US" level="2"><link href="text/scalc/01/06060200.xhp" name="Documents">Documents</link></paragraph> +<embed href="text/scalc/01/06060200.xhp#dokumenttext"/> +<section id="relatedtopics"> +<paragraph role="paragraph" id="par_idN10622" xml-lang="en-US" localize="false"> + <embedvar href="text/scalc/guide/cell_protect.xhp#cell_protect"/> +</paragraph> +</section> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/06060100.xhp b/helpcontent2/source/text/scalc/01/06060100.xhp new file mode 100644 index 000000000..5ed52eec5 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/06060100.xhp @@ -0,0 +1,109 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . + --> +<helpdocument version="1.0"> +<meta> +<topic id="textscalc0106060100xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Protecting Sheet</title> +<filename>/text/scalc/01/06060100.xhp</filename> +</topic> +</meta> +<body> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/protectsheetdlg/ProtectSheetDialog" id="bm_id3148919" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/protectsheetdlg/@@nowidget@@" id="bm_id3148919" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/.uno:Protect" id="bm_id3156326" localize="false"/> +<bookmark xml-lang="en-US" branch="index" id="bm_id141619439455954"> +<bookmark_value>insert rows;protected sheet</bookmark_value> +<bookmark_value>insert columns;protected sheet</bookmark_value> +<bookmark_value>delete columns;protected sheet</bookmark_value> +<bookmark_value>delete rows;protected sheet</bookmark_value> +<bookmark_value>protected sheet;insert columns</bookmark_value> +<bookmark_value>protected sheet;insert rows</bookmark_value> +<bookmark_value>protected sheet;delete rows</bookmark_value> +<bookmark_value>protected sheet;delete columns</bookmark_value> +<bookmark_value>protect;sheet</bookmark_value> +<bookmark_value>selection;in protected cells</bookmark_value> +</bookmark> +<h1 id="hd_id3153087"><variable id="ProtectingSheeth1"><link href="text/scalc/01/06060100.xhp" name="Protecting Sheet">Protecting Sheet</link></variable></h1> +<paragraph role="paragraph" id="par_id3148664" xml-lang="en-US"><variable id="tabelletext"><ahelp hid=".uno:Protect">Protects the cells in the current sheet from being modified.</ahelp></variable></paragraph> +<paragraph role="paragraph" id="par_id701619429750616">Choose <emph>Tools - Protect Sheet</emph> to open the <emph>Protect Sheet</emph> dialog in which you then specify sheet protection with or without a password, and select the elements of the sheet to protect.</paragraph> +<section id="howtoget"> + <embed href="text/scalc/00/00000406.xhp#protect_sheet"/> + <embed href="text/scalc/00/00000402.xhp#cellprotection"/> +</section> +<warning id="par_id3149664">To protect cells from further editing, the <emph>Protected</emph> check box must be checked on the <link href="text/scalc/01/05020600.xhp" name="Format - Cells - Cell Protection"><emph>Format - Cells - Cell Protection</emph></link> tab page or on the <emph>Format Cells</emph> context menu.</warning> + +<h2 id="hd_id901619431276995">Protect this sheet and contents of the protected cells</h2> +<paragraph role="paragraph" id="par_id381619431285815">Mark this checkbox to activate protection of sheet and cell contents.</paragraph> +<h2 id="hd_id31619431291108">Password / Confirm</h2> +<paragraph role="paragraph" id="par_id851619431300487">Allows you to enter a password to protect the sheet from unauthorized changes. Confirm the password entered in the first box.</paragraph> +<h2 id="hd_id711619431316966">Allow users of this sheet to</h2> +<paragraph role="paragraph" id="par_id41619431361278">Select the elements to protect from user actions:</paragraph> +<list type="unordered"> + <listitem> + <paragraph id="par_id661619430257262" role="listitem"><emph>Select protected cells</emph>: mark this checkbox to allow you to select protected cells. When the checkbox is unmarked, you cannot select protected cells, the cursor cannot enter in a protected range.</paragraph> + </listitem> + <listitem> + <paragraph id="par_id921619430295947" role="listitem"><emph>Select unprotected cells</emph>: mark this checkbox to allow user to select unprotected cells. When the checkbox is unmarked, user cannot select unprotected cells, the cursor cannot enter in a unprotected cell or range.</paragraph> + </listitem> + <listitem> + <paragraph id="par_id101619430333784" role="listitem"><emph>Insert columns</emph>: Allow column insertions even when the sheet is protected. Note that when column insertions is enabled, you can insert columns even when the range to insert the new columns into contains protected cells which will get shifted after the insertion. Cells of the newly inserted columns inherit the Protection property of the range it belongs: when the new cell is inside a protected range, the cell is protected, and when it is in an unprotected range, the cell is unprotected.</paragraph> + </listitem> + <listitem> + <paragraph id="par_id891619430338809" role="listitem"><emph>Insert rows</emph>: Allow row insertions even when the sheet is protected. Note that when row insertions is enabled, you can insert rows even when the range to insert the new rows into contains protected cells which will get shifted after the insertion. Cells of the newly inserted rows inherit the Protection property of the range it belongs: when the new cell is inside a protected range it is protected, and when it is in an unprotected range, the cell is unprotected.</paragraph> + </listitem> + <listitem> + <paragraph id="par_id311619430374686" role="listitem"><emph>Delete columns</emph>: Allow column deletions. Note that column deletions are only allowed on unprotected cells. + </paragraph> + </listitem> + <listitem> + <paragraph id="par_id561619430376854" role="listitem"><emph>Delete rows</emph>: Allow row deletions. Note that row deletions are only allowed on unprotected cells. + </paragraph> + </listitem> +</list> +<paragraph role="paragraph" id="par_id3154490">Unprotected cells or cell ranges can be set up on a protected sheet by using the <emph>Tools - Protect Sheet</emph> and <emph>Format - Cells - Cell Protection</emph> menus: </paragraph> +<list type="ordered"> +<listitem> +<paragraph role="paragraph" id="par_id3149123" xml-lang="en-US">Select the cells that will be unprotected</paragraph> +</listitem> +<listitem> +<paragraph role="paragraph" id="par_id3150329" xml-lang="en-US">Select <emph>Format - Cells - Cell Protection</emph>. Unmark the <emph>Protected</emph> box and click <emph>OK</emph>.</paragraph> +</listitem> +<listitem> + <paragraph role="paragraph" id="par_id3156384" xml-lang="en-US">On the <emph>Tools - Protect Sheet</emph> menu, activate protection for the sheet. Effective immediately, only the cell range you selected in step 1 can be edited.</paragraph> +</listitem> +</list> +<paragraph role="paragraph" id="par_id3149566" xml-lang="en-US">To later change an unprotected area to a protected area:</paragraph> + <list type="ordered"> + <listitem> + <paragraph id="par_id101619439013221" role="listitem">Select the range of cells that will be protected.</paragraph> + </listitem> + <listitem> + <paragraph id="par_id601619439028536" role="listitem">On the <menuitem>Format - Cells - Cell Protection</menuitem> tab page, check the <emph>Protected</emph> box. </paragraph> + </listitem> + <listitem> + <paragraph id="par_id641619439061892" role="listitem">Choose the <menuitem>Tools - Protect Sheet</menuitem> menu. The previously editable range is now protected.</paragraph> + </listitem> + </list> +<paragraph role="paragraph" id="par_id3153964" xml-lang="en-US">Sheet protection also affects the context menu of the sheet tabs at the bottom of the screen. The <emph>Delete</emph> and <emph>Rename</emph> commands cannot be selected.</paragraph> +<paragraph role="paragraph" id="par_id3150301" xml-lang="en-US">If a sheet is protected, you will not be able to modify or delete any Cell Styles.</paragraph> +<paragraph role="paragraph" id="par_id3154656" xml-lang="en-US">A protected sheet or cell range can no longer be modified until this protection is disabled, with the exceptions of the settings for columns and row of the <menuitem>Tools - Protect Sheet</menuitem> dialog. To disable the protection, choose the <menuitem>Tools - Protect Sheet</menuitem> command. If no password was set, the sheet protection is immediately disabled. If the sheet was password protected, the <emph>Remove Protection</emph> dialog opens, where you must enter the password.</paragraph> +<paragraph role="paragraph" id="par_id3149815" xml-lang="en-US">Once saved, protected sheets can only be saved again by using the <emph>File - Save As</emph> command.</paragraph> +<note id="par_id3148700">Complete protection of your work can be achieved by combining the options <emph>Tools - Protect Sheet</emph> and <emph>Tools - Protect Spreadsheet Structure</emph>, including password protection. To prohibit opening the document altogether, in the <emph>Save</emph> dialog mark the <emph>Save with password</emph> box before you click the <emph>Save</emph> button.</note> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/06060200.xhp b/helpcontent2/source/text/scalc/01/06060200.xhp new file mode 100644 index 000000000..20a68ae45 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/06060200.xhp @@ -0,0 +1,52 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . + --> + +<helpdocument version="1.0"> +<meta> +<topic id="textscalc0106060200xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Protecting document</title> +<filename>/text/scalc/01/06060200.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +</history> +</meta> +<body> + +<bookmark xml-lang="en-US" branch="hid/.uno:ToolProtectionDocument" id="bm_id3150791" localize="false"/> +<paragraph role="heading" id="hd_id3150541" xml-lang="en-US" level="1">Protecting document</paragraph> +<paragraph role="paragraph" id="par_id3145172" xml-lang="en-US"><variable id="dokumenttext"><ahelp hid=".uno:ToolProtectionDocument">Protects the sheet structure of your document from modifications. It is impossible to insert, delete, rename, move or copy sheets.</ahelp></variable> Open the <emph>Protect spreadsheet structure</emph> dialog with <emph>Tools - Protect Spreadsheet Structure</emph>. Optionally enter a password and click OK.</paragraph> +<section id="howtoget"> + <embed href="text/scalc/00/00000406.xhp#protect_spreadsheet"/> +</section> +<paragraph role="paragraph" id="par_id3153188" xml-lang="en-US">The structure of protected spreadsheet documents can be changed only if the <emph>Protect</emph> option is disabled. On the context menus for the spreadsheet tabs at the lower graphic border, only the menu item <emph>Select All Sheets</emph> can be activated. All other menu items are deactivated. To remove the protection, call up the command <emph>Tools - Protect Spreadsheet Structure</emph> again. If no password is assigned, protection is immediately removed. If you were assigned a password, the <emph>Remove Spreadsheet Protection</emph> dialog appears, in which you must enter the password. Only then can you remove the check mark specifying that protection is active.</paragraph> +<paragraph role="paragraph" id="par_id3145750" xml-lang="en-US">A protected document, once saved, can only be saved again with the <emph>File - Save As</emph> menu command. </paragraph> + +<bookmark xml-lang="en-US" branch="hid/SC_HID_PASSWD_DOC" id="bm_id3154863" localize="false"/> +<paragraph role="heading" id="hd_id3152596" xml-lang="en-US" level="2">Password (optional)</paragraph> +<paragraph role="paragraph" id="par_id3155412" xml-lang="en-US"><ahelp hid="SC_HID_PASSWD_DOC">You can create a password to protect your document against unauthorized or accidental modifications.</ahelp></paragraph> + +<bookmark xml-lang="en-US" branch="hid/SC_HID_PASSWD_DOC_CONFIRM" id="bm_id3154864" localize="false"/> +<paragraph role="paragraph" id="par_id3155413" xml-lang="en-US"><ahelp hid="SC_HID_PASSWD_DOC_CONFIRM" visibility="hidden">Re-enter the password.</ahelp></paragraph> + +<paragraph role="note" id="par_id3150717" xml-lang="en-US">You can completely protect your work by combining the options <emph>Tools - Protect Sheet</emph> and <emph>Tools - Protect Spreadsheet Structure</emph>, including password entry. If you want to prevent the document from being opened by other users, select <emph>Save With Password </emph>and click the <emph>Save</emph> button. The <emph>Enter Password</emph> dialog appears. Consider carefully when choosing a password; if you forget it after you close a document you will be unable to access the document.</paragraph> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/06070000.xhp b/helpcontent2/source/text/scalc/01/06070000.xhp new file mode 100644 index 000000000..9f35327a6 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/06070000.xhp @@ -0,0 +1,45 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . + --> +<helpdocument version="1.0"> +<meta> +<topic id="textscalc0106070000xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">AutoCalculate</title> +<filename>/text/scalc/01/06070000.xhp</filename> +</topic> +</meta> +<body> +<section id="autocalculate"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3145673"><bookmark_value>calculating; auto calculating sheets</bookmark_value> +<bookmark_value>recalculate;auto calculating sheets</bookmark_value> +<bookmark_value>recalculating;auto calculating sheets</bookmark_value> +<bookmark_value>AutoCalculate function in sheets</bookmark_value> +<bookmark_value>correcting sheets automatically</bookmark_value> +<bookmark_value>formulas;AutoCalculate function</bookmark_value> +<bookmark_value>cell contents;AutoCalculate function</bookmark_value> +</bookmark><comment>mw added "recalculating;..." </comment> +<bookmark xml-lang="en-US" branch="hid/.uno:AutomaticCalculation" id="bm_id6626340" localize="false"/> +<h1 id="hd_id3145673"><link href="text/scalc/01/06070000.xhp" name="AutoCalculate">AutoCalculate</link></h1> +<paragraph role="paragraph" id="par_id3148798" xml-lang="en-US"><ahelp hid=".uno:AutomaticCalculation">Automatically recalculates all formulas in the document.</ahelp></paragraph> +</section> +<paragraph role="paragraph" id="par_id3145173" xml-lang="en-US">All cells are recalculated after a sheet cell has been modified. Any charts in the sheet will also be refreshed.</paragraph> +<section id="howtoget"> + <embed href="text/scalc/00/00000406.xhp#exatmb"/> +</section> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/06080000.xhp b/helpcontent2/source/text/scalc/01/06080000.xhp new file mode 100644 index 000000000..dd85adf92 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/06080000.xhp @@ -0,0 +1,53 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> + +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . + --> + +<meta> +<topic id="textscalc0106080000xml" indexer="include"> +<title id="tit" xml-lang="en-US">Recalculate</title> +<filename>/text/scalc/01/06080000.xhp</filename> +</topic> +</meta> +<body> +<section id="recalculate"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3157909"><bookmark_value>recalculating;all formulas in sheets</bookmark_value> +<bookmark_value>recalculate;all formulas in sheets</bookmark_value> +<bookmark_value>formulas; recalculating manually</bookmark_value> +<bookmark_value>cell contents; recalculating</bookmark_value> +</bookmark><comment>mw changed "recalculating;...", "formulas;..." and "cell..." entries and deleted "recalculating formulas"</comment> +<bookmark xml-lang="en-US" branch="hid/.uno:Calculate" id="bm_id2661876" localize="false"/> +<section id="recalculateheader"> +<h1 id="hd_id3157909"><link href="text/scalc/01/06080000.xhp" name="Recalculate">Recalculate</link></h1> +<paragraph role="paragraph" id="par_id951584669541929">Recalculates formula cells.</paragraph> +</section> +<section id="howtoget"> +<embed href="text/scalc/00/00000406.xhp#recalculate"/> +</section> +<paragraph role="paragraph" id="par_id3154758" xml-lang="en-US"><ahelp hid=".uno:Calculate">If AutoCalculate is disabled, the Recalculate command recalculates all (so-called dirty) formula cells that depend on changed cell content and their dependents, and formula cells containing volatile functions such as RAND() or NOW() and formula cells that depend on them.</ahelp></paragraph> +<paragraph role="paragraph" id="par_id3154759" xml-lang="en-US"><ahelp hid=".uno:Calculate">If AutoCalculate is enabled, the Recalculate command applies only to formula cells containing volatile functions like RAND() or NOW() and formula cells that depend on them.</ahelp></paragraph> +<paragraph role="paragraph" id="par_id3154753" xml-lang="en-US"><ahelp hid=".uno:Calculate">In either mode, with formula cell(s) selected pressing F9 recalculates the currently selected cells and formula cells that depend on them. This can be useful after reading documents with recalculation disabled and individual cells need recalculation.</ahelp></paragraph> +<paragraph role="paragraph" id="par_id315475899" xml-lang="en-US">Press <keycode>F9</keycode> to recalculate. Press <keycode>Shift</keycode>+<switchinline select="sys"><caseinline select="MAC"><keycode>Command</keycode></caseinline><defaultinline><keycode>Ctrl</keycode></defaultinline></switchinline>+<keycode>F9</keycode> to recalculate all formulas in the document, including Add-In functions and non-volatile functions.</paragraph> +<paragraph role="paragraph" id="par_id3150799" xml-lang="en-US">After the document has been recalculated, the display is refreshed. All charts are also refreshed.</paragraph> +</section> +<section id="relatedtopics"> + <paragraph role="paragraph" id="par_id641645233417894"><link href="text/shared/optionen/01060900.xhp" name="recalculationoptions">Recalculation options</link></paragraph> +</section> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/06130000.xhp b/helpcontent2/source/text/scalc/01/06130000.xhp new file mode 100644 index 000000000..40462661a --- /dev/null +++ b/helpcontent2/source/text/scalc/01/06130000.xhp @@ -0,0 +1,61 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . + --> + +<helpdocument version="1.0"> +<meta> +<topic id="textscalc0106130000xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">AutoInput</title> +<filename>/text/scalc/01/06130000.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +</history> +</meta> +<body> +<bookmark xml-lang="en-US" branch="index" id="bm_id2486037"><bookmark_value>entering entries with AutoInput function</bookmark_value> +<bookmark_value>capital letters;AutoInput function</bookmark_value> +</bookmark><comment>mw made "entering..." a one level entry</comment> +<bookmark xml-lang="en-US" branch="hid/.uno:AutoComplete" id="bm_id6682843" localize="false"/> +<paragraph role="heading" id="hd_id3148492" xml-lang="en-US" level="1"><link href="text/scalc/01/06130000.xhp" name="AutoInput">AutoInput</link></paragraph> +<paragraph role="paragraph" id="par_id3150793" xml-lang="en-US"><ahelp hid=".uno:AutoComplete">Switches the AutoInput function on and off, which automatically completes entries, based on other entries in the same column.</ahelp> The column is scanned up to a maximum of 2000 cells or 200 different strings.</paragraph> +<embed href="text/scalc/guide/auto_off.xhp#auto_off"/> +<section id="howtoget"> + <embed href="text/scalc/00/00000406.xhp#autoeingabe"/> +</section> +<paragraph role="paragraph" id="par_id3156422" xml-lang="en-US">The completion text is highlighted.</paragraph> +<list type="unordered"> +<listitem> +<paragraph role="paragraph" id="par_idN1065D" xml-lang="en-US">To accept the completion, press <item type="keycode">Enter</item> or a cursor key.</paragraph> +</listitem> +<listitem> +<paragraph role="paragraph" id="par_idN10665" xml-lang="en-US">To append text or to edit the completion, press <item type="keycode">F2</item>.</paragraph> +</listitem> +<listitem> +<paragraph role="paragraph" id="par_idN1066D" xml-lang="en-US">To view more completions, press <switchinline select="sys"><caseinline select="MAC"><item type="keycode">Command</item></caseinline><defaultinline><item type="keycode">Ctrl</item></defaultinline></switchinline><item type="keycode">+Tab</item> to scroll forward, or <switchinline select="sys"><caseinline select="MAC"><item type="keycode">Command</item></caseinline><defaultinline><item type="keycode">Ctrl</item></defaultinline></switchinline><item type="keycode">+Shift+Tab</item> to scroll backward.</paragraph> +</listitem> +<listitem> + <paragraph role="paragraph" id="par_idN10679" xml-lang="en-US">To see a list of all available AutoInput text items for the current column, press <switchinline select="sys"><caseinline select="MAC"><item type="keycode">Option</item></caseinline><defaultinline><item type="keycode">Alt</item></defaultinline></switchinline><item type="keycode">+Down Arrow</item>.</paragraph> +</listitem> +</list> +<paragraph role="paragraph" id="par_id3150439" xml-lang="en-US">When typing formulas using characters that match previous entries, a Help tip will appear listing the last ten functions used from <emph>Function Wizard</emph>, from all defined range names, from all database range names, and from the content of all label ranges.</paragraph> +<paragraph role="paragraph" id="par_id3153363" xml-lang="en-US">AutoInput is case-sensitive. If, for example, you have written "Total" in a cell, you cannot enter "total" in another cell of the same column without first deactivating AutoInput.</paragraph> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/07080000.xhp b/helpcontent2/source/text/scalc/01/07080000.xhp new file mode 100644 index 000000000..9e0beeae1 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/07080000.xhp @@ -0,0 +1,46 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . +--> + +<meta> + <topic id="textscalc0107080000xml" indexer="include" status="PUBLISH"> + <title id="tit" xml-lang="en-US">Split Window</title> + <filename>/text/scalc/01/07080000.xhp</filename> + </topic> +</meta> + +<body> + + +<section id="split_window"> +<bookmark xml-lang="en-US" branch="hid/.uno:SplitWindow" id="bm_id6328790" localize="false"/> + +<paragraph id="hd_id3163800" role="heading" level="1" xml-lang="en-US"><link href="text/scalc/01/07080000.xhp" name="Split">Split Window</link></paragraph> +<paragraph id="par_id3150084" role="paragraph" xml-lang="en-US"><ahelp hid=".">Divides the current window at the top left corner of the active cell.</ahelp></paragraph> +</section> + +<section id="howtoget"> +<embed href="text/scalc/00/00000407.xhp#fete"/> +</section> +<embed href="text/scalc/guide/line_fix.xhp#line_fix"/> +<paragraph id="par_id3154910" role="note" xml-lang="en-US">You can also use the mouse to split the window horizontally or vertically. To do this, drag the thick black line located directly above the vertical scrollbar or directly to the right of the horizontal scrollbar into the window. A thick black line will show where the window is split.</paragraph> +<paragraph id="par_id3149263" role="paragraph" xml-lang="en-US">A split window has its own scrollbars in each partial section; by contrast, <link href="text/scalc/01/07090000.xhp" name="fixed window sections">fixed window sections</link> are not scrollable.</paragraph> +</body> + +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/07090000.xhp b/helpcontent2/source/text/scalc/01/07090000.xhp new file mode 100644 index 000000000..07064520c --- /dev/null +++ b/helpcontent2/source/text/scalc/01/07090000.xhp @@ -0,0 +1,46 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . +--> + +<meta> + <topic id="textscalc0107090000xml" indexer="include" status="PUBLISH"> + <title id="tit" xml-lang="en-US">Freeze Rows and Columns</title> + <filename>/text/scalc/01/07090000.xhp</filename> + </topic> +</meta> + +<body> + + +<section id="freeze_rows_and_columns"> +<bookmark xml-lang="en-US" branch="hid/.uno:FreezePanes" id="bm_id6343491" localize="false"/> + +<h1 id="hd_id3150517" xml-lang="en-US"><variable id="freezerowcolum"><link href="text/scalc/01/07090000.xhp" name="Freeze">Freeze Rows and Columns</link></variable></h1> +<paragraph id="par_id3156289" role="paragraph" xml-lang="en-US"><ahelp hid=".">Divides the sheet at the top left corner of the active cell and the area to the top left is no longer scrollable.</ahelp></paragraph> +</section> + +<section id="howtoget"> +<embed href="text/scalc/00/00000407.xhp#fefix"/> +</section> +<section id="relatedtopics"> +<embed href="text/scalc/guide/line_fix.xhp#line_fix"/> +<embed href="text/scalc/01/07090100.xhp#freezecellsh1"/> +</section> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/07090100.xhp b/helpcontent2/source/text/scalc/01/07090100.xhp new file mode 100644 index 000000000..7e7587324 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/07090100.xhp @@ -0,0 +1,37 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * +--> + +<meta> + <topic id="freezecells" indexer="include" status="PUBLISH"> + <title id="tit" xml-lang="en-US">Freeze Cells</title> + <filename>/text/scalc/01/07090100.xhp</filename> + </topic> +</meta> +<body> +<bookmark xml-lang="en-US" branch="index" id="bm_id821612315529410"> + <bookmark_value>freezing;first row</bookmark_value> + <bookmark_value>freezing;first column</bookmark_value> + <bookmark_value>freezing;cells</bookmark_value> +</bookmark> +<section id="freezecells"> +<h1 id="hd_id961612313262512"><variable id="freezecellsh1"><link href="text/scalc/01/07090100.xhp" name="Freeze Cells">Freeze Cells</link></variable></h1> +<paragraph id="par_id481612313262514" role="paragraph" xml-lang="en-US">Freezes the first column or the first row of the current spreadsheet.</paragraph> +</section> +<section id="howtoget"> +<embed href="text/scalc/00/00000407.xhp#freezefirstcol"/> +<embed href="text/scalc/00/00000407.xhp#freezefirstrow"/> +</section> +<section id="relatedtopics"> +<embed href="text/scalc/guide/line_fix.xhp#line_fix"/> +<embed href="text/scalc/01/07090000.xhp#freezerowcolum"/> +</section> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/12010000.xhp b/helpcontent2/source/text/scalc/01/12010000.xhp new file mode 100644 index 000000000..b655dee61 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/12010000.xhp @@ -0,0 +1,57 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> + +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . + --> + + +<meta> +<topic id="textscalc0112010000xml" indexer="include"> +<title id="tit" xml-lang="en-US">Define Database Range</title> +<filename>/text/scalc/01/12010000.xhp</filename> +</topic> +</meta> +<body> +<bookmark xml-lang="en-US" branch="hid/.uno:DefineDBName" id="bm_id6632476" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/definedatabaserangedialog/DefineDatabaseRangeDialog" id="bm_id3147335" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/definedatabaserangedialog/@@nowidget@@" id="bm_id3147335" localize="false"/> +<section id="defineDBrangeheader"> +<h1 id="hd_id3157909"><link href="text/scalc/01/12010000.xhp" name="Define Database Range">Define Range</link></h1> +<paragraph role="paragraph" id="par_id3155922" xml-lang="en-US"><variable id="bereichtext"><ahelp hid=".uno:DefineDBName">Defines a database range based on the selected cells in your sheet.</ahelp></variable></paragraph> +</section> + +<note id="par_id3149456">You can only select a rectangular cell range.</note> +<section id="howtoget"> +<embed href="text/scalc/00/00000412.xhp#dbrbf"/> +</section> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/definedatabaserangedialog/entry" id="bm_id3150868" localize="false"/> +<h2 id="hd_id3156422">Name</h2> +<paragraph role="paragraph" id="par_id3150770" xml-lang="en-US"><ahelp hid="modules/scalc/ui/definedatabaserangedialog/entry">Enter a name for the database range that you want to define, or select an existing name from the list.</ahelp></paragraph> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/definedatabaserangedialog/assign" id="bm_id3155133" localize="false"/> +<h2 id="hd_id3147228">Range</h2> +<paragraph role="paragraph" id="par_id3150441" xml-lang="en-US"><ahelp hid="modules/scalc/ui/definedatabaserangedialog/assign">Displays the selected cell range.</ahelp></paragraph> +<embed href="text/shared/00/00000001.xhp#shrink_maximize"/> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/definedatabaserangedialog/add" id="bm_id3153951" localize="false"/> +<h2 id="hd_id3153188">Add/Modify</h2> +<paragraph role="paragraph" id="par_id3153726" xml-lang="en-US"><ahelp hid="modules/scalc/ui/definedatabaserangedialog/add">Adds the selected cell range to the database range list, or modifies an existing database range.</ahelp></paragraph> +<embed href="text/shared/00/00000001.xhp#delete"/> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/definedatabaserangedialog/more" id="bm_id3152596" localize="false"/> +<h2 id="hd_id3150010">More >></h2> +<paragraph role="paragraph" id="par_id3153144" xml-lang="en-US"><ahelp hid="modules/scalc/ui/definedatabaserangedialog/more">Shows additional <link href="text/scalc/01/12010100.xhp" name="options">options</link>.</ahelp></paragraph> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/12010100.xhp b/helpcontent2/source/text/scalc/01/12010100.xhp new file mode 100644 index 000000000..57b2a0573 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/12010100.xhp @@ -0,0 +1,49 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . + --> + +<helpdocument version="1.0"> +<meta> +<topic id="textscalc0112010100xml" indexer="include" status="PUBLISH"> +<title xml-lang="en-US" id="tit">Options</title> +<filename>/text/scalc/01/12010100.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +</history> +</meta> +<body> + + + <paragraph role="heading" level="1" id="hd_id3154760" xml-lang="en-US">Options</paragraph> + <bookmark branch="hid/modules/scalc/ui/definedatabaserangedialog/ContainsColumnLabels" xml-lang="en-US" id="bm_id3150399" localize="false"/><paragraph role="heading" level="3" id="hd_id3153379" xml-lang="en-US">Contains column labels</paragraph> + <paragraph role="paragraph" id="par_id3148798" xml-lang="en-US"><ahelp hid="modules/scalc/ui/definedatabaserangedialog/ContainsColumnLabels" visibility="visible">Selected cell ranges contains labels.</ahelp></paragraph> + <bookmark branch="hid/modules/scalc/ui/definedatabaserangedialog/InsertOrDeleteCells" xml-lang="en-US" id="bm_id3156422" localize="false"/><paragraph role="heading" level="3" id="hd_id3153970" xml-lang="en-US">Insert or delete cells</paragraph> + <paragraph xml-lang="en-US" role="paragraph" id="par_id3154684"><ahelp hid="modules/scalc/ui/definedatabaserangedialog/InsertOrDeleteCells" visibility="visible">Automatically inserts new rows and columns into the database range in your document when new records are added to the database.</ahelp> To manually update the database range, choose <emph>Data - Refresh Range</emph>.</paragraph> + <bookmark branch="hid/modules/scalc/ui/definedatabaserangedialog/KeepFormatting" xml-lang="en-US" id="bm_id3151117" localize="false"/><paragraph role="heading" level="3" id="hd_id3153768" xml-lang="en-US">Keep formatting</paragraph> + <paragraph role="paragraph" id="par_id3147435" xml-lang="en-US"><ahelp hid="modules/scalc/ui/definedatabaserangedialog/KeepFormatting" visibility="visible">Applies the existing cell format of headers and first data row to the whole database range.</ahelp></paragraph> + <bookmark branch="hid/modules/scalc/ui/definedatabaserangedialog/DontSaveImportedData" xml-lang="en-US" id="bm_id3145748" localize="false"/><paragraph role="heading" level="3" id="hd_id3155856" xml-lang="en-US">Don't save imported data</paragraph> + <paragraph role="paragraph" id="par_id3153363" xml-lang="en-US"><ahelp hid="modules/scalc/ui/definedatabaserangedialog/DontSaveImportedData" visibility="visible">Only saves a reference to the database, and not the contents of the cells.</ahelp></paragraph> + <paragraph role="heading" level="3" id="hd_id3147428" xml-lang="en-US">Source:</paragraph> + <paragraph role="paragraph" id="par_id3148576" xml-lang="en-US">Displays information about the current database source and any existing operators.</paragraph> + <paragraph role="heading" level="2" id="hd_id3146976" xml-lang="en-US">More <<</paragraph> + <paragraph role="paragraph" id="par_id3149664" xml-lang="en-US">Hides the additional options.</paragraph> + </body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/12020000.xhp b/helpcontent2/source/text/scalc/01/12020000.xhp new file mode 100644 index 000000000..50b18d46c --- /dev/null +++ b/helpcontent2/source/text/scalc/01/12020000.xhp @@ -0,0 +1,48 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . + --> +<helpdocument version="1.0"> +<meta> +<topic id="textscalc0112020000xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Select Database Range</title> +<filename>/text/scalc/01/12020000.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +</history> +</meta> +<body> +<bookmark xml-lang="en-US" branch="index" id="bm_id3145068"><bookmark_value>databases; selecting (Calc)</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/.uno:SelectDB" id="bm_id2131630" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/selectrange/SelectRangeDialog" id="bm_id3148946" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/selectrange/@@nowidget@@" id="bm_id3148946" localize="false"/> + +<section id="selectDBheader"> +<h1 id="hd_id3145068"><link href="text/scalc/01/12020000.xhp" name="Select Database Range">Select Range</link></h1> +<paragraph role="paragraph" id="par_id3149655" xml-lang="en-US"><variable id="bereichwaehlen"><ahelp hid=".uno:SelectDB">Selects a database range that you defined under <link href="text/scalc/01/12010000.xhp" name="Data - Define Range">Data - Define Range</link>.</ahelp></variable></paragraph> +</section> + +<section id="howtoget"> + <embed href="text/scalc/00/00000412.xhp#dbrba"/> +</section> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/selectrange/treeview" id="bm_id3125865" localize="false"/> +<h2 id="hd_id3153192">Ranges</h2> +<paragraph role="paragraph" id="par_id3154684" xml-lang="en-US"><ahelp hid="modules/scalc/ui/selectrange/treeview">Lists the available database ranges. To select a database range, click its name, and then click <emph>OK</emph>.</ahelp></paragraph> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/12030000.xhp b/helpcontent2/source/text/scalc/01/12030000.xhp new file mode 100644 index 000000000..5eddab9f9 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/12030000.xhp @@ -0,0 +1,44 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . + --> +<helpdocument version="1.0"> +<meta> +<topic id="textscalc0112030000xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Sort</title> +<filename>/text/scalc/01/12030000.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +</history> +</meta> +<body> +<bookmark xml-lang="en-US" branch="hid/.uno:DataSort" id="bm_id3150084" localize="false"/> +<section id="sortheader"> +<h1 id="hd_id3150275"><link href="text/scalc/01/12030000.xhp" name="">Sort</link></h1> +<paragraph role="paragraph" id="par_id3155922" xml-lang="en-US"><variable id="sorttext"><ahelp hid=".uno:DataSort">Sorts the selected rows according to the conditions that you specify.</ahelp> +</variable> $[officename] automatically recognizes and selects database ranges.</paragraph> +</section> +<note id="par_id3147428">You cannot sort data if the <link href="text/shared/01/02230000.xhp" name="Record changes">Record changes</link> options is enabled.</note> +<section id="howtoget"> + <embed href="text/scalc/00/00000412.xhp#dnsrt"/> +</section> +<embed href="text/scalc/01/12030100.xhp#sort_criteria"/> +<embed href="text/scalc/01/12030200.xhp#options"/> +<embed href="text/shared/00/00000001.xhp#reset"/> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/12030100.xhp b/helpcontent2/source/text/scalc/01/12030100.xhp new file mode 100644 index 000000000..be87bba34 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/12030100.xhp @@ -0,0 +1,61 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . + --> +<helpdocument version="1.0"> +<meta> +<topic id="textscalc0112030100xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Sort Criteria</title> +<filename>/text/scalc/01/12030100.xhp</filename> +</topic> +</meta> +<body> +<section id="sort_criteria"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3152350"><bookmark_value>sorting; sort criteria for database ranges</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/sortcriteriapage/SortCriteriaPage" id="bm_id3156326" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/sortcriteriapage/@@nowidget@@" id="bm_id3156326" localize="false"/> +<h1 id="hd_id3152350"><link href="text/scalc/01/12030100.xhp" name="Sort Criteria">Sort Criteria</link></h1> +<paragraph role="paragraph" id="par_id3151385" xml-lang="en-US"><ahelp hid="modules/scalc/ui/sortcriteriapage/SortCriteriaPage">Specify the sorting options for the selected range.</ahelp></paragraph> +</section> +<note id="par_id3152462">Ensure that you include any row and column titles in the selection.</note> +<section id="howtoget"> + <embed href="text/scalc/00/00000412.xhp#sort_criteria"/> +</section> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/sortkey/@@nowidget@@" id="bm_id3147434" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/sortkey/SortKeyFrame" id="bm_id3147434" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/sortkey/sortlb" id="bm_id3147434" localize="false"/> +<h2 id="hd_id3147428">Sort by</h2> +<paragraph role="paragraph" id="par_id3155854" xml-lang="en-US"><ahelp hid="modules/scalc/ui/sortkey/sortlb">Select the column that you want to use as the primary sort key.</ahelp></paragraph> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/sortkey/up" id="bm_id3153142" localize="false"/><h3 id="hd_id3146121">Ascending</h3> +<paragraph role="paragraph" id="par_id3148645" xml-lang="en-US"><ahelp hid="modules/scalc/ui/sortkey/up">Sorts the selection from the lowest value to the highest value. The sorting rules are given by the locale. You can define the sort rules on Data - Sort - Options.</ahelp> You define the default on <switchinline select="sys"><caseinline select="MAC">%PRODUCTNAME - Preferences</caseinline><defaultinline>Tools - Options</defaultinline></switchinline> - Language Settings - Languages.</paragraph> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/sortkey/down" id="bm_id3149377" localize="false"/><h3 id="hd_id3155411">Descending</h3> +<paragraph role="paragraph" id="par_id3151075" xml-lang="en-US"><ahelp hid="modules/scalc/ui/sortkey/down">Sorts the selection from the highest value to the lowest value. You can define the sort rules on Data - Sort - Options.</ahelp> You define the default on <switchinline select="sys"><caseinline select="MAC">%PRODUCTNAME - Preferences</caseinline><defaultinline>Tools - Options</defaultinline></switchinline> - Language Settings - Languages.</paragraph> +<h2 id="hd_id3154492">Then by</h2> +<paragraph role="paragraph" id="par_id3156283" xml-lang="en-US">Select the column that you want to use as the secondary sort key.</paragraph> +<h3 id="hd_id3149413">Ascending</h3> +<paragraph role="paragraph" id="par_id3154018" xml-lang="en-US">Sorts the selection from the lowest value to the highest value. You can define the sort rules on Data - Sort - Options. You define the default on <switchinline select="sys"><caseinline select="MAC">%PRODUCTNAME - Preferences</caseinline><defaultinline>Tools - Options</defaultinline></switchinline> - Language settings - Languages.</paragraph> +<h3 id="hd_id3146972">Descending</h3> +<paragraph role="paragraph" id="par_id3145640" xml-lang="en-US">Sorts the selection from the highest value to the lowest value. You can define the sort rules on Data - Sort - Options. You define the default on <switchinline select="sys"><caseinline select="MAC">%PRODUCTNAME - Preferences</caseinline><defaultinline>Tools - Options</defaultinline></switchinline> - Language settings - Languages.</paragraph> +<bookmark xml-lang="en-US" branch="hid/.uno:SortAscending" id="bm_id1196545" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/.uno:SortDescending" id="bm_id1104741" localize="false"/> +<h2 id="hd_id3150300">Sort Ascending/Descending</h2> +<paragraph role="paragraph" id="par_id3158212" xml-lang="en-US"><ahelp hid="."><variable id="sytext">Sorts the selection from the highest to the lowest value, or from the lowest to the highest value. Number fields are sorted by size and text fields by the order of the characters. You can define the sort rules on Data - Sort - Options.</variable></ahelp> You define the default on <switchinline select="sys"><caseinline select="MAC">%PRODUCTNAME - Preferences</caseinline><defaultinline>Tools - Options</defaultinline></switchinline> - Language settings - Languages.</paragraph> +<paragraph role="paragraph" id="par_id3159236" xml-lang="en-US">Icons on the <emph>Standard</emph> toolbar</paragraph> +<embed href="text/scalc/00/00000412.xhp#sysort_criteria"/> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/12030200.xhp b/helpcontent2/source/text/scalc/01/12030200.xhp new file mode 100644 index 000000000..2dbd0cb88 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/12030200.xhp @@ -0,0 +1,95 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . + --> + +<meta> +<topic id="textscalc0112030200xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Options</title> +<filename>/text/scalc/01/12030200.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +</history> +</meta> +<body> +<section id="options"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3147228"><bookmark_value>sorting; options for database ranges</bookmark_value> +<bookmark_value>sorting;Asian languages</bookmark_value> +<bookmark_value>Asian languages;sorting</bookmark_value> +<bookmark_value>phonebook sorting rules</bookmark_value> +<bookmark_value>natural sort algorithm</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/sortoptionspage/SortOptionsPage" id="bm_id3151044" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/sortoptionspage/@@nowidget@@" id="bm_id3151044" localize="false"/> +<h1 id="hd_id3147228" xml-lang="en-US"><link href="text/scalc/01/12030200.xhp" name="Options"> Options</link></h1> +<paragraph role="paragraph" id="par_id3153770" xml-lang="en-US"><ahelp hid="modules/scalc/ui/sortoptionspage/SortOptionsPage"> Sets additional sorting options.</ahelp></paragraph> +</section> +<section id="howtoget"> + <embed href="text/scalc/00/00000412.xhp#dnstot"/> +</section> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/sortoptionspage/case" id="bm_id3149664" localize="false"/> +<h2 id="hd_id3146976" xml-lang="en-US">Case sensitive</h2> +<paragraph role="paragraph" id="par_id3153091" xml-lang="en-US"><ahelp hid="modules/scalc/ui/sortoptionspage/case">Sorts first by uppercase letters and then by lowercase letters. For Asian languages, special handling applies.</ahelp></paragraph> +<note id="par_idN10637" xml-lang="en-US">For Asian languages: Check <emph>Case Sensitive</emph> to apply multi-level collation. With multi-level collation, entries are first compared in their primitive forms with their cases and diacritics ignored. If they evaluate as the same, their diacritics are taken into account for the second-level comparison. If they still evaluate as the same, their cases, character widths, and Japanese Kana difference are considered for the third-level comparison.<comment>UFI: see #112590# and #112507#</comment></note> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/sortoptionspage/header" id="bm_id3145271" localize="false"/> +<h2 id="hd_id3155856">Range contains row/column labels</h2> +<paragraph role="paragraph" id="par_id3154014" xml-lang="en-US"><ahelp hid="modules/scalc/ui/sortoptionspage/header"> Omits the first row or the first column in the selection from the sort.</ahelp> The <emph>Direction</emph> setting at the bottom of the dialog defines the name and function of this check box.</paragraph> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/sortoptionspage/formats" id="bm_id3149410" localize="false"/> +<h2 id="hd_id3147436"> Include formats</h2> +<paragraph role="paragraph" id="par_id3149377" xml-lang="en-US"><ahelp hid="modules/scalc/ui/sortoptionspage/formats"> Preserves the current cell formatting.</ahelp></paragraph> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/sortoptionspage/naturalsort" id="bm_id3149412" localize="false"/> +<h2 id="hd_id3147438">Enable natural sort</h2> +<paragraph role="paragraph" id="par_id3149378" xml-lang="en-US"><ahelp hid="modules/scalc/ui/sortoptionspage/naturalsort">Natural sort is a sort algorithm that sorts string-prefixed numbers based on the value of the numerical element in each sorted number, instead of the traditional way of sorting them as ordinary strings.</ahelp> For instance, let's assume you have a series of values such as, A1, A2, A3, A4, A5, A6, ..., A19, A20, A21. When you put these values into a range of cells and run the sort, it will become A1, A11, A12, A13, ..., A19, A2, A20, A21, A3, A4, A5, ..., A9. While this sorting behavior may make sense to those who understand the underlying sorting mechanism, to the rest of the population it seems completely bizarre, if not outright inconvenient. With the natural sort feature enabled, values such as the ones in the above example get sorted "properly", which improves the convenience of sorting operations in general.</paragraph> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/sortoptionspage/includenotes" id="bm_id331610760238867" localize="false"/> +<h2 id="hd_id71610757096466">Include boundary column(s)/row(s) containing only comments</h2> +<paragraph role="paragraph" id="par_id431610757186031">Range boundary columns (for sorting rows) or boundary rows (for sorting columns) of a sorting range are not sorted by default if they are empty. Check this option if boundary columns or boundary rows containing comments are also to be sorted.</paragraph> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/sortoptionspage/includeimages" id="bm_id331610760238867" localize="false"/> +<h2 id="hd_id161610757296697">Include boundary column(s)/row(s) containing only images</h2> +<paragraph role="paragraph" id="par_id181610758875786">Border columns (for sorting rows) or border rows (for sorting columns) of a sorting area are not sorted by default if they are empty. Check this option if boundary columns or boundary rows containing images are also to be sorted.</paragraph> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/sortoptionspage/copyresult" id="bm_id3147124" localize="false"/> +<h2 id="hd_id3153878"> Copy sort results to:</h2> +<paragraph role="paragraph" id="par_id3156286" xml-lang="en-US"><ahelp hid="modules/scalc/ui/sortoptionspage/copyresult"> Copies the sorted list to the cell range that you specify.</ahelp></paragraph> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/sortoptionspage/outarealb" id="bm_id3149403" localize="false"/> +<h3 id="hd_id3153418"> Sort results (named ranges list)</h3> +<paragraph role="paragraph" id="par_id3155602" xml-lang="en-US"><ahelp hid="modules/scalc/ui/sortoptionspage/outarealb"> Select a named <link href="text/scalc/01/12010000.xhp" name="cell range"> cell range</link> where you want to display the sorted list.</ahelp></paragraph> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/sortoptionspage/outareaed" id="bm_id3153767" localize="false"/> +<h3 id="hd_id3153707"> Sort results (input box)</h3> +<paragraph role="paragraph" id="par_id3145642" xml-lang="en-US"><ahelp hid="modules/scalc/ui/sortoptionspage/outareaed">Enter the cell range where you want to display the sorted list.</ahelp></paragraph> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/sortoptionspage/sortuser" id="bm_id3147339" localize="false"/> +<h2 id="hd_id3155445"> Custom sort order</h2> +<paragraph role="paragraph" id="par_id3156385" xml-lang="en-US"><ahelp hid="modules/scalc/ui/sortoptionspage/sortuser"> Click here and then select the custom sort order that you want.</ahelp></paragraph> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/sortoptionspage/sortuserlb" id="bm_id3146917" localize="false"/> +<h3 id="hd_id3154704"> Custom sort order list</h3> +<paragraph role="paragraph" id="par_id3155962" xml-lang="en-US"><ahelp hid="modules/scalc/ui/sortoptionspage/sortuserlb"> Select the custom sort order that you want to apply. To define a custom sort order, choose <switchinline select="sys"><caseinline select="MAC"><menuitem>%PRODUCTNAME - Preferences</menuitem></caseinline><defaultinline><menuitem>Tools - Options</menuitem></defaultinline></switchinline> - <link href="text/shared/optionen/01060400.xhp" name="%PRODUCTNAME Calc - Sort Lists"><menuitem>%PRODUCTNAME Calc - Sort Lists</menuitem></link>.</ahelp></paragraph> +<h2 id="hd_id3149257"> Language</h2> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/sortoptionspage/language" id="bm_id3150299" localize="false"/> +<h3 id="hd_id3147004"> Language</h3> +<paragraph role="paragraph" id="par_id3150787" xml-lang="en-US"><ahelp hid="modules/scalc/ui/sortoptionspage/language"> Select the language for the sorting rules.</ahelp></paragraph> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/sortoptionspage/algorithmlb" id="bm_id3150304" localize="false"/> +<h3 id="hd_id3150344"> Options</h3> +<paragraph role="paragraph" id="par_id3155113" xml-lang="en-US"><ahelp hid="modules/scalc/ui/sortoptionspage/algorithmlb"> Select a sorting option for the language.</ahelp> For example, select the "phonebook" option for German to include the umlaut special character in the sorting.</paragraph> +<h2 id="hd_id3152580"> Direction</h2> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/sortoptionspage/topdown" id="bm_id3155507" localize="false"/> +<h3 id="hd_id3154201"> Top to Bottom (Sort Rows)</h3> +<paragraph role="paragraph" id="par_id3166430" xml-lang="en-US"><ahelp hid="modules/scalc/ui/sortoptionspage/topdown"> Sorts rows by the values in the active columns of the selected range.</ahelp></paragraph> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/sortoptionspage/leftright" id="bm_id3155529" localize="false"/> +<h3 id="hd_id3145588"> Left to Right (Sort Columns)</h3> +<paragraph role="paragraph" id="par_id3154370" xml-lang="en-US"><ahelp hid="modules/scalc/ui/sortoptionspage/leftright"> Sorts columns by the values in the active rows of the selected range.</ahelp></paragraph> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/12040000.xhp b/helpcontent2/source/text/scalc/01/12040000.xhp new file mode 100644 index 000000000..158888ea5 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/12040000.xhp @@ -0,0 +1,44 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . + --> +<meta> + <topic id="textscalc0112040000xml" indexer="include"> + <title id="tit" xml-lang="en-US">More Filters</title> + <filename>/text/scalc/01/12040000.xhp</filename> + </topic> +</meta> +<body> + <section id="filter"> + <bookmark xml-lang="en-US" branch="hid/.uno:FilterMenu" id="bm_id102920080228246" localize="false"/> + <h1 id="hd_id3150767"><link href="text/scalc/01/12040000.xhp" name="Filter">More Filters</link></h1> + <paragraph role="paragraph" id="par_id3155131" xml-lang="en-US"><ahelp hid=".">Shows commands to filter your data.</ahelp></paragraph> + </section> + <section id="howtoget"> + <embed href="text/scalc/00/00000412.xhp#dnftr"/> + </section> + <tip id="par_id911633127394220">%PRODUCTNAME automatically recognizes predefined database ranges.</tip> + <paragraph role="paragraph" id="par_id3153363" xml-lang="en-US">The following filtering options are available:</paragraph> + <h2 id="hd_id3153728"><link href="text/shared/02/12090000.xhp" name="Standard filter">Standard filter</link></h2> + <embed href="text/shared/02/12090000.xhp#standardfilter"/> + <h2 id="hd_id3159153"><link href="text/scalc/01/12040300.xhp" name="Advanced filter">Advanced filter</link></h2> + <embed href="text/scalc/01/12040300.xhp#spezialfilter"/> + <embed href="text/scalc/01/12040400.xhp#reset_filter"/> + <embed href="text/scalc/01/12040500.xhp#hide_autofilter"/> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/12040100.xhp b/helpcontent2/source/text/scalc/01/12040100.xhp new file mode 100644 index 000000000..599def1e3 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/12040100.xhp @@ -0,0 +1,70 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . + --> +<helpdocument version="1.0"> +<meta> +<topic id="textscalc0112040100xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">AutoFilter</title> +<filename>/text/scalc/01/12040100.xhp</filename> +</topic> +</meta> +<body> +<section id="autofilter"> +<bookmark xml-lang="en-US" branch="hid/.uno:DataFilterAutoFilter" id="bm_id5427750" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/filterdropdown/FilterDropDown" id="bm_id361621531206029" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/filterdropdown/@@nowidget@@" id="bm_id151621531292577" localize="false"/> +<h1 id="hd_id3153541"><variable id="autofilterh1"><link href="text/scalc/01/12040100.xhp" name="AutoFilter">AutoFilter</link></variable></h1> +<paragraph role="paragraph" id="par_id3148550" xml-lang="en-US"><ahelp hid=".uno:DataFilterAutoFilter">Automatically filters the selected cell range, and creates one-row list boxes where you can choose the items that you want to display.</ahelp></paragraph> +</section> +<section id="howtoget"> + <embed href="text/scalc/00/00000412.xhp#autofilter"/> +</section> +<embed href="text/scalc/guide/autofilter.xhp#autofiltertip"/> + +<h3 id="hd_id101621534096986">Sort Ascending</h3> +<paragraph role="paragraph" id="par_id31621544435954">Displays the rows of the cell range in ascending order, based on the values in the cells of the current column.</paragraph> +<h3 id="hd_id561621534101425">Sort Descending</h3> +<paragraph role="paragraph" id="par_id861621544431393">Displays the rows of the cell range in descending order, based on the values in the cells of the current column.</paragraph> +<h3 id="hd_id401621534105620">Top 10</h3> +<paragraph role="paragraph" id="par_id341621544426925">Displays the 10 rows of the cell range that contain the largest values in the cells of the current column. If these values are unique then no more than 10 rows will be visible, but if the values are not unique then it is possible for more than 10 rows to be shown.</paragraph> +<h3 id="hd_id541621534109912">Empty</h3> +<paragraph role="paragraph" id="par_id941621544422352">Displays only the rows of the cell range that have an empty cell in the current column.</paragraph> +<h3 id="hd_id821621534116893">Not Empty</h3> +<paragraph role="paragraph" id="par_id71621544418559">Displays only the rows of the cell range that have a non-empty cell in the current column.</paragraph> +<h3 id="hd_id271621534120995">Text color</h3> +<paragraph role="paragraph" id="par_id691621544414646">Displays only the rows of the cell range for which the text color of the cell in the current column matches the color selected.</paragraph> +<h3 id="hd_id151621534125831">Background color</h3> +<paragraph role="paragraph" id="par_id491621544410605">Displays only the rows of the cell range for which the background color of the cell in the current column matches the color selected.</paragraph> +<h3 id="hd_id851621534131430">Standard Filter</h3> +<paragraph role="paragraph" id="par_id171621544405886">Opens the <link href="text/shared/02/12090000.xhp" name="standard filter">Standard Filter</link> dialog.</paragraph> +<h3 id="hd_id551621534136181">Search text box</h3> +<paragraph role="paragraph" id="par_id421621544399700">Search for a specific entry in the list of values found in the current column. As characters are typed in the text box, this list is updated to show only matching entries.</paragraph> +<h3 id="hd_id581621534140892">All</h3> +<paragraph role="paragraph" id="par_id641621544394836">Click once to select to show all rows and click again to select to hide all rows.</paragraph> +<h3 id="hd_id731621534146408">Show only current</h3> +<paragraph role="paragraph" id="par_id71621544390147">Display only rows containing the value highlighted in the <emph>Value</emph> box.</paragraph> +<h3 id="hd_id11621534151081">Hide only current</h3> +<paragraph role="paragraph" id="par_id491621544384770">Hide all rows containing the value highlighted in the <emph>Value</emph> box and display all other rows.</paragraph> +<h3 id="hd_id621621534155662">Values</h3> +<paragraph role="paragraph" id="par_id331621544378745">List of unique values found in the current column.</paragraph> +<section id="relatedtopics"> +<embed href="text/scalc/guide/autofilter.xhp#autofilter"/> +<paragraph role="paragraph" id="par_id3145171" xml-lang="en-US"><link href="text/shared/02/12090000.xhp" name="Default filter">Default filter</link></paragraph> +</section> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/12040201.xhp b/helpcontent2/source/text/scalc/01/12040201.xhp new file mode 100644 index 000000000..be0a948e1 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/12040201.xhp @@ -0,0 +1,76 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> + +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . + --> + +<meta> + <topic id="textscalc0112040201xml" indexer="include"> + <title id="tit" xml-lang="en-US">Options</title> + <filename>/text/scalc/01/12040201.xhp</filename> + </topic> +</meta> +<body> +<h1 id="hd_id3148492"><link href="text/scalc/01/12040201.xhp" name="Options">Options</link></h1> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/standardfilterdialog/more" id="bm_id3152350" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/advancedfilterdialog/more" id="bm_id3156023" localize="false"/> +<paragraph role="paragraph" id="par_id3159400" xml-lang="en-US"><variable id="zusaetzetext"><ahelp hid="modules/scalc/ui/advancedfilterdialog/more">Shows additional filter options.</ahelp> +</variable></paragraph> +<section id="howtoget"> + <embed href="text/scalc/00/00000412.xhp#filter_options"/> +</section> + <h2 id="hd_id3150791">Options</h2> + <bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/standardfilterdialog/case" id="bm_id3151210" localize="false"/> + <bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/advancedfilterdialog/case" id="bm_id3150871" localize="false"/> +<section id="FilterOptions_Pt1"> + <h3 id="hd_id3154138">Case sensitive</h3> + <paragraph role="paragraph" id="par_id3147228" xml-lang="en-US"><ahelp hid="modules/scalc/ui/advancedfilterdialog/case">Distinguishes between uppercase and lowercase letters when filtering the data.</ahelp></paragraph> + <bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/standardfilterdialog/header" id="bm_id3153968" localize="false"/> + <bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/advancedfilterdialog/header" id="bm_id3145173" localize="false"/> + <h3 id="hd_id3154908">Range contains column labels</h3> + <paragraph role="paragraph" id="par_id3153768" xml-lang="en-US"><ahelp hid="modules/scalc/ui/advancedfilterdialog/header">Includes the column labels in the first row of a cell range.</ahelp></paragraph> + <bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/standardfilterdialog/copyresult" id="bm_id3147426" localize="false"/> + <bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/advancedfilterdialog/copyresult" id="bm_id3148576" localize="false"/> + <bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/standardfilterdialog/lbcopyarea" id="bm_id3163713" localize="false"/> + <bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/advancedfilterdialog/lbcopyarea" id="bm_id3147349" localize="false"/> + <bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/standardfilterdialog/edcopyarea" id="bm_id3147348" localize="false"/> + <bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/advancedfilterdialog/edcopyarea" id="bm_id3153093" localize="false"/> + <h3 id="hd_id3155306">Copy results to</h3> + <paragraph role="paragraph" id="par_id3154319" xml-lang="en-US"><ahelp hid="modules/scalc/ui/advancedfilterdialog/edcopyarea">Select the check box, and then select the cell range where you want to display the filter results.</ahelp> You can also select a named range from the list.</paragraph> +</section> +<embed href="text/shared/00/00000001.xhp#shrink_maximize"/> +<section id="FilterOptions_Pt2"> + <bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/standardfilterdialog/regexp" id="bm_id3153726" localize="false"/> + <bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/advancedfilterdialog/regexp" id="bm_id3153144" localize="false"/> + <h3 id="hd_id3145272">Regular expression</h3> + <paragraph role="paragraph" id="par_id3152576" xml-lang="en-US"><ahelp hid="modules/scalc/ui/advancedfilterdialog/regexp">Allows you to use regular expressions in the filter definition.</ahelp> For a list of the regular expressions that $[officename] supports, click <link href="text/shared/01/02100001.xhp" name="here">here</link>.</paragraph> + <paragraph role="paragraph" id="par_id3149377" xml-lang="en-US">If the <emph>Regular Expressions</emph> check box is selected, you can use regular expressions in the Value field if the Condition list box is set to '=' EQUAL or '<>' UNEQUAL. This also applies to the respective cells that you reference for an advanced filter.</paragraph> + <bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/standardfilterdialog/unique" id="bm_id3149410" localize="false"/> + <bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/advancedfilterdialog/unique" id="bm_id3147126" localize="false"/> + <h3 id="hd_id3149958">No duplication</h3> + <paragraph role="paragraph" id="par_id3153876" xml-lang="en-US"><ahelp hid="modules/scalc/ui/advancedfilterdialog/unique">Excludes duplicate rows in the list of filtered data.</ahelp></paragraph> + <bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/advancedfilterdialog/destpers" id="bm_id3149403" localize="false"/> + <bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/standardfilterdialog/destpers" id="bm_id3149402" localize="false"/> + <h3 id="hd_id3154018">Keep filter criteria</h3> + <paragraph role="paragraph" id="par_id3149123" xml-lang="en-US"><ahelp hid="modules/scalc/ui/standardfilterdialog/destpers">Select the <emph>Copy results to</emph> check box, and then specify the destination range where you want to display the filtered data. If this box is checked, the destination range remains linked to the source range. You must have defined the source range under <emph>Data - Define range</emph> as a database range.</ahelp> Following this, you can reapply the defined filter at any time as follows: click into the source range, then choose <emph>Data - Refresh Range</emph>.</paragraph> +</section> +<h2 id="hd_id3149018">Data range</h2> +<paragraph role="paragraph" id="par_id3150042" xml-lang="en-US">Displays the cell range or the name of the cell range that you want to filter.</paragraph> +<embed href="text/shared/00/00000001.xhp#options"/> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/12040300.xhp b/helpcontent2/source/text/scalc/01/12040300.xhp new file mode 100644 index 000000000..5e5573ead --- /dev/null +++ b/helpcontent2/source/text/scalc/01/12040300.xhp @@ -0,0 +1,54 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> + +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . + --> + +<meta> + <topic id="textscalc0112040300xml" indexer="include"> + <title id="tit" xml-lang="en-US">Advanced Filter</title> + <filename>/text/scalc/01/12040300.xhp</filename> + </topic> +</meta> +<body> +<bookmark xml-lang="en-US" branch="hid/.uno:DataFilterSpecialFilter" id="bm_id4998774" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/advancedfilterdialog/AdvancedFilterDialog" id="bm_id3154366" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/advancedfilterdialog/@@nowidget@@" id="bm_id3154366" localize="false"/> +<paragraph role="heading" id="hd_id3158394" xml-lang="en-US" level="1">Advanced Filter</paragraph> +<paragraph role="paragraph" id="par_id3156281" xml-lang="en-US"><variable id="spezialfilter"><ahelp hid=".uno:DataFilterSpecialFilter">Defines an advanced filter.</ahelp> +</variable></paragraph> +<section id="howtoget"> + <embed href="text/scalc/00/00000412.xhp#dnfspz"/> +</section> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/advancedfilterdialog/lbfilterarea" id="bm_id3149664" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/advancedfilterdialog/edfilterarea" id="bm_id3151113" localize="false"/> +<paragraph role="heading" id="hd_id3153771" xml-lang="en-US" level="2">Read filter criteria from</paragraph> +<paragraph role="paragraph" id="par_id3147426" xml-lang="en-US"><ahelp hid="modules/scalc/ui/advancedfilterdialog/edfilterarea">Select the named range, or enter the cell range that contains the filter criteria that you want to use.</ahelp></paragraph> +<embed href="text/shared/00/00000001.xhp#shrink_maximize"/> +<h2 id="hd_id331625165680452">Options</h2> +<embed href="text/scalc/01/12040201.xhp#zusaetzetext"/> +<embed href="text/scalc/01/12040201.xhp#FilterOptions_Pt1"/> +<embed href="text/scalc/01/12040201.xhp#FilterOptions_Pt2"/> +<embed href="text/scalc/guide/specialfilter.xhp#AdvancedFilter"/> + +<section id="relatedtopics"> + <embed href="text/scalc/guide/filters.xhp#filters"/> + <embed href="text/scalc/guide/autofilter.xhp#autofilter"/> +</section> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/12040400.xhp b/helpcontent2/source/text/scalc/01/12040400.xhp new file mode 100644 index 000000000..584b426f6 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/12040400.xhp @@ -0,0 +1,44 @@ +<?xml version="1.0" encoding="UTF-8"?> + + + +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . + --> + + + <helpdocument version="1.0"> +<meta> +<topic id="textscalc0112040400xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Reset Filter</title> +<filename>/text/scalc/01/12040400.xhp</filename> +</topic> +</meta> +<body> +<section id="reset_filter"> +<bookmark xml-lang="en-US" branch="hid/.uno:DataFilterRemoveFilter" id="bm_id2352791" localize="false"/> +<paragraph role="heading" id="hd_id3153087" xml-lang="en-US" level="1"><link href="text/scalc/01/12040400.xhp" name="Remove Filter">Reset Filter</link></paragraph> +<paragraph role="paragraph" id="par_id3154760" xml-lang="en-US"><ahelp hid=".uno:DataFilterRemoveFilter">Removes the filter from the selected cell range. To enable this command, click inside the cell area where the filter was applied.</ahelp></paragraph> +</section> +<section id="howtoget"> +<embed href="text/scalc/00/00000412.xhp#reset_filter"/> +</section> +<section id="relatedtopics"> +<embed href="text/scalc/guide/filters.xhp#filters"/> +</section> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/12040500.xhp b/helpcontent2/source/text/scalc/01/12040500.xhp new file mode 100644 index 000000000..7fc8f49a3 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/12040500.xhp @@ -0,0 +1,45 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . + --> + +<helpdocument version="1.0"> +<meta> +<topic id="textscalc0112040500xml" indexer="include" status="PUBLISH"> +<title xml-lang="en-US" id="tit">Hide AutoFilter</title> +<filename>/text/scalc/01/12040500.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +</history> +</meta> +<body> + + + <section id="hide_autofilter"> + <bookmark xml-lang="en-US" branch="index" id="bm_id3150276"><bookmark_value>database ranges; hiding AutoFilter</bookmark_value></bookmark> +<bookmark branch="hid/.uno:DataFilterHideAutoFilter" xml-lang="en-US" id="bm_id3145674" localize="false"/> +<paragraph id="hd_id3150276" role="heading" level="1" xml-lang="en-US"><link href="text/scalc/01/12040500.xhp" name="Hide AutoFilter">Hide AutoFilter</link></paragraph> + <paragraph role="paragraph" id="par_id3156326" xml-lang="en-US"><ahelp hid=".uno:DataFilterHideAutoFilter" visibility="visible">Hides the AutoFilter buttons in the selected cell range.</ahelp></paragraph> + </section> + <section id="howtoget"> + <embed href="text/scalc/00/00000412.xhp#dnaftas"/> +</section> + </body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/12050000.xhp b/helpcontent2/source/text/scalc/01/12050000.xhp new file mode 100644 index 000000000..be438446d --- /dev/null +++ b/helpcontent2/source/text/scalc/01/12050000.xhp @@ -0,0 +1,49 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . + --> +<helpdocument version="1.0"> +<meta> +<topic id="textscalc0112050000xml" indexer="include" status="PUBLISH"> +<title xml-lang="en-US" id="tit">Subtotals</title> +<filename>/text/scalc/01/12050000.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +</history> +</meta> +<body> + +<bookmark branch="hid/.uno:DataSubTotals" xml-lang="en-US" id="bm_id3154515" localize="false"/> +<section id="subtotalheader"> + <h1 id="hd_id3153822"><variable id="subtotalheaderh1"><link href="text/scalc/01/12050000.xhp" name="subtotals">Subtotals</link></variable></h1> + <paragraph role="paragraph" id="par_id3145119" xml-lang="en-US"><variable id="teilergebnisse"><ahelp hid=".uno:DataSubTotals" visibility="visible">Calculates subtotals for the columns that you select.</ahelp></variable> $[officename] uses the SUM function to automatically calculate the subtotal and grand total values in a labeled range. You can also use other functions to perform the calculation. $[officename] automatically recognizes a defined database area when you place the cursor in it.</paragraph> + </section> + <section id="howtoget"> + <embed href="text/scalc/00/00000412.xhp#dntegs"/> +</section> + <paragraph role="paragraph" id="par_id3153896" xml-lang="en-US">For example, you can generate a sales summary for a certain postal code based on data from a client database.</paragraph> + <embed href="text/scalc/01/12050100.xhp#group"/> + <embed href="text/scalc/01/12050200.xhp#options"/> + <embed href="text/shared/00/00000001.xhp#reset"/> + <h2 id="hd_id3163708">Delete</h2> + <paragraph role="paragraph" id="par_id3154125" xml-lang="en-US">Deletes the subtotal rows in the selected area.</paragraph> + <section id="relatedtopics"> + <embed href="text/scalc/guide/subtotaltool.xhp#subtotaltoolh1"/> +</section> + </body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/12050100.xhp b/helpcontent2/source/text/scalc/01/12050100.xhp new file mode 100644 index 000000000..fe96b4548 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/12050100.xhp @@ -0,0 +1,52 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . + --> +<helpdocument version="1.0"> +<meta> +<topic id="textscalc0112050100xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">1st, 2nd, 3rd Group</title> +<filename>/text/scalc/01/12050100.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +</history> +</meta> +<body> +<section id="group"> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/subtotalgrppage/SubTotalGrpPage" id="bm_id3147335" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/subtotalgrppage/@@nowidget@@" id="bm_id3147335" localize="false"/> +<h1 id="hd_id3149784"><link href="text/scalc/01/12050100.xhp" name="1st, 2nd, 3rd Group">1st, 2nd, 3rd Group</link></h1> +<paragraph role="paragraph" id="par_id3145068" xml-lang="en-US"><ahelp hid="modules/scalc/ui/subtotalgrppage/SubTotalGrpPage">Specify the settings for up to three subtotal groups. Each tab has the same layout.</ahelp></paragraph> +</section> +<section id="howtoget"> + <embed href="text/scalc/00/00000412.xhp#dntezd"/> +</section> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/subtotalgrppage/group_by" id="bm_id3163713" localize="false"/> +<h2 id="hd_id3156441">Group by</h2> +<paragraph role="paragraph" id="par_id3154013" xml-lang="en-US"><ahelp hid="modules/scalc/ui/subtotalgrppage/group_by">Select the column that you want to control the subtotal calculation process. If the contents of the selected column change, the subtotals are automatically recalculated.</ahelp></paragraph> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/subtotalgrppage/columns" id="bm_id3149379" localize="false"/> +<h2 id="hd_id3154943">Calculate subtotals for</h2> +<paragraph role="paragraph" id="par_id3147125" xml-lang="en-US"><ahelp hid="modules/scalc/ui/subtotalgrppage/columns">Select the column(s) containing the values that you want to subtotal.</ahelp></paragraph> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/subtotalgrppage/functions" id="bm_id3149413" localize="false"/> +<h2 id="hd_id3156283">Use function</h2> +<paragraph role="paragraph" id="par_id3145647" xml-lang="en-US"><ahelp hid="modules/scalc/ui/subtotalgrppage/functions">Select the mathematical function that you want to use to calculate the subtotals.</ahelp></paragraph> +<section id="relatedtopics"> + <embed href="text/scalc/guide/subtotaltool.xhp#subtotaltoolh1"/> +</section> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/12050200.xhp b/helpcontent2/source/text/scalc/01/12050200.xhp new file mode 100644 index 000000000..5e0713a21 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/12050200.xhp @@ -0,0 +1,58 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . + --> +<helpdocument version="1.0"> +<meta> +<topic id="textscalc0112050200xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Options</title> +<filename>/text/scalc/01/12050200.xhp</filename> +</topic> +</meta> +<body> +<section id="options"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3154758"><bookmark_value>subtotals; sorting options</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/subtotaloptionspage/SubTotalOptionsPage" id="bm_id3150543" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/subtotaloptionspage/@@nowidget@@" id="bm_id3150543" localize="false"/> +<h1 id="hd_id3154758"><link href="text/scalc/01/12050200.xhp" name="Options">Options</link></h1> +<paragraph role="paragraph" id="par_id3154124" xml-lang="en-US"><ahelp hid=".">Specify the settings for calculating and presenting subtotals.</ahelp></paragraph> +</section> +<section id="howtoget"> + <embed href="text/scalc/00/00000412.xhp#dntopi"/> +</section> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/subtotaloptionspage/pagebreak" id="bm_id3155131" localize="false"/><h2 id="hd_id3156422">Page break between groups</h2> +<paragraph role="paragraph" id="par_id3147317" xml-lang="en-US"><ahelp hid="modules/scalc/ui/subtotaloptionspage/pagebreak">Inserts a new page after each group of subtotaled data.</ahelp></paragraph> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/subtotaloptionspage/case" id="bm_id3151115" localize="false"/><h2 id="hd_id3146985">Case sensitive</h2> +<paragraph role="paragraph" id="par_id3153190" xml-lang="en-US"><ahelp hid="modules/scalc/ui/subtotaloptionspage/case">Recalculates subtotals when you change the case of a data label.</ahelp></paragraph> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/subtotaloptionspage/sort" id="bm_id3152596" localize="false"/><h2 id="hd_id3151119">Pre-sort area according to groups</h2> +<paragraph role="paragraph" id="par_id3149664" xml-lang="en-US"><ahelp hid="modules/scalc/ui/subtotaloptionspage/sort">Sorts the area that you selected in the <emph>Group by</emph> box of the Group tabs according to the columns that you selected.</ahelp></paragraph> +<h2 id="hd_id3153951">Sort</h2> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/subtotaloptionspage/formats" id="bm_id3147397" localize="false"/><h3 id="hd_id3145252">Include formats</h3> +<paragraph role="paragraph" id="par_id3147125" xml-lang="en-US"><ahelp hid="modules/scalc/ui/subtotaloptionspage/formats">Considers formatting attributes when sorting.</ahelp></paragraph> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/subtotaloptionspage/btnuserdef" id="bm_id3154729" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/subtotaloptionspage/lbuserdef" id="bm_id3153877" localize="false"/><h3 id="hd_id3155418">Custom sort order</h3> +<paragraph role="paragraph" id="par_id3149400" xml-lang="en-US"><ahelp hid=".">Uses a custom sorting order that you defined in the Options dialog box at <emph>%PRODUCTNAME Calc - Sort Lists</emph>.</ahelp></paragraph> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/subtotaloptionspage/ascending" id="bm_id3150327" localize="false"/><h3 id="hd_id3149121">Ascending</h3> +<paragraph role="paragraph" id="par_id3155068" xml-lang="en-US"><ahelp hid="modules/scalc/ui/subtotaloptionspage/ascending">Sorts beginning with the lowest value. You can define the sort rules on Data - Sort - Options.</ahelp> You define the default on <switchinline select="sys"><caseinline select="MAC"><menuitem>%PRODUCTNAME - Preferences</menuitem></caseinline><defaultinline><menuitem>Tools - Options</menuitem></defaultinline></switchinline><menuitem> - Language settings - Languages</menuitem>.</paragraph> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/subtotaloptionspage/descending" id="bm_id3150324" localize="false"/><h3 id="hd_id3155443">Descending</h3> +<paragraph role="paragraph" id="par_id3153766" xml-lang="en-US"><ahelp hid="modules/scalc/ui/subtotaloptionspage/descending">Sorts beginning with the highest value. You can define the sort rules on Data - Sort - Options.</ahelp> You define the default on <switchinline select="sys"><caseinline select="MAC"><menuitem>%PRODUCTNAME - Preferences</menuitem></caseinline><defaultinline><menuitem>Tools - Options</menuitem></defaultinline></switchinline><menuitem> - Language settings - Languages</menuitem>.</paragraph> +<section id="relatedtopics"> + <embed href="text/scalc/guide/subtotaltool.xhp#subtotaltoolh1"/> +</section> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/12060000.xhp b/helpcontent2/source/text/scalc/01/12060000.xhp new file mode 100644 index 000000000..ff0a53980 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/12060000.xhp @@ -0,0 +1,56 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> + +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . + --> + + +<meta> +<topic id="textscalc0112060000xml" indexer="include"> +<title id="tit" xml-lang="en-US">Multiple Operations</title> +<filename>/text/scalc/01/12060000.xhp</filename> +</topic> +</meta> +<body> +<bookmark xml-lang="en-US" branch="hid/.uno:TableOperationDialog" id="bm_id9116957" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/multipleoperationsdialog/MultipleOperationsDialog" id="bm_id3151210" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/multipleoperationsdialog/@@nowidget@@" id="bm_id3151210" localize="false"/> +<section id="multopheader"> +<h1 id="hd_id3153381"><link href="text/scalc/01/12060000.xhp" name="multiple operations">Multiple Operations</link></h1> +<paragraph role="paragraph" id="par_id3154140" xml-lang="en-US"><variable id="mehrfachoperationen"><ahelp hid=".uno:TableOperationDialog">Applies the same formula to different cells, but with different parameter values.</ahelp></variable></paragraph> +</section> + +<section id="howtoget"> +<embed href="text/scalc/00/00000412.xhp#dnmfo"/> +</section> +<embed href="text/scalc/guide/multioperation.xhp#multioperation"/> +<note id="par_id3152598">The <emph>Row</emph> or <emph>Column</emph> box must contain a reference to the first cell of the selected range.</note> +<note id="par_id3154011">If you export a spreadsheet containing multiple operations to Microsoft Excel, the location of the cells containing the formula must be fully defined relative to the data range.</note> +<h2 id="hd_id3156441">Defaults</h2> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/multipleoperationsdialog/formulas" id="bm_id3149581" localize="false"/> +<h3 id="hd_id3154492">Formulas</h3> +<paragraph role="paragraph" id="par_id3151073" xml-lang="en-US"><ahelp hid="modules/scalc/ui/multipleoperationsdialog/formulas">Enter the cell references for the cells containing the formulas that you want to use in the multiple operation.</ahelp></paragraph> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/multipleoperationsdialog/row" id="bm_id3156286" localize="false"/> +<h3 id="hd_id3154729">Row</h3> +<paragraph role="paragraph" id="par_id3148456" xml-lang="en-US"><ahelp hid="modules/scalc/ui/multipleoperationsdialog/row">Enter the input cell reference that you want to use as a variable for the rows in the data table.</ahelp></paragraph> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/multipleoperationsdialog/col" id="bm_id3149123" localize="false"/> +<h3 id="hd_id3150718">Column</h3> +<paragraph role="paragraph" id="par_id3150327" xml-lang="en-US"><ahelp hid="modules/scalc/ui/multipleoperationsdialog/col">Enter the input cell reference that you want to use as a variable for the columns in the data table.</ahelp></paragraph> +<embed href="text/shared/00/00000001.xhp#shrink_maximize"/> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/12070000.xhp b/helpcontent2/source/text/scalc/01/12070000.xhp new file mode 100644 index 000000000..cdf63f2d4 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/12070000.xhp @@ -0,0 +1,65 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> + +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . + --> + + +<meta> +<topic id="textscalc0112070000xml" indexer="include"> +<title id="tit" xml-lang="en-US">Consolidate</title> +<filename>/text/scalc/01/12070000.xhp</filename> +</topic> +</meta> +<body> +<bookmark xml-lang="en-US" branch="hid/.uno:DataConsolidate" id="bm_id4927741" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/consolidatedialog/ConsolidateDialog" id="bm_id3148664" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/consolidatedialog/@@nowidget@@" id="bm_id3148664" localize="false"/> + +<section id="consolidateheader"> +<h1 id="hd_id3148946"><link href="text/scalc/01/12070000.xhp" name="Consolidate">Consolidate</link></h1> +<paragraph role="paragraph" id="par_id3148798" xml-lang="en-US"><variable id="konsolidieren"><ahelp hid=".uno:DataConsolidate">Combines data from one or more independent cell ranges and calculates a new range using the function that you specify.</ahelp></variable></paragraph> +</section> + +<section id="howtoget"> +<embed href="text/scalc/00/00000412.xhp#dnksd"/> +</section> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/consolidatedialog/func" id="bm_id3149958" localize="false"/> +<h2 id="hd_id3150010">Function</h2> +<paragraph role="paragraph" id="par_id3149377" xml-lang="en-US"><ahelp hid="modules/scalc/ui/consolidatedialog/func">Select the function that you want to use to consolidate the data.</ahelp></paragraph> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/consolidatedialog/consareas" id="bm_id3144764" localize="false"/> +<h2 id="hd_id3147127">Consolidation ranges</h2> +<paragraph role="paragraph" id="par_id3151075" xml-lang="en-US"><ahelp hid="modules/scalc/ui/consolidatedialog/consareas">Displays the cell ranges that you want to consolidate.</ahelp></paragraph> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/consolidatedialog/lbdataarea" id="bm_id3149400" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/consolidatedialog/eddataarea" id="bm_id3154018" localize="false"/> +<h2 id="hd_id3147397">Source data range</h2> +<paragraph role="paragraph" id="par_id3153836" xml-lang="en-US"><ahelp hid="modules/scalc/ui/consolidatedialog/eddataarea">Specifies the cell range that you want to consolidate with the cell ranges listed in the <emph>Consolidation ranges </emph>box. Select a cell range in a sheet, and then click <emph>Add</emph>. You can also select the name of a predefined cell from the <emph>Source data range </emph>list.</ahelp></paragraph> +<embed href="text/shared/00/00000001.xhp#shrink_maximize"/> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/consolidatedialog/lbdestarea" id="bm_id3156383" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/consolidatedialog/eddestarea" id="bm_id3156382" localize="false"/> +<h2 id="hd_id3155768">Copy results to</h2> +<paragraph role="paragraph" id="par_id3147341" xml-lang="en-US"><ahelp hid="modules/scalc/ui/consolidatedialog/eddestarea">Displays the first cell in the range where the consolidation results will be displayed.</ahelp></paragraph> +<embed href="text/shared/00/00000001.xhp#delete2"/> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/consolidatedialog/add" id="bm_id3145228" localize="false"/> +<h2 id="hd_id3147345">Add</h2> +<paragraph role="paragraph" id="par_id3155335" xml-lang="en-US"><ahelp hid="modules/scalc/ui/consolidatedialog/add">Adds the cell range specified in the <emph>Source data range</emph> box to the <emph>Consolidation ranges </emph>box.</ahelp></paragraph> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/consolidatedialog/more" id="bm_id3159102" localize="false"/> +<h2 id="hd_id3148630">Options</h2> +<paragraph role="paragraph" id="par_id3159239" xml-lang="en-US"><ahelp hid="modules/scalc/ui/consolidatedialog/more">Shows additional <link href="text/scalc/01/12070100.xhp" name="options">options</link>.</ahelp></paragraph> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/12070100.xhp b/helpcontent2/source/text/scalc/01/12070100.xhp new file mode 100644 index 000000000..ef860a214 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/12070100.xhp @@ -0,0 +1,49 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . + --> + +<helpdocument version="1.0"> +<meta> +<topic id="textscalc0112070100xml" indexer="include" status="PUBLISH"> +<title xml-lang="en-US" id="tit">Consolidate by</title> +<filename>/text/scalc/01/12070100.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +</history> +</meta> +<body> + + + <paragraph role="heading" level="1" id="hd_id3151210" xml-lang="en-US">Consolidate by</paragraph> + <paragraph role="heading" level="2" id="hd_id3125864" xml-lang="en-US">Consolidate by</paragraph> + <paragraph role="paragraph" id="par_id3154909" xml-lang="en-US">Use this section if the cell ranges that you want to consolidate contain labels. You only need to select these options if the consolidation ranges contain similar labels and the data arranged is arranged differently.</paragraph> + <bookmark branch="hid/modules/scalc/ui/consolidatedialog/byrow" xml-lang="en-US" id="bm_id3154684" localize="false"/><paragraph role="heading" level="3" id="hd_id3153968" xml-lang="en-US">Row labels</paragraph> + <paragraph role="paragraph" id="par_id3150441" xml-lang="en-US"><ahelp hid="modules/scalc/ui/consolidatedialog/byrow" visibility="visible">Uses the row labels to arrange the consolidated data.</ahelp></paragraph> + <bookmark branch="hid/modules/scalc/ui/consolidatedialog/bycol" xml-lang="en-US" id="bm_id3149260" localize="false"/><paragraph role="heading" level="3" id="hd_id3146976" xml-lang="en-US">Column labels</paragraph> + <paragraph role="paragraph" id="par_id3155411" xml-lang="en-US"><ahelp hid="modules/scalc/ui/consolidatedialog/bycol" visibility="visible">Uses the column labels to arrange the consolidated data.</ahelp></paragraph> + <paragraph role="heading" level="2" id="hd_id3153191" xml-lang="en-US">Options</paragraph> + <bookmark branch="hid/modules/scalc/ui/consolidatedialog/refs" xml-lang="en-US" id="bm_id3153954" localize="false"/><paragraph role="heading" level="3" id="hd_id3159154" xml-lang="en-US">Link to source data</paragraph> + <paragraph role="paragraph" id="par_id3146986" xml-lang="en-US"><ahelp hid="modules/scalc/ui/consolidatedialog/refs" visibility="visible">Links the data in the consolidation range to the source data, and automatically updates the results of the consolidation when the source data is changed.</ahelp></paragraph> + <paragraph role="heading" level="2" id="hd_id3163708" xml-lang="en-US">Options</paragraph> + <paragraph role="paragraph" id="par_id3151118" xml-lang="en-US">Hides the additional options.</paragraph> + + </body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/12080000.xhp b/helpcontent2/source/text/scalc/01/12080000.xhp new file mode 100644 index 000000000..0497321b2 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/12080000.xhp @@ -0,0 +1,55 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . + --> + +<helpdocument version="1.0"> +<meta> +<topic id="textscalc0112080000xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Group and Outline</title> +<filename>/text/scalc/01/12080000.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +</history> +</meta> +<body> +<section id="group_and_outline"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3152350"><bookmark_value>sheets; outlines</bookmark_value> +<bookmark_value>outlines; sheets</bookmark_value> +<bookmark_value>hiding; sheet details</bookmark_value> +<bookmark_value>showing; sheet details</bookmark_value> +<bookmark_value>grouping;cells</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3152350" xml-lang="en-US" level="1"><link href="text/scalc/01/12080000.xhp" name="Group and Outline">Group and Outline</link></paragraph> +<paragraph role="paragraph" id="par_id3150793" xml-lang="en-US">You can create an outline of your data and group rows and columns together so that you can collapse and expand the groups with a single click.</paragraph> +</section> +<section id="howtoget"> + <embed href="text/scalc/00/00000412.xhp#dngld"/> +</section> +<embed href="text/scalc/01/12080100.xhp#hide_details"/> +<embed href="text/scalc/01/12080200.xhp#show_details"/> +<paragraph role="heading" id="hd_id3147229" xml-lang="en-US" level="2"><link href="text/scalc/01/12080300.xhp" name="Group">Group</link></paragraph> +<embed href="text/scalc/01/12080300.xhp#gruppierung"/> +<paragraph role="heading" id="hd_id3153188" xml-lang="en-US" level="2"><link href="text/scalc/01/12080400.xhp" name="Ungroup">Ungroup</link></paragraph> +<embed href="text/scalc/01/12080400.xhp#gruppierungauf"/> +<embed href="text/scalc/01/12080500.xhp#auto_outline"/> +<embed href="text/scalc/01/12080600.xhp#remove"/> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/12080100.xhp b/helpcontent2/source/text/scalc/01/12080100.xhp new file mode 100644 index 000000000..875d6109b --- /dev/null +++ b/helpcontent2/source/text/scalc/01/12080100.xhp @@ -0,0 +1,46 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . + --> + +<helpdocument version="1.0"> +<meta> +<topic id="textscalc0112080100xml" indexer="include" status="PUBLISH"> +<title xml-lang="en-US" id="tit">Hide Details</title> +<filename>/text/scalc/01/12080100.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +</history> +</meta> +<body> + + + <section id="hide_details"> + <bookmark xml-lang="en-US" branch="index" id="bm_id3155628"><bookmark_value>sheets; hiding details</bookmark_value></bookmark> +<bookmark branch="hid/.uno:HideDetail" xml-lang="en-US" id="bm_id3149784" localize="false"/> +<paragraph id="hd_id3155628" role="heading" level="1" xml-lang="en-US"><link href="text/scalc/01/12080100.xhp" name="Hide Details">Hide Details</link></paragraph> + <paragraph role="paragraph" id="par_id3154515" xml-lang="en-US"><ahelp hid=".uno:HideDetail" visibility="visible">Hides the details of the grouped row or column that contains the cursor. To hide all of the grouped rows or columns, select the outlined table, and then choose this command.</ahelp></paragraph> + </section> + <paragraph xml-lang="en-US" role="paragraph" id="par_id3153252">To show all hidden groups, select the outlined table, and then choose <emph>Data - Group and Outline –</emph> <link href="text/scalc/01/12080200.xhp" name="Show Details"><emph>Show Details</emph></link>.</paragraph> + <section id="howtoget"> + <embed href="text/scalc/00/00000412.xhp#dngda"/> +</section> + </body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/12080200.xhp b/helpcontent2/source/text/scalc/01/12080200.xhp new file mode 100644 index 000000000..6ff0529cf --- /dev/null +++ b/helpcontent2/source/text/scalc/01/12080200.xhp @@ -0,0 +1,47 @@ +<?xml version="1.0" encoding="UTF-8"?> + + + +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . + --> + + + <helpdocument version="1.0"> +<meta> +<topic id="textscalc0112080200xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Show Details</title> +<filename>/text/scalc/01/12080200.xhp</filename> +</topic> +</meta> +<body> +<section id="show_details"> +<bookmark xml-lang="en-US" branch="index" id="bm_id3153561"><bookmark_value>tables; showing details</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/.uno:ShowDetail" id="bm_id3178188" localize="false"/> +<paragraph role="heading" id="hd_id3153561" xml-lang="en-US" level="1"><link href="text/scalc/01/12080200.xhp" name="Show Details">Show Details</link></paragraph> +<paragraph role="paragraph" id="par_id3153822" xml-lang="en-US"><ahelp hid=".uno:ShowDetail">Shows the details of the grouped row or column that contains the cursor. To show the details of all of the grouped rows or columns, select the outlined table, and then choose this command.</ahelp></paragraph> +</section> +<paragraph role="paragraph" id="par_id3155922" xml-lang="en-US">To hide a selected group, choose <emph>Data - Group and Outline – </emph><link href="text/scalc/01/12080100.xhp" name="Hide Details"><emph>Hide Details</emph></link>.</paragraph> +<section id="howtoget"> +<embed href="text/scalc/00/00000412.xhp#dngde"/> +</section> +<section id="relatedtopics"> +<paragraph role="paragraph" id="par_id6036561" xml-lang="en-US"><link href="text/scalc/01/12080700.xhp">Show Details command in pivot tables</link></paragraph> +</section> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/12080300.xhp b/helpcontent2/source/text/scalc/01/12080300.xhp new file mode 100644 index 000000000..cf4872faa --- /dev/null +++ b/helpcontent2/source/text/scalc/01/12080300.xhp @@ -0,0 +1,54 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . + --> + +<helpdocument version="1.0"> +<meta> +<topic id="textscalc0112080300xml" indexer="include" status="PUBLISH"> +<title xml-lang="en-US" id="tit">Group</title> +<filename>/text/scalc/01/12080300.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +</history> +</meta> +<body> + + + <section id="group"> + <bookmark branch="hid/modules/scalc/ui/groupdialog/GroupDialog" xml-lang="en-US" id="bm_id3156329" localize="false"/> + <bookmark branch="hid/modules/scalc/ui/groupdialog/@@nowidget@@" xml-lang="en-US" id="bm_id3156329" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/.uno:Group" id="bm_id9177845" localize="false"/> +<paragraph id="hd_id3153088" role="heading" level="1" xml-lang="en-US"><link href="text/scalc/01/12080300.xhp" name="Group">Group</link></paragraph> + </section> + <paragraph role="paragraph" id="par_id3153821" xml-lang="en-US"><variable id="gruppierung"><ahelp hid=".">Defines the selected cell range as a group of rows or columns.</ahelp></variable></paragraph> + <section id="howtoget"> + <embed href="text/scalc/00/00000412.xhp#data_outline_group"/> +</section> + <paragraph xml-lang="en-US" role="paragraph" id="par_id3145069">When you group a cell range, and outline icon appears in the margins next to the group. To hide or show the group, click the icon. To ungroup the selection, choose <emph>Data – Group and Outline -</emph> <link href="text/scalc/01/12080400.xhp" name="Ungroup"><emph>Ungroup</emph></link>.</paragraph> + <paragraph role="heading" level="2" id="hd_id3125863" xml-lang="en-US">Include</paragraph> + <bookmark branch="hid/modules/scalc/ui/groupdialog/rows" xml-lang="en-US" id="bm_id3150770" localize="false"/><paragraph role="heading" level="3" id="hd_id3150448" xml-lang="en-US">Rows</paragraph> + <paragraph role="paragraph" id="par_id3153194" xml-lang="en-US"><ahelp hid="modules/scalc/ui/groupdialog/rows">Groups the selected rows.</ahelp></paragraph> + <bookmark branch="hid/modules/scalc/ui/groupdialog/cols" xml-lang="en-US" id="bm_id3153771" localize="false"/><paragraph role="heading" level="3" id="hd_id3145786" xml-lang="en-US">Columns</paragraph> + <paragraph role="paragraph" id="par_id3146984" xml-lang="en-US"><ahelp hid="modules/scalc/ui/groupdialog/cols">Groups the selected columns.</ahelp></paragraph> + <note id="par_id171608652491036">Grouping and ungrouping is not tracked. Group is greyed out when track changes is on.</note> + + </body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/12080400.xhp b/helpcontent2/source/text/scalc/01/12080400.xhp new file mode 100644 index 000000000..f34436406 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/12080400.xhp @@ -0,0 +1,49 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . + --> + +<helpdocument version="1.0"> +<meta> +<topic id="textscalc0112080400xml" indexer="include" status="PUBLISH"> +<title xml-lang="en-US" id="tit">Ungroup</title> +<filename>/text/scalc/01/12080400.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +</history> +</meta> +<body> + + + <section id="ungroup"> +<bookmark branch="hid/.uno:Ungroup" xml-lang="en-US" id="bm_id3153561" localize="false"/> +<paragraph id="hd_id3148492" role="heading" level="1" xml-lang="en-US"><link href="text/scalc/01/12080400.xhp" name="Ungroup">Ungroup</link></paragraph> + </section> + <paragraph role="paragraph" id="par_id3151384" xml-lang="en-US"><variable id="gruppierungauf"><ahelp hid=".uno:Ungroup" visibility="visible">Ungroups the selection. In a nested group, the last rows or columns that were added are removed from the group.</ahelp></variable></paragraph> + <section id="howtoget"> + <embed href="text/scalc/00/00000412.xhp#data_outline_ungroup"/> +</section> + <paragraph role="heading" level="2" id="hd_id3151210" xml-lang="en-US">Deactivate for</paragraph> + <paragraph role="heading" level="3" id="hd_id3156280" xml-lang="en-US">Rows</paragraph> + <paragraph role="paragraph" id="par_id3125864" xml-lang="en-US">Removes selected rows from a group.</paragraph> + <paragraph role="heading" level="3" id="hd_id3147230" xml-lang="en-US">Columns</paragraph> + <paragraph role="paragraph" id="par_id3154685" xml-lang="en-US">Removes selected columns from a group.</paragraph> + </body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/12080500.xhp b/helpcontent2/source/text/scalc/01/12080500.xhp new file mode 100644 index 000000000..35e0b4e1d --- /dev/null +++ b/helpcontent2/source/text/scalc/01/12080500.xhp @@ -0,0 +1,93 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . + --> +<helpdocument version="1.0"> +<meta> +<topic id="textscalc0112080500xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">AutoOutline</title> +<filename>/text/scalc/01/12080500.xhp</filename> +</topic> +</meta> +<body> +<section id="auto_outline"> +<bookmark xml-lang="en-US" branch="hid/.uno:AutoOutline" id="bm_id1815805" localize="false"/> +<h1 id="hd_id3150275"><link href="text/scalc/01/12080500.xhp" name="AutoOutline">AutoOutline</link></h1> +<paragraph role="paragraph" id="par_id3145069" xml-lang="en-US"><ahelp hid=".uno:AutoOutline">If the selected cell range contains formulas or references, $[officename] automatically outlines the selection.</ahelp></paragraph> +</section> +<section id="howtoget"> +<paragraph role="paragraph" id="par_id3150791" xml-lang="en-US" localize="false"><embedvar href="text/scalc/00/00000412.xhp#dnglagl"/></paragraph> +</section> +<paragraph role="paragraph" id="par_id3148798" xml-lang="en-US">For example, consider the following table:</paragraph> +<table id="tbl_id3125865"> +<tablerow> +<tablecell> +<paragraph role="tablehead" id="par_id3154123" xml-lang="en-US">January</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablehead" id="par_id3154011" xml-lang="en-US">February</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablehead" id="par_id3152460" xml-lang="en-US">March</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablehead" id="par_id3146119" xml-lang="en-US">1st Quarter</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablehead" id="par_id3155854" xml-lang="en-US">April</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablehead" id="par_id3148575" xml-lang="en-US">May</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablehead" id="par_id3145271" xml-lang="en-US">June</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablehead" id="par_id3145648" xml-lang="en-US">2nd Quarter</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph role="paragraph" id="par_id3153876" xml-lang="en-US" localize="false">100</paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3145251" xml-lang="en-US" localize="false">120</paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3149400" xml-lang="en-US" localize="false">130</paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3150328" xml-lang="en-US" localize="false">350</paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3155443" xml-lang="en-US" localize="false">100</paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3153713" xml-lang="en-US" localize="false">100</paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3156385" xml-lang="en-US" localize="false">200</paragraph> +</tablecell> +<tablecell> +<paragraph role="paragraph" id="par_id3145230" xml-lang="en-US" localize="false">400</paragraph> +</tablecell> +</tablerow> +</table> +<paragraph role="paragraph" id="par_id3147363" xml-lang="en-US">The cells for the 1st and 2nd quarters each contain a sum formula for the three cells to their left. If you apply the <emph>AutoOutline</emph> command, the table is grouped into two quarters.</paragraph> +<paragraph role="paragraph" id="par_id3146918" xml-lang="en-US">To remove the outline, select the table, and then choose <link href="text/scalc/01/12080600.xhp" name="Data - Group and Outline - Remove">Data - Group and Outline - Remove</link>.</paragraph> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/12080600.xhp b/helpcontent2/source/text/scalc/01/12080600.xhp new file mode 100644 index 000000000..56cb208fb --- /dev/null +++ b/helpcontent2/source/text/scalc/01/12080600.xhp @@ -0,0 +1,44 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . + --> + +<helpdocument version="1.0"> +<meta> +<topic id="textscalc0112080600xml" indexer="include" status="PUBLISH"> +<title xml-lang="en-US" id="tit">Remove</title> +<filename>/text/scalc/01/12080600.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +</history> +</meta> +<body> + + + <section id="remove"> +<bookmark branch="hid/.uno:ClearOutline" xml-lang="en-US" id="bm_id3150400" localize="false"/> +<paragraph id="hd_id3148947" role="heading" level="1" xml-lang="en-US"><link href="text/scalc/01/12080600.xhp" name="Remove">Remove</link></paragraph> + <paragraph role="paragraph" id="par_id3149656" xml-lang="en-US"><ahelp hid=".uno:ClearOutline" visibility="visible">Removes the outline from the selected cell range.</ahelp></paragraph> + </section> + <section id="howtoget"> + <embed href="text/scalc/00/00000412.xhp#dnglef"/> +</section> + </body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/12080700.xhp b/helpcontent2/source/text/scalc/01/12080700.xhp new file mode 100644 index 000000000..b3ccd7df7 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/12080700.xhp @@ -0,0 +1,40 @@ +<?xml version="1.0" encoding="UTF-8"?> + + + +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . + --> + + + <helpdocument version="1.0"> +<meta> +<topic id="textscalc0112080700xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Show Details (Pivot Table)</title> +<filename>/text/scalc/01/12080700.xhp</filename> +</topic> +</meta> +<body> +<section id="details"> +<paragraph role="heading" id="hd_id3344523" xml-lang="en-US" level="1"><link href="text/scalc/01/12080700.xhp">Show Details (Pivot Table)</link></paragraph> +<paragraph role="paragraph" id="par_id871303" xml-lang="en-US"><ahelp hid=".">Inserts a new "drill-down" sheet with more information about the current pivot table cell. You can also double-click a pivot table cell to insert the "drill-down" sheet. The new sheet shows a subset of rows from the original data source that constitutes the result data displayed in the current cell.</ahelp></paragraph> +</section> +<section id="howtoget"> + <embed href="text/scalc/00/00000412.xhp#dngdrill"/> +</section><paragraph role="note" id="par_id7132480" xml-lang="en-US">Hidden items are not evaluated, the rows for the hidden items are included. Show Details is available only for pivot tables that are based on cell ranges or database data.</paragraph> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/12090000.xhp b/helpcontent2/source/text/scalc/01/12090000.xhp new file mode 100644 index 000000000..c8d6b564d --- /dev/null +++ b/helpcontent2/source/text/scalc/01/12090000.xhp @@ -0,0 +1,41 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . + --> +<helpdocument version="1.0"> +<meta> +<topic id="textscalc0112090000xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Pivot Table</title> +<filename>/text/scalc/01/12090000.xhp</filename> +</topic> +</meta> +<body> +<section id="pivot_table"> +<h1 id="hd_id3150275"><link href="text/scalc/01/12090000.xhp" name="Pivot Table">Pivot Table</link></h1> +<paragraph role="paragraph" id="par_id3153562" xml-lang="en-US">A pivot table provides a summary of large amounts of data. You can then rearrange the pivot table to view different summaries of the data.</paragraph> +</section> +<section id="howtoget"> + <embed href="text/scalc/00/00000412.xhp#dndtpt"/> +</section> +<embed href="text/scalc/guide/datapilot.xhp#datapilot"/> +<h2 id="hd_id3155923"><link href="text/scalc/01/12090100.xhp" name="Create">Create</link></h2> +<embed href="text/scalc/01/12090100.xhp#pivot_table"/> +<embed href="text/scalc/01/12090200.xhp#refresh"/> +<embed href="text/scalc/01/12090300.xhp#delete"/> +<paragraph role="paragraph" id="par_idN105FB" xml-lang="en-US"><link href="text/scalc/01/12090102.xhp" name="Pivot table dialog">Pivot table dialog</link></paragraph> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/12090100.xhp b/helpcontent2/source/text/scalc/01/12090100.xhp new file mode 100644 index 000000000..7a9d61c48 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/12090100.xhp @@ -0,0 +1,53 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . + --> +<helpdocument version="1.0"> +<meta> +<topic id="textscalc0112090100xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Select Source</title> +<filename>/text/scalc/01/12090100.xhp</filename> +</topic> +</meta> +<body> +<bookmark xml-lang="en-US" branch="hid/.uno:DataDataPilotRun" id="bm_id3153822" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/selectsource/SelectSourceDialog" id="bm_id3153823" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/selectsource/@@nowidget@@" id="bm_id3153823" localize="false"/> +<section id="pivot_table_h1"> +<h1 id="hd_id3153663"><link href="text/scalc/01/12090100.xhp" name="Pivot Table - Select Source">Pivot Table - Select Source</link></h1> +<section id="pivot_table"> +<paragraph role="paragraph" id="par_id3145119" xml-lang="en-US"><ahelp hid=".uno:DataDataPilotRun">Opens a dialog where you can select the source for your pivot table, and then create your table.</ahelp></paragraph> +</section> +</section> +<section id="howtoget"> + <embed href="text/scalc/00/00000412.xhp#dndpa"/> +</section> +<h2 id="hd_id3154760">Selection</h2> +<paragraph role="paragraph" id="par_id3150543" xml-lang="en-US">Select a data source for the pivot table.</paragraph> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/selectsource/selection" id="bm_id3154908" localize="false"/> +<h3 id="hd_id3148799">Current Selection</h3> +<paragraph role="paragraph" id="par_id3125865" xml-lang="en-US"><ahelp hid=".">Uses the selected cells as the data source for the pivot table.</ahelp></paragraph> +<note id="par_id3150011">The data columns in the pivot table use the same number format as the first data row in the current selection.</note> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/selectsource/database" id="bm_id3149664" localize="false"/> +<h3 id="hd_id3147348">Data source registered in $[officename]</h3> +<paragraph role="paragraph" id="par_id3145271" xml-lang="en-US"><ahelp hid=".">Uses a table or query in a database that is registered in $[officename] as the data source for the pivot table.</ahelp></paragraph> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/selectsource/external" id="bm_id3153876" localize="false"/> +<h3 id="hd_id3146119">External source/interface</h3> +<paragraph role="paragraph" id="par_id3145647" xml-lang="en-US"><ahelp hid=".">Opens the <emph>External Source</emph> dialog where you can select the OLAP data source for the pivot table.</ahelp></paragraph> +<paragraph role="paragraph" id="par_idN10670" xml-lang="en-US"><link href="text/scalc/01/12090102.xhp" name="Pivot table dialog">Pivot table dialog</link></paragraph> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/12090101.xhp b/helpcontent2/source/text/scalc/01/12090101.xhp new file mode 100644 index 000000000..734309ac4 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/12090101.xhp @@ -0,0 +1,57 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . + --> + + + +<helpdocument version="1.0"> +<meta> +<topic id="textscalc0112090101xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Select Data Source</title> +<filename>/text/scalc/01/12090101.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +</history> +</meta> +<body> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/selectdatasource/SelectDataSourceDialog" id="bm_id3154685" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/selectdatasource/@@nowidget@@" id="bm_id3154685" localize="false"/> +<paragraph role="heading" id="hd_id3143268" xml-lang="en-US" level="1">Select Data Source</paragraph> +<paragraph role="paragraph" id="par_id3148552" xml-lang="en-US">Select the database and the table or query containing the data that you want to use.</paragraph> +<section id="howtoget"> + <embed href="text/scalc/00/00000412.xhp#dndq"/> +</section> +<paragraph role="heading" id="hd_id3154140" xml-lang="en-US" level="2">Selection</paragraph> +<paragraph role="paragraph" id="par_id3125863" xml-lang="en-US"><ahelp hid=".">You can only select databases that are registered in %PRODUCTNAME.</ahelp> To register a data source, choose <switchinline select="sys"><caseinline select="MAC"><emph>%PRODUCTNAME - Preferences</emph></caseinline><defaultinline><emph>Tools - Options</emph></defaultinline></switchinline><emph> - %PRODUCTNAME Base - Databases</emph>.</paragraph> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/selectdatasource/database" id="bm_id3154684" localize="false"/> +<paragraph role="heading" id="hd_id3151041" xml-lang="en-US" level="3">Database</paragraph> +<paragraph role="paragraph" id="par_id3156424" xml-lang="en-US"><ahelp hid="modules/scalc/ui/selectdatasource/database">Select the database that contains the data source that you want to use.</ahelp></paragraph> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/selectdatasource/datasource" id="bm_id3151112" localize="false"/> +<paragraph role="heading" id="hd_id3145364" xml-lang="en-US" level="3">Data source</paragraph> +<paragraph role="paragraph" id="par_id3149260" xml-lang="en-US"><ahelp hid="modules/scalc/ui/selectdatasource/datasource">Select the data source that you want to use.</ahelp></paragraph> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/selectdatasource/type" id="bm_id3153726" localize="false"/> +<paragraph role="heading" id="hd_id3147428" xml-lang="en-US" level="3">Type</paragraph> +<paragraph role="paragraph" id="par_id3150010" xml-lang="en-US"><ahelp hid="modules/scalc/ui/selectdatasource/type">Click the source type of for the selected data source.</ahelp> You can choose from four source types: "Table", "Query" and "SQL" or SQL (Native).</paragraph> +<section id="relatedtopics"> +<paragraph role="paragraph" id="par_id3147348" xml-lang="en-US"><link href="text/scalc/01/12090102.xhp" name="Pivot table dialog">Pivot table dialog</link></paragraph> +</section> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/12090102.xhp b/helpcontent2/source/text/scalc/01/12090102.xhp new file mode 100644 index 000000000..bbef6e234 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/12090102.xhp @@ -0,0 +1,107 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> + +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . + --> + + +<meta> + <topic id="textscalc0112090102xml" indexer="include"> + <title xml-lang="en-US" id="tit">Pivot Table</title> + <filename>/text/scalc/01/12090102.xhp</filename> + </topic> + </meta> + <body> +<bookmark xml-lang="en-US" branch="index" id="bm_id2306894"><bookmark_value>pivot table function;show details</bookmark_value> +<bookmark_value>pivot table function;drill down</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/.uno:DataPilotExec" id="bm_id3154514" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/pivottablelayoutdialog/PivotTableLayout" id="bm_id31545141" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/pivottablelayoutdialog/@@nowidget@@" id="bm_id31545141" localize="false"/> +<paragraph xml-lang="en-US" id="hd_id3149165" role="heading" level="1">Pivot Table</paragraph> + <paragraph xml-lang="en-US" id="par_id3155922" role="paragraph"><ahelp hid=".uno:DataPilotExec">Specify the layout of the table that is generated by the pivot table.</ahelp></paragraph> + <section id="howtoget"> + <embed href="text/scalc/00/00000412.xhp#insert_pivot_table"/> + </section> + <embed href="text/scalc/guide/datapilot.xhp#datapilot"/> + <paragraph xml-lang="en-US" id="par_id3148798" role="paragraph">The pivot table displays data fields as buttons which you can drag and drop to define the pivot table.</paragraph> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/pivottablelayoutdialog/listbox-fields" id="bm_id3335062" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/pivottablelayoutdialog/listbox-column" id="bm_id9569689" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/pivottablelayoutdialog/listbox-row" id="bm_id7529526" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/pivottablelayoutdialog/listbox-data" id="bm_id2920621" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/pivottablelayoutdialog/listbox-page" id="bm_id7411420" localize="false"/><comment>UFI: changed help id from 59001 to dply_page</comment> +<paragraph xml-lang="en-US" id="hd_id3154908" role="heading" level="2">Layout</paragraph> + <paragraph xml-lang="en-US" id="par_id3150768" role="paragraph"><ahelp hid="modules/scalc/ui/pivottablelayoutdialog/listbox-fields">To define the layout of a pivot table, drag and drop data field buttons onto the <emph>Filters, Row Fields, Column Fields</emph> and <emph>Data Fields</emph> areas.</ahelp> You can also use drag and drop to rearrange the data fields on a pivot table.</paragraph> + <paragraph xml-lang="en-US" id="par_id3147229" role="paragraph">$[officename] automatically adds a caption to buttons that are dragged into the <emph>Data Fields </emph>area. The caption contains the name of the data field as well as the formula that created the data.</paragraph> + <paragraph xml-lang="en-US" id="par_id3145749" role="paragraph">To change the function that is used by a data field, double-click a button in the <emph>Data Fields</emph> area to open the <link href="text/scalc/01/12090105.xhp" name="Data Field">Data Field</link> dialog. You can also double-click buttons in the <emph>Row Fields</emph> or <emph>Column Fields</emph> areas.</paragraph> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/pivottablelayoutdialog/more" id="bm_id4284798" localize="false"/> +<paragraph xml-lang="en-US" id="hd_id3154944" role="heading" level="2">More</paragraph> + <paragraph xml-lang="en-US" id="par_id3145647" role="paragraph"><ahelp hid="modules/scalc/ui/pivottablelayoutdialog/more">Displays or hides additional options for defining the pivot table.</ahelp></paragraph> + <paragraph xml-lang="en-US" id="hd_id3151073" role="heading" level="2">Result</paragraph> + <paragraph xml-lang="en-US" id="par_id3155417" role="paragraph">Specify the settings for displaying the results of the pivot table.</paragraph> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/pivottablelayoutdialog/source-edit" id="bm_id7418660" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/pivottablelayoutdialog/source-button" id="bm_id7418760" localize="false"/> +<paragraph xml-lang="en-US" id="hd_id0509200913025625" role="heading" level="3">Selection from</paragraph> + <paragraph xml-lang="en-US" id="par_id0509200913025615" role="paragraph"><ahelp hid=".">Select the area that contains the data for the current pivot table.</ahelp></paragraph> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/pivottablelayoutdialog/destination-edit" id="bm_id7419660" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/pivottablelayoutdialog/destination-list" id="bm_id2334665" localize="false"/> +<paragraph xml-lang="en-US" id="hd_id3155603" role="heading" level="2">Results to</paragraph> + <paragraph xml-lang="en-US" id="par_id3153838" role="paragraph"><ahelp hid="modules/scalc/ui/pivottablelayoutdialog/destination-edit">Select the area where you want to display the results of the pivot table.</ahelp></paragraph> + <embed href="text/shared/00/00000001.xhp#shrink_maximize"/> + <paragraph xml-lang="en-US" id="par_id3155961" role="warning">If the selected area contains data, the pivot table overwrites the data. To prevent the loss of existing data, let the pivot table automatically select the area to display the results.</paragraph> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/pivottablelayoutdialog/check-ignore-empty-rows" id="bm_id7835016" localize="false"/> +<paragraph xml-lang="en-US" id="hd_id3147364" role="heading" level="2">Ignore empty rows</paragraph> + <paragraph xml-lang="en-US" id="par_id3154022" role="paragraph"><ahelp hid="modules/scalc/ui/pivottablelayoutdialog/check-ignore-empty-rows">Ignores empty fields in the data source.</ahelp></paragraph> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/pivottablelayoutdialog/check-identify-categories" id="bm_id5103305" localize="false"/> +<paragraph xml-lang="en-US" id="hd_id3155114" role="heading" level="2">Identify categories</paragraph> + <paragraph xml-lang="en-US" id="par_id3145257" role="paragraph"><ahelp hid="modules/scalc/ui/pivottablelayoutdialog/check-identify-categories">Automatically assigns rows without labels to the category of the row above.</ahelp><comment>i93137</comment></paragraph> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/pivottablelayoutdialog/check-total-columns" id="bm_id2163457" localize="false"/> +<paragraph xml-lang="en-US" id="hd_id3149207" role="heading" level="2">Total columns</paragraph> + <paragraph xml-lang="en-US" id="par_id3166426" role="paragraph"><ahelp hid="modules/scalc/ui/pivottablelayoutdialog/check-total-columns">Calculates and displays the grand total of the column calculation.</ahelp></paragraph> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/pivottablelayoutdialog/check-total-rows" id="bm_id3748588" localize="false"/> +<paragraph xml-lang="en-US" id="hd_id3150364" role="heading" level="2">Total rows</paragraph> + <paragraph xml-lang="en-US" id="par_id3152583" role="paragraph"><ahelp hid="modules/scalc/ui/pivottablelayoutdialog/check-total-rows">Calculates and displays the grand total of the row calculation.</ahelp></paragraph> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/pivottablelayoutdialog/check-add-filter" id="bm_id6004516" localize="false"/> +<paragraph xml-lang="en-US" id="par_idN10897" role="heading" level="2">Add filter</paragraph> + <paragraph xml-lang="en-US" id="par_idN1089B" role="paragraph"><ahelp hid=".">Adds a Filter button to pivot tables that are based on spreadsheet data.</ahelp></paragraph> +<bookmark xml-lang="en-US" branch="hid/.uno:DataPilotFilter" id="bm_id6278267" localize="false"/> +<paragraph xml-lang="en-US" id="par_idN108B2" role="paragraph"><ahelp hid=".">Opens the Filter dialog.</ahelp></paragraph> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/pivottablelayoutdialog/check-drill-to-details" id="bm_id7366252" localize="false"/> +<paragraph xml-lang="en-US" id="par_idN108C9" role="heading" level="2">Enable drill to details</paragraph> + <paragraph xml-lang="en-US" id="par_idN108CD" role="paragraph"><ahelp hid=".">Select this check box and double-click an item label in the table to show or hide details for the item. Clear this check box and double-click a cell in the table to edit the contents of the cell.</ahelp></paragraph> + <paragraph xml-lang="en-US" id="par_idN108DC" role="heading" level="2">To examine details inside a pivot table</paragraph> + <paragraph xml-lang="en-US" id="par_idN108E0" role="paragraph">Do one of the following:</paragraph> + <list type="unordered"> + <listitem> + <paragraph xml-lang="en-US" id="par_idN108E6" role="paragraph">Select a range of cells and choose <emph>Data - Group and Outline - Show Details</emph>.</paragraph> + </listitem> + <listitem> + <paragraph xml-lang="en-US" id="par_idN108EE" role="paragraph">Double-click a field in the table.</paragraph> + </listitem> + </list> + <paragraph xml-lang="en-US" id="par_idN108F1" role="paragraph">If you double-click a field which has adjacent fields at the same level, the <emph>Show Detail</emph> dialog opens:</paragraph> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/showdetaildialog/ShowDetails" id="bm_id9630726" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/showdetaildialog/dimsTreeview" id="bm_id9630726" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/showdetaildialog/@@nowidget@@" id="bm_id9630726" localize="false"/> +<paragraph xml-lang="en-US" id="par_idN10900" role="heading" level="2">Show Detail</paragraph> + <paragraph xml-lang="en-US" id="par_idN10904" role="paragraph"><ahelp hid=".">Choose the field that you want to view the details for.</ahelp></paragraph> + <section id="relatedtopics"> + <paragraph xml-lang="en-US" id="par_id3149817" role="paragraph"><link href="text/scalc/04/01020000.xhp" name="Pivot table shortcut keys">Pivot table shortcut keys</link></paragraph> + </section> + </body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/12090103.xhp b/helpcontent2/source/text/scalc/01/12090103.xhp new file mode 100644 index 000000000..950e1a3a4 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/12090103.xhp @@ -0,0 +1,114 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . + --> + +<helpdocument version="1.0"> +<meta> +<topic id="textscalc0112090103xml" indexer="include" status="PUBLISH"> +<title xml-lang="en-US" id="tit">Filter</title> +<filename>/text/scalc/01/12090103.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +</history> +</meta> +<body> + + <bookmark branch="hid/modules/scalc/ui/pivotfilterdialog/PivotFilterDialog" xml-lang="en-US" id="bm_id3153143" localize="false"/> + <bookmark branch="hid/modules/scalc/ui/pivotfilterdialog/@@nowidget@@" xml-lang="en-US" id="bm_id3153143" localize="false"/> + <paragraph role="heading" level="1" id="hd_id3153970" xml-lang="en-US">Filter</paragraph> + <paragraph role="paragraph" id="par_id3150448" xml-lang="en-US">Set the filtering options for the data.</paragraph> + <paragraph role="heading" level="2" id="hd_id3151043" xml-lang="en-US">Filter Criteria</paragraph> + <paragraph role="paragraph" id="par_id3150440" xml-lang="en-US">You can define a default filter for the data by filtering, for example, field names, using a combination of logical expressions arguments.</paragraph> + <bookmark branch="hid/modules/scalc/ui/pivotfilterdialog/connect1" xml-lang="en-US" id="bm_id3153142" localize="false"/><bookmark branch="hid/modules/scalc/ui/pivotfilterdialog/connect2" xml-lang="en-US" id="bm_id3155412" localize="false"/><paragraph role="heading" level="3" id="hd_id3159153" xml-lang="en-US">Operator</paragraph> + <paragraph role="paragraph" id="par_id3153093" xml-lang="en-US"><ahelp hid=".">Select a logical operator for the filter.</ahelp></paragraph> + <bookmark branch="hid/modules/scalc/ui/pivotfilterdialog/field1" xml-lang="en-US" id="bm_id3147317" localize="false"/><bookmark branch="hid/modules/scalc/ui/pivotfilterdialog/field2" xml-lang="en-US" id="bm_id3148646" localize="false"/><bookmark branch="hid/modules/scalc/ui/pivotfilterdialog/field3" xml-lang="en-US" id="bm_id3149667" localize="false"/><paragraph role="heading" level="3" id="hd_id3152462" xml-lang="en-US">Field name</paragraph> + <paragraph role="paragraph" id="par_id3155306" xml-lang="en-US"><ahelp hid=".">Select the field that you want to use in the filter. If field names are not available, the column labels are listed.</ahelp></paragraph> + <bookmark branch="hid/modules/scalc/ui/pivotfilterdialog/cond1" xml-lang="en-US" id="bm_id3147348" localize="false"/><bookmark branch="hid/modules/scalc/ui/pivotfilterdialog/cond2" xml-lang="en-US" id="bm_id3155855" localize="false"/><bookmark branch="hid/modules/scalc/ui/pivotfilterdialog/cond3" xml-lang="en-US" id="bm_id3156444" localize="false"/><paragraph role="heading" level="3" id="hd_id3148575" xml-lang="en-US">Condition</paragraph> + <paragraph role="paragraph" id="par_id3147394" xml-lang="en-US"><ahelp hid=".">Select an operator to compare the <emph>Field name</emph> and <emph>Value</emph> entries.</ahelp></paragraph> + <paragraph role="paragraph" id="par_id3144764" xml-lang="en-US">The following operators are available:</paragraph> + <table id="tbl_id3149379"> + + + + <tablerow> + <tablecell> + <paragraph role="paragraph" id="par_id3153415" xml-lang="en-US"><emph>Conditions:</emph></paragraph> + </tablecell> + <tablecell> + + </tablecell> + </tablerow> + + <tablerow> + <tablecell> + <paragraph role="paragraph" id="par_id3150324" xml-lang="en-US">=</paragraph> + </tablecell> + <tablecell> + <paragraph role="paragraph" id="par_id3153714" xml-lang="en-US">equal</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph role="paragraph" id="par_id3154254" xml-lang="en-US"><</paragraph> + </tablecell> + <tablecell> + <paragraph role="paragraph" id="par_id3154703" xml-lang="en-US">less than</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph role="paragraph" id="par_id3155335" xml-lang="en-US">></paragraph> + </tablecell> + <tablecell> + <paragraph role="paragraph" id="par_id3147003" xml-lang="en-US">greater than</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph role="paragraph" id="par_id3153270" xml-lang="en-US"><=</paragraph> + </tablecell> + <tablecell> + <paragraph role="paragraph" id="par_id3145257" xml-lang="en-US">less than or equal to</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph role="paragraph" id="par_id3145134" xml-lang="en-US">>=</paragraph> + </tablecell> + <tablecell> + <paragraph role="paragraph" id="par_id3151214" xml-lang="en-US">greater than or equal to</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph role="paragraph" id="par_id3150345" xml-lang="en-US"><></paragraph> + </tablecell> + <tablecell> + <paragraph role="paragraph" id="par_id3159101" xml-lang="en-US">not equal to</paragraph> + </tablecell> + </tablerow> + </table> + <bookmark branch="hid/modules/scalc/ui/pivotfilterdialog/val1" xml-lang="en-US" id="bm_id3152990" localize="false"/><bookmark branch="hid/modules/scalc/ui/pivotfilterdialog/val2" xml-lang="en-US" id="bm_id3152994" localize="false"/><bookmark branch="hid/modules/scalc/ui/pivotfilterdialog/val3" xml-lang="en-US" id="bm_id3150370" localize="false"/><paragraph role="heading" level="3" id="hd_id3150886" xml-lang="en-US">Value</paragraph> + <paragraph role="paragraph" id="par_id3155506" xml-lang="en-US"><ahelp hid=".">Select the value that you want to compare to the selected field.</ahelp></paragraph> + <bookmark branch="hid/modules/scalc/ui/pivotfilterdialog/more" xml-lang="en-US" id="bm_id3152987" localize="false"/><paragraph id="hd_id3146980" role="heading" level="2" xml-lang="en-US"><link href="text/scalc/01/12090104.xhp" name="Options">Options</link></paragraph> + <embed href="text/scalc/01/12090104.xhp#zusaetzetext"/> + </body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/12090104.xhp b/helpcontent2/source/text/scalc/01/12090104.xhp new file mode 100644 index 000000000..d1cb4888d --- /dev/null +++ b/helpcontent2/source/text/scalc/01/12090104.xhp @@ -0,0 +1,52 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . + --> + +<helpdocument version="1.0"> +<meta> +<topic id="textscalc0112090104xml" indexer="include" status="PUBLISH"> +<title xml-lang="en-US" id="tit">Options</title> +<filename>/text/scalc/01/12090104.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +</history> +</meta> +<body> + + + + <paragraph id="hd_id3149119" role="heading" level="1" xml-lang="en-US"><link href="text/scalc/01/12090104.xhp" name="Options">Options</link></paragraph> + <paragraph role="paragraph" id="par_id3147102" xml-lang="en-US"><variable id="zusaetzetext"><ahelp hid="modules/scalc/ui/pivotfilterdialog/more" visibility="visible">Displays or hides additional filtering options.</ahelp></variable></paragraph> + <paragraph role="heading" level="2" id="hd_id3147008" xml-lang="en-US">Options</paragraph> + <bookmark branch="hid/modules/scalc/ui/pivotfilterdialog/case" xml-lang="en-US" id="bm_id3153562" localize="false"/><paragraph role="heading" level="3" id="hd_id3153662" xml-lang="en-US">Case sensitive</paragraph> + <paragraph role="paragraph" id="par_id3145673" xml-lang="en-US"><ahelp hid="." visibility="visible">Distinguishes between uppercase and lowercase letters.</ahelp></paragraph> + <bookmark branch="hid/modules/scalc/ui/pivotfilterdialog/regexp" xml-lang="en-US" id="bm_id3153881" localize="false"/><paragraph role="heading" level="3" id="hd_id3156327" xml-lang="en-US">Regular Expression</paragraph> + <paragraph role="paragraph" id="par_id3151245" xml-lang="en-US"><ahelp hid="." visibility="visible">Allows you to use regular expressions in the filter definition.</ahelp></paragraph> + <paragraph xml-lang="en-US" role="paragraph" id="par_id3147264">If the <emph>Regular Expression</emph> check box is selected, you can use EQUAL (=) and NOT EQUAL (<>) also in comparisons. You can also use the following functions: DCOUNTA, DGET, MATCH, COUNTIF, SUMIF, LOOKUP, VLOOKUP and HLOOKUP.</paragraph> + <bookmark branch="hid/modules/scalc/ui/pivotfilterdialog/unique" xml-lang="en-US" id="bm_id3150541" localize="false"/><paragraph role="heading" level="3" id="hd_id3153379" xml-lang="en-US">No duplications</paragraph> + <paragraph role="paragraph" id="par_id3154138" xml-lang="en-US"><ahelp hid="." visibility="visible">Excludes duplicate rows in the list of filtered data.</ahelp></paragraph> + <bookmark branch="hid/modules/scalc/ui/pivotfilterdialog/dbarea" xml-lang="en-US" id="bm_id3150541" localize="false"/><paragraph role="heading" level="2" id="hd_id3156282" xml-lang="en-US">Data range</paragraph> + <paragraph role="paragraph" id="par_id3150768" xml-lang="en-US"><ahelp hid="." visibility="visible">Displays the name of the filtered data range in the table.</ahelp></paragraph> + <section id="relatedtopics"> + <paragraph role="paragraph" id="par_id3154011" xml-lang="en-US"><link href="text/shared/01/02100001.xhp" name="List of Regular Expressions">List of Regular Expressions</link></paragraph> + </section> + </body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/12090105.xhp b/helpcontent2/source/text/scalc/01/12090105.xhp new file mode 100644 index 000000000..bdde49582 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/12090105.xhp @@ -0,0 +1,168 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . + --> + +<helpdocument version="1.0"> +<meta> +<topic id="textscalc0112090105xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Data field</title> +<filename>/text/scalc/01/12090105.xhp</filename> +</topic> +</meta> +<body> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/pivotfielddialog/PivotFieldDialog" id="bm_id3153194" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/pivotfielddialog/@@nowidget@@" id="bm_id3153194" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/datafielddialog/BaseFieldDialog" id="bm_id8070926" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/datafielddialog/@@nowidget@@" id="bm_id8070926" localize="false"/> +<bookmark xml-lang="en-US" branch="index" id="bm_id7292397"><bookmark_value>calculating;pivot table</bookmark_value> +</bookmark> +<paragraph role="heading" id="hd_id3150871" xml-lang="en-US" level="1">Data field</paragraph> +<paragraph role="paragraph" id="par_id3154124" xml-lang="en-US">The contents of this dialog is different for data fields in the <emph>Data</emph> area, and data fields in the <emph>Row</emph> or <emph>Column</emph> area of the <link href="text/scalc/01/12090102.xhp" name="Pivot table">Pivot Table</link> dialog.</paragraph> +<paragraph role="heading" id="hd_id3152596" xml-lang="en-US" level="2">Subtotals</paragraph> +<paragraph role="paragraph" id="par_id3151113" xml-lang="en-US"><ahelp hid="modules/scalc/ui/pivotfielddialog/PivotFieldDialog">Specify the subtotals that you want to calculate.</ahelp></paragraph> +<paragraph role="heading" id="hd_id3145366" xml-lang="en-US" level="3">None</paragraph> +<paragraph role="paragraph" id="par_id3152576" xml-lang="en-US"><ahelp hid="modules/scalc/ui/pivotfielddialog/none">Does not calculate subtotals.</ahelp></paragraph> +<paragraph role="heading" id="hd_id3154012" xml-lang="en-US" level="3">Automatic</paragraph> +<paragraph role="paragraph" id="par_id3155856" xml-lang="en-US"><ahelp hid="modules/scalc/ui/pivotfielddialog/auto">Automatically calculates subtotals.</ahelp></paragraph> +<paragraph role="heading" id="hd_id3155411" xml-lang="en-US" level="3">User-defined</paragraph> +<paragraph role="paragraph" id="par_id3149581" xml-lang="en-US"><ahelp hid="modules/scalc/ui/pivotfielddialog/user">Select this option, and then click the type of subtotal that you want to calculate in the list.</ahelp></paragraph> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/pivotfielddialog/functions" id="bm_id3145799" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/datafielddialog/functions" id="bm_id1523789" localize="false"/> +<paragraph role="heading" id="hd_id3147124" xml-lang="en-US" level="3">Function</paragraph> +<paragraph role="paragraph" id="par_id3154490" xml-lang="en-US"><ahelp hid=".">Click the type of subtotal that you want to calculate. This option is only available if the <emph>User-defined</emph> option is selected.</ahelp></paragraph> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/pivotfielddialog/showall" id="bm_id3154015" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/datafielddialog/checkbutton1" id="bm_id1523790" localize="false"/> +<paragraph role="heading" id="hd_id3154944" xml-lang="en-US" level="2">Show items without data</paragraph> +<paragraph role="paragraph" id="par_id3149403" xml-lang="en-US"><ahelp hid=".">Includes empty columns and rows in the results table.</ahelp></paragraph> +<paragraph role="heading" id="hd_id3149122" xml-lang="en-US" level="2">Name:</paragraph> +<paragraph role="paragraph" id="par_id3150749" xml-lang="en-US">Lists the name of the selected data field.</paragraph> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/datafielddialog/expander" id="bm_id4281746" localize="false"/> +<paragraph role="heading" id="par_idN106EC" xml-lang="en-US" level="2">More</paragraph> +<paragraph role="paragraph" id="par_idN106F0" xml-lang="en-US"><ahelp hid=".">Expands or reduces the dialog. The <emph>More</emph> button is visible for data fields only.</ahelp></paragraph> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/pivotfielddialog/options" id="bm_id2855922" localize="false"/> +<paragraph role="heading" id="par_idN106F3" xml-lang="en-US" level="2">Options</paragraph> +<paragraph role="paragraph" id="par_idN106F7" xml-lang="en-US"><ahelp hid=".">Opens the <link href="text/scalc/01/12090106.xhp">Data Field Options</link> dialog. The <emph>Options</emph> button is visible for filters and column or row fields only.</ahelp></paragraph> +<paragraph role="paragraph" id="par_idN10708" xml-lang="en-US">If the dialog is expanded by the <emph>More</emph> button, the following items are added to the dialog:</paragraph> +<paragraph role="heading" id="par_idN1070B" xml-lang="en-US" level="2">Displayed value</paragraph> +<paragraph role="paragraph" id="par_idN1070F" xml-lang="en-US"><ahelp hid=".">For each data field, you can select the type of display.</ahelp> For some types you can select additional information for a base field and a base item.</paragraph> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/datafielddialog/type" id="bm_id3325907" localize="false"/> +<paragraph role="heading" id="par_idN10712" xml-lang="en-US" level="3">Type</paragraph> +<paragraph role="paragraph" id="par_idN10716" xml-lang="en-US"><ahelp hid="modules/scalc/ui/datafielddialog/type">Select the type of calculating of the displayed value for the data field.</ahelp></paragraph> +<table id=""> +<tablerow> +<tablecell colspan="" rowspan=""> +<paragraph role="tablehead" id="par_idN10724" xml-lang="en-US">Type</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="tablehead" id="par_idN1072A" xml-lang="en-US">Displayed value</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell colspan="" rowspan=""> +<paragraph role="tablecontent" id="par_idN10731" xml-lang="en-US">Normal</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="tablecontent" id="par_idN10737" xml-lang="en-US">Results are shown unchanged</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell colspan="" rowspan=""> +<paragraph role="tablecontent" id="par_idN1073E" xml-lang="en-US">Difference from</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="tablecontent" id="par_idN10744" xml-lang="en-US">From each result, its reference value (see below) is subtracted, and the difference is shown. Totals outside of the base field are shown as empty results.</paragraph> +<paragraph role="tablecontent" id="par_idN10747" xml-lang="en-US"> +<emph>Named item</emph> +</paragraph> +<paragraph role="tablecontent" id="par_idN1074C" xml-lang="en-US">If a base item name is specified, the reference value for a combination of field items is the result where the item in the base field is replaced by the specified base item.</paragraph> +<paragraph role="tablecontent" id="par_idN1074F" xml-lang="en-US"> +<emph>Previous item or Next item</emph> +</paragraph> +<paragraph role="tablecontent" id="par_idN10754" xml-lang="en-US">If "previous item" or "next item" is specified as the base item, the reference value is the result for the next visible member of the base field, in the base field's sort order.</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell colspan="" rowspan=""> +<paragraph role="tablecontent" id="par_idN1075B" xml-lang="en-US">% Of</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="tablecontent" id="par_idN10761" xml-lang="en-US">Each result is divided by its reference value. The reference value is determined in the same way as for "Difference from". Totals outside of the base field are shown as empty results. </paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell colspan="" rowspan=""> +<paragraph role="tablecontent" id="par_idN1076A" xml-lang="en-US">% Difference from</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="tablecontent" id="par_idN10770" xml-lang="en-US">From each result, its reference value is subtracted, and the difference is divided by the reference value. The reference value is determined in the same way as for "Difference from". Totals outside of the base field are shown as empty results.</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell colspan="" rowspan=""> +<paragraph role="tablecontent" id="par_idN10777" xml-lang="en-US">Running total in</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="tablecontent" id="par_idN1077D" xml-lang="en-US">Each result is added to the sum of the results for preceding items in the base field, in the base field's sort order, and the total sum is shown.</paragraph> +<paragraph role="tablecontent" id="par_idN10780" xml-lang="en-US">Results are always summed, even if a different summary function was used to get each result.</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell colspan="" rowspan=""> +<paragraph role="tablecontent" id="par_idN10787" xml-lang="en-US">% of row</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="tablecontent" id="par_idN1078D" xml-lang="en-US">Each result is divided by the total result for its row in the pivot table. If there are several data fields, the total for the result's data field is used. If there are subtotals with manually selected summary functions, the total with the data field's summary function is still used. </paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell colspan="" rowspan=""> +<paragraph role="tablecontent" id="par_idN10794" xml-lang="en-US">% of column</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="tablecontent" id="par_idN1079A" xml-lang="en-US">Same as "% of row", but the total for the result's column is used.</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell colspan="" rowspan=""> +<paragraph role="tablecontent" id="par_idN107A1" xml-lang="en-US">% of total</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="tablecontent" id="par_idN107A7" xml-lang="en-US">Same as "% of row", but the grand total for the result's data field is used.</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell colspan="" rowspan=""> +<paragraph role="tablecontent" id="par_idN107AE" xml-lang="en-US">Index</paragraph> +</tablecell> +<tablecell colspan="" rowspan=""> +<paragraph role="tablecontent" id="par_idN107B4" xml-lang="en-US">The row and column totals and the grand total, following the same rules as above, are used to calculate the following expression:</paragraph> +<paragraph role="tablecontent" id="par_idN107B7" xml-lang="en-US">( original result * grand total ) / ( row total * column total )</paragraph> +</tablecell> +</tablerow> +</table> + +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/datafielddialog/basefield" id="bm_id7005523" localize="false"/> +<paragraph role="heading" id="par_idN107BA" xml-lang="en-US" level="3">Base field</paragraph> +<paragraph role="paragraph" id="par_idN107BE" xml-lang="en-US"><ahelp hid="modules/scalc/ui/datafielddialog/basefield">Select the field from which the respective value is taken as base for the calculation.</ahelp></paragraph> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/datafielddialog/baseitem" id="bm_id8070925" localize="false"/> +<paragraph role="heading" id="par_idN107C1" xml-lang="en-US" level="3">Base item</paragraph> +<paragraph role="paragraph" id="par_idN107C5" xml-lang="en-US"><ahelp hid="modules/scalc/ui/datafielddialog/baseitem">Select the item of the base field from which the respective value is taken as base for the calculation.</ahelp></paragraph> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/12090106.xhp b/helpcontent2/source/text/scalc/01/12090106.xhp new file mode 100644 index 000000000..2cde7124c --- /dev/null +++ b/helpcontent2/source/text/scalc/01/12090106.xhp @@ -0,0 +1,70 @@ +<?xml version="1.0" encoding="UTF-8"?> + + + +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . + --> + + + <helpdocument version="1.0"> +<meta> +<topic id="textscalc0112090106xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Data Field Options</title> +<filename>/text/scalc/01/12090106.xhp</filename> +</topic> +</meta> +<body> +<bookmark xml-lang="en-US" branch="index" id="bm_id711386"><bookmark_value>hiding;data fields, from calculations in pivot table</bookmark_value> +<bookmark_value>display options in pivot table</bookmark_value> +<bookmark_value>sorting;options in pivot table</bookmark_value> +<bookmark_value>data field options for pivot table</bookmark_value> +</bookmark><comment>mw changed "hiding..." entry</comment> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/datafieldoptionsdialog/@@nowidget@@" id="@@nowidget@@" localize="false"/> +<paragraph role="heading" id="par_idN10542" xml-lang="en-US" level="1">Data Field Options</paragraph> +<paragraph role="paragraph" id="par_idN10546" xml-lang="en-US">You can specify additional options for column, row, and page data fields in the <link href="text/scalc/01/12090105.xhp">pivot table</link>.</paragraph> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/datafieldoptionsdialog/sortby" id="bm_id6588335" localize="false"/><paragraph role="heading" id="par_idN10557" xml-lang="en-US" level="2">Sort by</paragraph> +<paragraph role="paragraph" id="par_idN1055B" xml-lang="en-US"><ahelp hid="modules/scalc/ui/datafieldoptionsdialog/sortby">Select the data field that you want to sort columns or rows by.</ahelp></paragraph> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/datafieldoptionsdialog/ascending" id="bm_id6422009" localize="false"/><paragraph role="heading" id="par_idN1055E" xml-lang="en-US" level="3">Ascending</paragraph> +<paragraph role="paragraph" id="par_idN10562" xml-lang="en-US"><ahelp hid="modules/scalc/ui/datafieldoptionsdialog/ascending">Sorts the values from the lowest value to the highest value. If the selected field is the field for which the dialog was opened, the items are sorted by name. If a data field was selected, the items are sorted by the resultant value of the selected data field.</ahelp></paragraph> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/datafieldoptionsdialog/descending" id="bm_id1683706" localize="false"/><paragraph role="heading" id="par_idN10565" xml-lang="en-US" level="3">Descending</paragraph> +<paragraph role="paragraph" id="par_idN10569" xml-lang="en-US"><ahelp hid="modules/scalc/ui/datafieldoptionsdialog/descending">Sorts the values descending from the highest value to the lowest value. If the selected field is the field for which the dialog was opened, the items are sorted by name. If a data field was selected, the items are sorted by the resultant value of the selected data field.</ahelp></paragraph> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/datafieldoptionsdialog/manual" id="bm_id9101840" localize="false"/><paragraph role="heading" id="par_idN1056C" xml-lang="en-US" level="3">Manual</paragraph> +<paragraph role="paragraph" id="par_idN10570" xml-lang="en-US"><ahelp hid="modules/scalc/ui/datafieldoptionsdialog/manual">Sorts values alphabetically.</ahelp><comment>UFI: see spec doc. Currently set to alphabetically.</comment></paragraph> +<paragraph role="heading" id="par_idN10585" xml-lang="en-US" level="2">Display options</paragraph> +<paragraph role="paragraph" id="par_idN10589" xml-lang="en-US">You can specify the display options for all row fields except for the last, innermost row field.</paragraph> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/datafieldoptionsdialog/layout" id="bm_id113223" localize="false"/><paragraph role="heading" id="par_idN1058C" xml-lang="en-US" level="3">Layout</paragraph> +<paragraph role="paragraph" id="par_idN10590" xml-lang="en-US"><ahelp hid="modules/scalc/ui/datafieldoptionsdialog/layout">Select the layout mode for the field in the list box.</ahelp></paragraph> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/datafieldoptionsdialog/emptyline" id="bm_id2646870" localize="false"/><paragraph role="heading" id="par_idN10593" xml-lang="en-US" level="3">Empty line after each item</paragraph> +<paragraph role="paragraph" id="par_idN10597" xml-lang="en-US"><ahelp hid="modules/scalc/ui/datafieldoptionsdialog/emptyline">Adds an empty row after the data for each item in the pivot table.</ahelp></paragraph> +<paragraph role="heading" id="par_idN1059A" xml-lang="en-US" level="2">Show automatically</paragraph> +<paragraph role="paragraph" id="par_idN1059E" xml-lang="en-US">Displays the top or bottom nn items when you sort by a specified field.</paragraph> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/datafieldoptionsdialog/show" id="bm_id4634540" localize="false"/><paragraph role="heading" id="par_idN105A1" xml-lang="en-US" level="3">Show</paragraph> +<paragraph role="paragraph" id="par_idN105A5" xml-lang="en-US"><ahelp hid="modules/scalc/ui/datafieldoptionsdialog/show">Turns on the automatic show feature.</ahelp></paragraph> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/datafieldoptionsdialog/items" id="bm_id6690878" localize="false"/><paragraph role="heading" id="par_idN105A8" xml-lang="en-US" level="4">items</paragraph> +<paragraph role="paragraph" id="par_idN105AC" xml-lang="en-US"><ahelp hid="modules/scalc/ui/datafieldoptionsdialog/items">Enter the maximum number of items that you want to show automatically.</ahelp></paragraph> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/datafieldoptionsdialog/from" id="bm_id9420148" localize="false"/><paragraph role="heading" id="par_idN105AF" xml-lang="en-US" level="4">From</paragraph> +<paragraph role="paragraph" id="par_idN105B3" xml-lang="en-US"><ahelp hid="modules/scalc/ui/datafieldoptionsdialog/from">Shows the top or bottom items in the specified sort order.</ahelp></paragraph> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/datafieldoptionsdialog/using" id="bm_id923184" localize="false"/><paragraph role="heading" id="par_idN105B6" xml-lang="en-US" level="4">Using field</paragraph> +<paragraph role="paragraph" id="par_idN105BA" xml-lang="en-US"><ahelp hid="modules/scalc/ui/datafieldoptionsdialog/using">Select the data field that you want to sort the data by.</ahelp></paragraph> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/datafieldoptionsdialog/hideitems" id="bm_id2068849" localize="false"/><paragraph role="heading" id="par_idN105BD" xml-lang="en-US" level="2">Hide items</paragraph> +<paragraph role="paragraph" id="par_idN105C1" xml-lang="en-US"><ahelp hid="modules/scalc/ui/datafieldoptionsdialog/hideitems">Select the items that you want to hide from the calculations.</ahelp></paragraph> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/datafieldoptionsdialog/hierarchy" id="bm_id6507461" localize="false"/><paragraph role="heading" id="par_idN105C4" xml-lang="en-US" level="3">Hierarchy</paragraph> +<paragraph role="paragraph" id="par_idN105C8" xml-lang="en-US"><ahelp hid="modules/scalc/ui/datafieldoptionsdialog/hierarchy">Select the hierarchy that you want to use. The pivot table must be based on an external source data that contains data hierarchies.</ahelp></paragraph> + <note id="par_id681598453957935">Calc does not provide multiple hierarchies for a single field and so this option is normally grayed. If you use a pivot table data source extension, that extension could define multiple hierarchies for some fields and then the option could become available. See the documentation supplied with that extension for more details.</note> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/12090200.xhp b/helpcontent2/source/text/scalc/01/12090200.xhp new file mode 100644 index 000000000..581dcdb4b --- /dev/null +++ b/helpcontent2/source/text/scalc/01/12090200.xhp @@ -0,0 +1,43 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . + --> + +<helpdocument version="1.0"> +<meta> +<topic id="textscalc0112090200xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Refresh</title> +<filename>/text/scalc/01/12090200.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +</history> +</meta> +<body> +<section id="refresh"> +<bookmark xml-lang="en-US" branch="hid/.uno:RecalcPivotTable" id="bm_id3145069" localize="false"/> +<paragraph role="heading" id="hd_id3151385" xml-lang="en-US" level="1"><link href="text/scalc/01/12090200.xhp" name="Refresh">Refresh</link></paragraph> +<paragraph role="paragraph" id="par_id3149456" xml-lang="en-US"><ahelp hid=".uno:RecalcPivotTable">Updates the pivot table.</ahelp></paragraph> +</section> +<paragraph role="paragraph" id="par_id3150400" xml-lang="en-US">After you import an Excel spreadsheet that contains a pivot table, click in the table, and then choose <emph>Data - Pivot Table - Refresh</emph>.</paragraph> +<section id="howtoget"> + <embed href="text/scalc/00/00000412.xhp#dndpak"/> +</section> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/12090300.xhp b/helpcontent2/source/text/scalc/01/12090300.xhp new file mode 100644 index 000000000..6b030209e --- /dev/null +++ b/helpcontent2/source/text/scalc/01/12090300.xhp @@ -0,0 +1,39 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . + --> + +<helpdocument version="1.0"> +<meta> +<topic id="textscalc0112090300xml" indexer="include" status="PUBLISH"> +<title xml-lang="en-US" id="tit">Delete</title> +<filename>/text/scalc/01/12090300.xhp</filename> +</topic> +</meta> +<body> +<section id="delete"> +<bookmark branch="hid/.uno:DeletePivotTable" xml-lang="en-US" id="bm_id3148491" localize="false"/> +<paragraph id="hd_id3150276" role="heading" level="1" xml-lang="en-US"><link href="text/scalc/01/12090300.xhp" name="Delete">Delete</link></paragraph> +<paragraph role="paragraph" id="par_id3159400" xml-lang="en-US"><ahelp hid=".uno:DeletePivotTable" visibility="visible">Deletes the selected pivot table.</ahelp></paragraph> +</section> +<section id="howtoget"> +<embed href="text/scalc/00/00000412.xhp#dndploe"/> +</section> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/12090400.xhp b/helpcontent2/source/text/scalc/01/12090400.xhp new file mode 100644 index 000000000..4a4cfc4d2 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/12090400.xhp @@ -0,0 +1,59 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . + --> + +<helpdocument version="1.0"> +<meta> +<topic id="textscalc0112090400xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Grouping</title> +<filename>/text/scalc/01/12090400.xhp</filename> +</topic> +</meta> +<body> +<paragraph role="heading" id="par_idN1054D" xml-lang="en-US" level="1">Grouping</paragraph> +<paragraph role="paragraph" id="par_idN10551" xml-lang="en-US">Grouping pivot tables displays the <emph>Grouping</emph> dialog for either values or dates.</paragraph> +<section id="howtoget"> + <embed href="text/scalc/00/00000412.xhp#grouping"/> +</section> +<paragraph role="heading" id="par_idN10568" xml-lang="en-US" level="2">Start</paragraph> +<paragraph role="paragraph" id="par_idN1056C" xml-lang="en-US">Specifies the start of the grouping.</paragraph> +<paragraph role="heading" id="par_idN1056F" xml-lang="en-US" level="3">Automatically</paragraph> +<paragraph role="paragraph" id="par_idN10573" xml-lang="en-US">Specifies whether to start grouping at the smallest value.</paragraph> +<paragraph role="heading" id="par_idN10576" xml-lang="en-US" level="3">Manually at</paragraph> +<paragraph role="paragraph" id="par_idN1057A" xml-lang="en-US">Specifies whether to enter the start value for grouping yourself.</paragraph> +<paragraph role="heading" id="par_idN1057D" xml-lang="en-US" level="2">End</paragraph> +<paragraph role="paragraph" id="par_idN10581" xml-lang="en-US">Specifies the end of the grouping.</paragraph> +<paragraph role="heading" id="par_idN10584" xml-lang="en-US" level="3">Automatically</paragraph> +<paragraph role="paragraph" id="par_idN10588" xml-lang="en-US">Specifies whether to end grouping at the largest value.</paragraph> +<paragraph role="heading" id="par_idN1058B" xml-lang="en-US" level="3">Manually at</paragraph> +<paragraph role="paragraph" id="par_idN1058F" xml-lang="en-US">Specifies whether to enter the end value for grouping yourself.</paragraph> +<paragraph role="heading" id="par_idN10592" xml-lang="en-US" level="2">Group by</paragraph> +<paragraph role="paragraph" id="par_idN10596" xml-lang="en-US">Specifies the value range by which every group's limits are calculated.</paragraph> +<paragraph role="heading" id="par_idN10599" xml-lang="en-US" level="3">Number of days</paragraph> +<paragraph role="paragraph" id="par_idN1059D" xml-lang="en-US">In the case of grouping date values, specifies the number of days to group by.</paragraph> +<paragraph role="heading" id="par_idN105A0" xml-lang="en-US" level="3">Intervals</paragraph> +<paragraph role="paragraph" id="par_idN105A4" xml-lang="en-US">In the case of grouping date values, specifies the intervals to group by.</paragraph> +<section id="relatedtopics"> +<paragraph role="paragraph" id="par_idN105B2" xml-lang="en-US" localize="false"> + <embedvar href="text/scalc/guide/datapilot_grouping.xhp#datapilot_grouping"/> +</paragraph> +</section> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/12100000.xhp b/helpcontent2/source/text/scalc/01/12100000.xhp new file mode 100644 index 000000000..d5bf15765 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/12100000.xhp @@ -0,0 +1,41 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . + --> +<helpdocument version="1.0"> +<meta> +<topic id="textscalc0112100000xml" indexer="include" status="PUBLISH"> +<title xml-lang="en-US" id="tit">Refresh Range</title> +<filename>/text/scalc/01/12100000.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +</history> +</meta> +<body> + <bookmark xml-lang="en-US" branch="index" id="bm_id3153662"><bookmark_value>database ranges; refreshing</bookmark_value></bookmark> +<bookmark branch="hid/.uno:DataReImport" xml-lang="en-US" id="bm_id3153880" localize="false"/> +<bookmark branch="hid/.uno:DataAreaRefresh" xml-lang="en-US" id="bm_id3149166" localize="false"/> +<section id="refreshrangehead"> +<h1 id="hd_id3153662"><link href="text/scalc/01/12100000.xhp" name="Refresh Range">Refresh Range</link></h1> + <paragraph role="paragraph" id="par_id3153088" xml-lang="en-US"><variable id="aktualisieren"><ahelp hid=".">Updates a data range that was inserted from an external database. The data in the sheet is updated to match the data in the external database.</ahelp></variable></paragraph> +</section> + <section id="howtoget"> + <embed href="text/scalc/00/00000412.xhp#dndakt"/> +</section> + </body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/12120000.xhp b/helpcontent2/source/text/scalc/01/12120000.xhp new file mode 100644 index 000000000..d2c131042 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/12120000.xhp @@ -0,0 +1,45 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . + --> +<helpdocument version="1.0"> +<meta> +<topic id="textscalc0112120000xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Validity</title> +<filename>/text/scalc/01/12120000.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +</history> +</meta> +<body> +<bookmark xml-lang="en-US" branch="hid/.uno:Validation" id="bm_id3153880" localize="false"/> +<section id="validityheader"> +<h1 id="hd_id3156347"><link href="text/scalc/01/12120000.xhp" name="validity">Validity</link></h1> +<paragraph role="paragraph" id="par_id3153252" xml-lang="en-US"><variable id="gueltigkeit"><ahelp hid=".uno:Validation">Defines what data is valid for a selected cell or cell range.</ahelp> +</variable></paragraph> +</section> +<section id="howtoget"> + <embed href="text/scalc/00/00000412.xhp#datengueltig"/> +</section> +<tip id="par_idN105D1">You can also insert a list box from the Controls toolbar and link the list box to a cell. This way you can specify the valid values on the <link href="text/shared/02/01170102.xhp">Data</link> page of the list box properties window.</tip> +<embed href="text/scalc/01/12120100.xhp#criteria"/> +<embed href="text/scalc/01/12120200.xhp#input_help"/> +<embed href="text/scalc/01/12120300.xhp#error_alert"/> +<embed href="text/shared/00/00000001.xhp#reset"/> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/12120100.xhp b/helpcontent2/source/text/scalc/01/12120100.xhp new file mode 100644 index 000000000..ada387093 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/12120100.xhp @@ -0,0 +1,157 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . + --> + +<meta> +<topic id="textscalc0112120100xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Criteria</title> +<filename>/text/scalc/01/12120100.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +</history> +</meta> +<body> +<section id="criteria"> +<bookmark xml-lang="en-US" branch="index" id="bm_id1464278"><bookmark_value>selection lists;validity</bookmark_value> +</bookmark><comment>UFI added index entry for new list feature. Guide needed. MW changed index entry</comment> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/validationcriteriapage/ValidationCriteriaPage" id="bm_id3145673" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/validationcriteriapage/@@nowidget@@" id="bm_id3145673" localize="false"/> +<h1 id="hd_id3153032" xml-lang="en-US"><link href="text/scalc/01/12120100.xhp" name="Criteria">Criteria</link></h1> +<paragraph role="paragraph" id="par_id3156327" xml-lang="en-US"><ahelp hid="modules/scalc/ui/validationcriteriapage/ValidationCriteriaPage">Specify the validation rules for the selected cell(s).</ahelp></paragraph> +</section> +<section id="howtoget"> + <embed href="text/scalc/00/00000412.xhp#datengueltigwerte"/> +</section> +<paragraph role="paragraph" id="par_id3155923" xml-lang="en-US">For example, you can define criteria such as: "Numbers between 1 and 10" or "Texts that are no more than 20 characters".</paragraph> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/validationcriteriapage/allow" id="bm_id3148663" localize="false"/> +<h2 id="hd_id3153896" xml-lang="en-US">Allow</h2> +<paragraph role="paragraph" id="par_id3150400" xml-lang="en-US"><ahelp hid="modules/scalc/ui/validationcriteriapage/allow">Click a validation option for the selected cell(s).</ahelp></paragraph> +<paragraph role="paragraph" id="par_id3148797" xml-lang="en-US">The following conditions are available:</paragraph> +<table id="tbl_id3150870"> +<tablerow> +<tablecell> +<paragraph role="tablehead" id="par_id3150447" xml-lang="en-US">Condition</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablehead" id="par_id3155854" xml-lang="en-US">Effect</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph role="tablecontent" id="par_id3153092" xml-lang="en-US">All values</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablecontent" id="par_id3155411" xml-lang="en-US">No limitation.</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph role="tablecontent" id="par_id3147434" xml-lang="en-US">Whole numbers</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablecontent" id="par_id3154319" xml-lang="en-US">Only whole numbers corresponding to the condition.</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph role="tablecontent" id="par_id3145802" xml-lang="en-US">Decimal</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablecontent" id="par_id3153160" xml-lang="en-US">All numbers corresponding to the condition.</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph role="tablecontent" id="par_id3149377" xml-lang="en-US">Date</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablecontent" id="par_id3150718" xml-lang="en-US">All numbers corresponding to the condition. The entered values are formatted accordingly the next time the dialog is called up.</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph role="tablecontent" id="par_id3146969" xml-lang="en-US">Time</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablecontent" id="par_id3155066" xml-lang="en-US">All numbers corresponding to the condition. The entered values are formatted accordingly the next time the dialog is called up.</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph role="tablecontent" id="par_idN106A0" xml-lang="en-US">Cell range</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablecontent" id="par_idN106A5" xml-lang="en-US">Allow only values that are given in a cell range. The cell range can be specified explicitly, or as a named database range, or as a named range. The range may consist of one column or one row of cells. If you specify a range of columns and rows, only the first column is used.</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph role="tablecontent" id="par_idN106AB" xml-lang="en-US">List</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablecontent" id="par_idN106B0" xml-lang="en-US">Allow only values or strings specified in a list. Strings and values can be mixed. Numbers evaluate to their value, so if you enter the number 1 in the list, the entry 100% is also valid.</paragraph> <paragraph role="note" id="par_id221603980244052">Only up to 255 characters are saved, when using Excel format.</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph role="tablecontent" id="par_id3154756" xml-lang="en-US">Text length</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablecontent" id="par_id3147339" xml-lang="en-US">Entries whose length corresponds to the condition.</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph id="par_id551607384650484" role="tablecontent">Custom</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id101607384677959" role="tablecontent">Only allow values that result in the formula entered in the <emph>Formula</emph> box to return <literal>TRUE</literal>, when the formula is calculated with the entered value. The formula can be any expression that evaluates to a boolean value of <literal>TRUE</literal> or <literal>FALSE</literal>, or returns a numerical value, where a nonzero value is interpreted as <literal>TRUE</literal> and <literal>0</literal> is interpreted as <literal>FALSE</literal>.</paragraph> +<paragraph role="tablecontent" id="par_id461607565255803">Formulas can use relative referencing. For example, if cells <literal>A1:A4</literal> were selected, the cursor is in cell <literal>A1</literal> and <input>ISODD(A1)</input> is entered into the <emph>Formula</emph> box, then only odd numbers could be entered into cells <literal>A1</literal> through <literal>A4</literal>.</paragraph> +</tablecell> +</tablerow> +</table> + +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/validationcriteriapage/allowempty" id="bm_id263985" localize="false"/> +<h2 id="hd_id3154704" xml-lang="en-US">Allow blank cells</h2> +<paragraph role="paragraph" id="par_id3153967" xml-lang="en-US"><ahelp hid="modules/scalc/ui/validationcriteriapage/allowempty">In conjunction with <emph>Tools - Detective - Mark invalid Data</emph>, this defines that blank cells are shown as invalid data (disabled) or not (enabled).</ahelp></paragraph> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/validationcriteriapage/showlist" id="bm_id5339518" localize="false"/> +<h2 id="par_idN10709" xml-lang="en-US">Show selection list</h2> +<paragraph role="paragraph" id="par_idN1070D" xml-lang="en-US"><ahelp hid="modules/scalc/ui/validationcriteriapage/showlist">Shows a list of all valid strings or values to select from. The list can also be opened by selecting the cell and pressing <switchinline select="sys"><caseinline select="MAC"><keycode>Command+D</keycode></caseinline><defaultinline><keycode>Ctrl+D</keycode></defaultinline></switchinline>.</ahelp></paragraph> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/validationcriteriapage/sortascend" id="bm_id6317331" localize="false"/> +<h3 id="par_idN10724" xml-lang="en-US">Sort entries ascending</h3> +<paragraph role="paragraph" id="par_idN10728" xml-lang="en-US"><ahelp hid="modules/scalc/ui/validationcriteriapage/sortascend">Sorts the selection list in ascending order and filters duplicates from the list. If not checked, the order from the data source is taken.</ahelp></paragraph> +<h2 id="par_idN1073F" xml-lang="en-US">Source</h2> +<paragraph role="paragraph" id="par_idN10743" xml-lang="en-US"><ahelp hid="modules/scalc/ui/validationcriteriapage/min">Enter the cell range that contains the valid values or text.</ahelp></paragraph> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/validationcriteriapage/minlist" id="bm_id5921506" localize="false"/> +<paragraph role="heading" id="par_idN1075A" xml-lang="en-US" level="2">Entries</paragraph> +<paragraph role="paragraph" id="par_idN1075E" xml-lang="en-US"><ahelp hid="modules/scalc/ui/validationcriteriapage/minlist">Enter the entries that will be valid values or text strings.</ahelp></paragraph> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/validationcriteriapage/data" id="bm_id3147344" localize="false"/> +<paragraph role="heading" id="hd_id3163807" xml-lang="en-US" level="2">Data</paragraph> +<paragraph role="paragraph" id="par_id3144502" xml-lang="en-US"><ahelp hid="modules/scalc/ui/validationcriteriapage/data">Select the comparative operator that you want to use.</ahelp> The available operators depend on what you selected in the <emph>Allow </emph>box. If you select "between" or "not between", the <emph>Minimum</emph> and <emph>Maximum</emph> input boxes appear. Otherwise, only the <emph>Minimum</emph>, the <emph>Maximum</emph>, or the <emph>Value</emph> input boxes appear.</paragraph> +<paragraph role="heading" id="hd_id3153782" xml-lang="en-US" level="2">Value</paragraph> +<paragraph role="paragraph" id="par_id3153266" xml-lang="en-US">Enter the value for the data validation option that you selected in the <emph>Allow </emph>box.</paragraph> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/validationcriteriapage/min" id="bm_id3149528" localize="false"/> +<h2 id="hd_id3149814" xml-lang="en-US">Minimum</h2> +<paragraph role="paragraph" id="par_id3153199" xml-lang="en-US"><ahelp hid="modules/scalc/ui/validationcriteriapage/min">Enter the minimum value for the data validation option that you selected in the <emph>Allow </emph>box.</ahelp></paragraph> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/validationcriteriapage/max" id="bm_id3150206" localize="false"/> +<paragraph role="heading" id="hd_id3149035" xml-lang="en-US" level="2">Maximum</paragraph> +<paragraph role="paragraph" id="par_id3150089" xml-lang="en-US"><ahelp hid="modules/scalc/ui/validationcriteriapage/max">Enter the maximum value for the data validation option that you selected in the <emph>Allow </emph>box.</ahelp></paragraph> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/12120200.xhp b/helpcontent2/source/text/scalc/01/12120200.xhp new file mode 100644 index 000000000..f78ac4ac0 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/12120200.xhp @@ -0,0 +1,54 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . + --> + +<helpdocument version="1.0"> +<meta> +<topic id="textscalc0112120200xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Input Help</title> +<filename>/text/scalc/01/12120200.xhp</filename> +</topic> +<history> +<created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> +</history> +</meta> +<body> +<section id="input_help"> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/validationhelptabpage/ValidationHelpTabPage" id="bm_id3150871" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/validationhelptabpage/@@nowidget@@" id="bm_id3150871" localize="false"/> +<paragraph role="heading" id="hd_id3156280" xml-lang="en-US" level="1"><link href="text/scalc/01/12120200.xhp" name="Input Help">Input Help</link></paragraph> +<paragraph role="paragraph" id="par_id3147229" xml-lang="en-US"><ahelp hid="modules/scalc/ui/validationhelptabpage/ValidationHelpTabPage">Enter the message that you want to display when the cell or cell range is selected in the sheet.</ahelp></paragraph> +</section> +<section id="howtoget"> + <embed href="text/scalc/00/00000412.xhp#datengueltigeingabe"/> +</section> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/validationhelptabpage/tsbhelp" id="bm_id3149260" localize="false"/> +<paragraph role="heading" id="hd_id3146986" xml-lang="en-US" level="2">Show input help when cell is selected</paragraph> +<paragraph role="paragraph" id="par_id3153363" xml-lang="en-US"><ahelp hid="modules/scalc/ui/validationhelptabpage/tsbhelp">Displays the message that you enter in the <emph>Contents</emph> box when the cell or cell range is selected in the sheet.</ahelp></paragraph> +<paragraph role="warning" id="par_id3154730" xml-lang="en-US">If you enter text in the <emph>Contents</emph> box of this dialog, and then select and clear this check box, the text will be lost.</paragraph> +<paragraph role="heading" id="hd_id3147394" xml-lang="en-US" level="2">Contents</paragraph> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/validationhelptabpage/title" id="bm_id3149377" localize="false"/> +<paragraph role="heading" id="hd_id3149582" xml-lang="en-US" level="3">Title</paragraph> +<paragraph role="paragraph" id="par_id3149400" xml-lang="en-US"><ahelp hid="modules/scalc/ui/validationhelptabpage/title">Enter the title that you want to display when the cell or cell range is selected.</ahelp></paragraph> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/validationhelptabpage/inputhelp" id="bm_id3156275" localize="false"/> +<paragraph role="heading" id="hd_id3149121" xml-lang="en-US" level="3">Input help</paragraph> +<paragraph role="paragraph" id="par_id3150752" xml-lang="en-US"><ahelp hid="modules/scalc/ui/validationhelptabpage/inputhelp">Enter the message that you want to display when the cell or cell range is selected.</ahelp></paragraph> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/12120300.xhp b/helpcontent2/source/text/scalc/01/12120300.xhp new file mode 100644 index 000000000..4b0079d65 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/12120300.xhp @@ -0,0 +1,83 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . + --> + +<helpdocument version="1.0"> +<meta> + <topic id="textscalc0112120300xml" indexer="include" status="PUBLISH"> + <title id="tit" xml-lang="en-US">Error Alert</title> + <filename>/text/scalc/01/12120300.xhp</filename> + </topic> + <history> + <created date="2003-10-31T00:00:00">Sun Microsystems, Inc.</created> + </history> +</meta> +<body> +<section id="error_alert"> + <bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/erroralerttabpage/ErrorAlertTabPage" id="bm_id3156024" localize="false"/> + <bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/erroralerttabpage/@@nowidget@@" id="bm_id3156024" localize="false"/> + <paragraph role="heading" id="hd_id3153821" xml-lang="en-US" level="1"><link href="text/scalc/01/12120300.xhp" name="Error Alert">Error Alert</link></paragraph> + <paragraph role="paragraph" id="par_id3153379" xml-lang="en-US"><ahelp hid="modules/scalc/ui/erroralerttabpage/ErrorAlertTabPage">Defines the error message that is displayed when invalid data is entered in a cell.</ahelp></paragraph> +</section> +<paragraph role="paragraph" id="par_id3154138" xml-lang="en-US">You can also start a macro with an error message. A sample macro is provided at the end of this page.</paragraph> +<section id="howtoget"> + <embed href="text/scalc/00/00000412.xhp#datengueltigfehler"/> +</section> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/erroralerttabpage/tsbshow" id="bm_id3154908" localize="false"/> +<paragraph role="heading" id="hd_id3156280" xml-lang="en-US" level="2">Show error message when invalid values are entered.</paragraph> +<paragraph role="paragraph" id="par_id3150768" xml-lang="en-US"><ahelp hid=".">Displays the error message that you enter in the <emph>Contents</emph> area when invalid data is entered in a cell.</ahelp> If enabled, the message is displayed to prevent an invalid entry.</paragraph> +<paragraph role="paragraph" id="par_id3146984" xml-lang="en-US">In both cases, if you select "Stop", the invalid entry is deleted and the previous value is reentered in the cell. The same applies if you close the "Warning" and "Information" dialogs by clicking the <emph>Cancel </emph>button. If you close the dialogs with the <emph>OK</emph> button, the invalid entry is not deleted.</paragraph> +<paragraph role="heading" id="hd_id3152460" xml-lang="en-US" level="2">Contents</paragraph> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/erroralerttabpage/actionCB" id="bm_id3154014" localize="false"/> +<paragraph role="heading" id="hd_id3148646" xml-lang="en-US" level="3">Action</paragraph> +<paragraph role="paragraph" id="par_id3151115" xml-lang="en-US"><ahelp hid="modules/scalc/ui/erroralerttabpage/actionCB">Select the action that you want to occur when invalid data is entered in a cell.</ahelp> The "Stop" action rejects the invalid entry and displays a dialog that you have to close by clicking <emph>OK</emph>. The "Warning" and "Information" actions display a dialog that can be closed by clicking <emph>OK</emph> or <emph>Cancel</emph>. The invalid entry is only rejected when you click <emph>Cancel</emph>.</paragraph> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/erroralerttabpage/browseBtn" id="bm_id3154729" localize="false"/> +<paragraph role="heading" id="hd_id3156441" xml-lang="en-US" level="3">Browse</paragraph> +<paragraph role="paragraph" id="par_id3153160" xml-lang="en-US"><ahelp hid="modules/scalc/ui/erroralerttabpage/browseBtn">Opens the <link href="text/shared/01/06130000.xhp" name="Macro">Macro</link> dialog where you can select the macro that is executed when invalid data is entered in a cell. The macro is executed after the error message is displayed.</ahelp></paragraph> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/erroralerttabpage/title" id="bm_id3149958" localize="false"/> +<paragraph role="heading" id="hd_id3153876" xml-lang="en-US" level="3">Title</paragraph> +<paragraph role="paragraph" id="par_id3149410" xml-lang="en-US"><ahelp hid="modules/scalc/ui/erroralerttabpage/title">Enter the title of the macro or the error message that you want to display when invalid data is entered in a cell.</ahelp></paragraph> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/erroralerttabpage/errorMsg" id="bm_id3153836" localize="false"/> +<paragraph role="heading" id="hd_id3154510" xml-lang="en-US" level="3">Error message</paragraph> +<paragraph role="paragraph" id="par_id3149122" xml-lang="en-US"><ahelp hid="modules/scalc/ui/erroralerttabpage/errorMsg">Enter the message that you want to display when invalid data is entered in a cell.</ahelp></paragraph> + <h3 id="hd_id881545240342781">Sample macro:</h3> + <paragraph role="paragraph" id="par_id521625929022780">Below is a sample function that can be called when an error occurs. Note that the macro takes in two parameters that are passed on by %PRODUCTNAME when the function is called:</paragraph> + <list type="unordered"> + <listitem> + <paragraph id="par_id981625929097216" role="listitem"><emph>CellValue</emph>: The value entered by the user, as a String.</paragraph> + </listitem> + <listitem> + <paragraph id="par_id421625929100152" role="listitem"><emph>CellAddress</emph>: The address of the cell where the value was entered, as a String prefixed with the sheet name (e.g: "Sheet1.A1").</paragraph> + </listitem> + </list> + <paragraph role="paragraph" id="par_id101625929384030">The function must return a Boolean value. If it returns <literal>True</literal>, the entered value is kept. If the function returns <literal>False</literal>, the entered value is erased and the previous value is restored.</paragraph> + <bascode> + <paragraph role="bascode" localize="false" id="par_id31545240174027">Function ExampleValidity(CellValue as String, CellAddress as String) as Boolean</paragraph> + <paragraph role="bascode" localize="false" id="par_id341545240202382"> Dim msg as String</paragraph> + <paragraph role="bascode" localize="false" id="par_id11545240206618"> Dim iAnswer as Integer</paragraph> + <paragraph role="bascode" localize="false" id="par_id841545240210171"> Dim MB_FLAGS as Integer</paragraph> + <paragraph role="bascode" id="par_id531545240216611"> msg = "Invalid value: " & "'" & CellValue & "'"</paragraph> + <paragraph role="bascode" id="bas_id971625928577365"> msg = msg & " in cell: " & "'" & CellAddress & "'"</paragraph> + <paragraph role="bascode" id="bas_id181625928577640"> msg = msg & Chr(10) & "Accept anyway?"</paragraph> + <paragraph role="bascode" localize="false" id="bas_id711625928577798"> MB_FLAGS = MB_YESNO + MB_ICONEXCLAMATION + MB_DEFBUTTON2</paragraph> + <paragraph role="bascode" id="bas_id941625928578118"> iAnswer = MsgBox (msg , MB_FLAGS, "Error message")</paragraph> + <paragraph role="bascode" localize="false" id="bas_id11625928661345"> ExampleValidity = (iAnswer = IDYES)</paragraph> + <paragraph role="bascode" localize="false" id="par_id971545240220293">End Function</paragraph> + </bascode> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/ODFF.xhp b/helpcontent2/source/text/scalc/01/ODFF.xhp new file mode 100644 index 000000000..1ef91d5fa --- /dev/null +++ b/helpcontent2/source/text/scalc/01/ODFF.xhp @@ -0,0 +1,25 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> +<!--*********************************************************** +* This file is part of the LibreOffice project. +* +* This Source Code Form is subject to the terms of the Mozilla Public +* License, v. 2.0. If a copy of the MPL was not distributed with this +* file, You can obtain one at http://mozilla.org/MPL/2.0/. +* +****************************************************************--> +<meta> +<topic id="topic_0506201512363995"> +<title xml-lang="en-US" id="tit">ODFF</title> +<filename>/text/scalc/01/ODFF.xhp</filename> +</topic> +</meta> +<body> +<section id="odff"> +<note id="hd_id1000010">This function is part of the Open Document Format for Office Applications (OpenDocument) standard Version 1.2. (ISO/IEC 26300:2-2015)</note> +</section> +<section id="odff13"> +<note id="hd_id1000013">This function is part of the Open Document Format for Office Applications (OpenDocument) standard Version 1.3.</note> +</section> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/calculate.xhp b/helpcontent2/source/text/scalc/01/calculate.xhp new file mode 100644 index 000000000..ab06f421b --- /dev/null +++ b/helpcontent2/source/text/scalc/01/calculate.xhp @@ -0,0 +1,32 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> + <!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + --> + + <meta> + <topic id="menudatacalculate" indexer="include" status="PUBLISH"> + <title id="tit" xml-lang="en-US">Calculate</title> + <filename>/text/scalc/01/calculate.xhp</filename> + </topic> + </meta> + <body> + <section id="calculateheader"> + <bookmark id="bm_id931584668179315" xml-lang="en-US" branch="hid/uno:CellContentsMenu" localize="false"/> + <h1 id="hd_id621584668179317"><link href="text/scalc/01/calculate.xhp" name="Calculate">Calculate</link></h1> + <paragraph id="par_id241584668179318" role="paragraph" xml-lang="en-US">Commands to calculate formula cells.</paragraph> + </section> + <section id="howtoget"> + <paragraph role="paragraph" id="par_id251645222672072">Choose <menuitem>Data - Calculate</menuitem></paragraph> + </section> + <embed href="text/scalc/01/06080000.xhp#recalculateheader"/> + <embed href="text/scalc/01/recalculate_hard.xhp#recalculate_hard_head"/> + <embed href="text/scalc/01/formula2value.xhp#formula2value"/> + <embed href="text/scalc/01/06070000.xhp#autocalculate"/> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/calculation_accuracy.xhp b/helpcontent2/source/text/scalc/01/calculation_accuracy.xhp new file mode 100644 index 000000000..297178db5 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/calculation_accuracy.xhp @@ -0,0 +1,108 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> + <!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + --> + + <meta> + <topic id="calculation_accuracy" indexer="include" status="PUBLISH"> + <title id="tit" xml-lang="en-US">Calculation Accuracy</title> + <filename>/text/scalc/01/calculation_accuracy.xhp</filename> + </topic> + </meta> + <body> + <bookmark xml-lang="en-US" branch="index" id="bm_id741642020503366"> + <bookmark_value>calculation;accuracy</bookmark_value> + <bookmark_value>precision;calculation</bookmark_value> + </bookmark> + <section id="accuracyHead"> + <h1 id="hd_id961642017927878"><link href="text/scalc/01/calculation_accuracy.xhp" name="accuracy">%PRODUCTNAME Calculation Accuracy</link></h1> + </section> + <h2 id="hd_id941642017968835">Inherent Accuracy Problem</h2> + <paragraph role="paragraph" id="par_id541642018071800">%PRODUCTNAME Calc, just like most other spreadsheet software, uses floating-point math capabilities available on hardware. Given that most contemporary hardware uses binary floating-point arithmetic with limited precision defined in <link href="https://en.wikipedia.org/wiki/IEEE_754" name="IEEE754">IEEE 754</link> standard, many decimal numbers - including as simple as 0.1 - cannot be precisely represented in %PRODUCTNAME Calc (which uses 64-bit double-precision numbers internally).</paragraph> + <paragraph role="paragraph" id="par_id191642019423811">Calculations with those numbers necessarily <link href="https://en.wikipedia.org/wiki/Floating-point_arithmetic#Accuracy_problems" name="wpediaaccuracy">results in rounding errors</link>, and those accumulate with every calculation. </paragraph> + + <paragraph role="paragraph" id="par_id221642019437175">This is not a bug, but is expected and currently unavoidable without using complex calculations in software, which would incur inappropriate performance penalties, and thus is out of question. Users need to account for that, and use rounding and comparisons with <link href="https://en.wikipedia.org/wiki/Machine_epsilon" name="macnie_epsilon">machine epsilon (or unit roundoff)</link> as necessary.</paragraph> + <paragraph role="paragraph" id="par_id801642019531438">An example with numbers:</paragraph> + <table id="tab_id261642018147815"> + <tablerow> + <tablecell> + </tablecell> + <tablecell> + <paragraph id="par_id201642018147816" role="tablehead" xml-lang="en-US" localize="false">A</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id801642018147817" role="tablehead" xml-lang="en-US" localize="false">1</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id91642018147817" role="tablecontent" xml-lang="en-US" localize="false">31000.99 </paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id851642018218927" role="tablehead" xml-lang="en-US" localize="false">2</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id831642018218928" role="tablecontent" xml-lang="en-US" localize="false">32000.12</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id221642018243152" role="tablehead" xml-lang="en-US" localize="false">3</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id261642018243152" role="tablecontent" xml-lang="en-US" localize="false">=A1-A2</paragraph> + </tablecell> + </tablerow> + </table> + <paragraph role="paragraph" id="par_id761642018318896">This will result in -999.129999999997 in A3, instead of expected -999.13 (you might need to increase shown decimal places in cell format to see this).</paragraph> +<paragraph role="paragraph" id="par_id221642020132399">An example with dates and times:</paragraph> + <paragraph role="paragraph" id="par_id801642018326882">Due to the specific of time representation in Calc, this also applies to all calculations involving times. For example, the cells A1 and A2 below show the date and time data as entered (in ISO 8601 format):</paragraph> + <table id="tab_id251642018348675"> + <tablerow> + <tablecell> + </tablecell> + <tablecell> + <paragraph id="par_id561642018348675" role="tablehead" xml-lang="en-US" localize="false">A</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id781642018348676" role="tablehead" xml-lang="en-US" localize="false">1</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id461642018348676" role="tablecontent" xml-lang="en-US" localize="false">2020-04-13 12:18:00</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id341642018408688" role="tablehead" xml-lang="en-US" localize="false">2</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id391642018408688" role="tablecontent" xml-lang="en-US" localize="false">2020-04-13 12:08:00 </paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id401642018497660" role="tablehead" xml-lang="en-US" localize="false">3</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id521642018497660" role="tablecontent" xml-lang="en-US" localize="false">=A1-A2</paragraph> + </tablecell> + </tablerow> + </table> + <paragraph role="paragraph" id="par_id101643312991679">Cell A3 will show 00:10:00 if the default formatting [HH]:MM:SS is applied to the cell. However, cell A3 will show 00:09:59.999999 instead of expected 00:10:00.000000 if formatted using [HH]:MM:SS.000000 format string. This happens despite only whole numbers of hours and minutes were used, because internally, any time is a fraction of a day, 12:00 (noon) being represented as 0.5. </paragraph> + <paragraph role="paragraph" id="par_id921642020011065">The data in A1 is represented internally as 43934.5125, and in A2 as 43934.5055555555591126903891563 (which is not exact representation of the entered datetime, which would be 43934.505555555555555555...). </paragraph> + <paragraph role="paragraph" id="par_id801642020017858">Their subtraction results in 0.00694444443287037, a value slightly less than expected 0.00694444444444..., which is 10 minutes.</paragraph> + <section id="relatedtopics"> + <embed href="text/scalc/01/func_rawsubtract.xhp#rawsubtracth1"/> + </section> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/cell_styles.xhp b/helpcontent2/source/text/scalc/01/cell_styles.xhp new file mode 100644 index 000000000..eb5780668 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/cell_styles.xhp @@ -0,0 +1,38 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * +--> + +<meta> + <topic id="calccellstyle" indexer="include" status="PUBLISH"> + <title id="tit" xml-lang="en-US">Cell Styles</title> + <filename>/text/scalc/01/cell_styles.xhp</filename> + </topic> +</meta> +<body> +<bookmark xml-lang="en-US" branch="hid/.uno:ParaStyle" id="bm_id5973914" localize="false"/> +<section id="cellstyleh1"> +<h1 id="hd_id811593560413206"><link href="text/scalc/01/cell_styles.xhp" name="Cell Style">Cell Styles</link></h1> +</section> + +<section id="howtoget"> + +</section> +<embed href="text/shared/01/05040100.xhp#organizer"/> +<embed href="text/shared/01/05020300.xhp#numbersh1"/> +<embed href="text/shared/01/05020100.xhp#characters"/> +<embed href="text/shared/01/05340300.xhp#alignment"/> +<embed href="text/shared/01/05020700.xhp#asitypo"/> +<embed href="text/shared/01/05030500.xhp#borders"/> +<embed href="text/shared/01/05210100.xhp#area"/> +<embed href="text/scalc/01/05020600.xhp#cell_protection"/> +<embed href="text/shared/00/00000001.xhp#reset"/> + +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/common_func.xhp b/helpcontent2/source/text/scalc/01/common_func.xhp new file mode 100644 index 000000000..3ec6b8e0b --- /dev/null +++ b/helpcontent2/source/text/scalc/01/common_func.xhp @@ -0,0 +1,40 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> + <!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + --> + <meta> + <topic id="commonfunctionsyntaxexample" indexer="include" status="PUBLISH"> + <title id="tit" xml-lang="en-US">Common Syntax and example</title> + <filename>/text/scalc/01/common_func.xhp</filename> + </topic> + </meta> + <body> + <section id="sectionsyntax"> + <h3 id="hd_id3152015">Syntax</h3> + </section> + <section id="sectionexample"> + <h3 id="hd_id281171">Example</h3> + </section> + <section id="sectionexamples"> + <h3 id="hd_id281996">Examples</h3> + </section> + <section id="sectiontechinfo"> + <h3 id="hd_id301640873452726">Technical information</h3> + </section> + <section id="sectionseealso"> + <h3 id="hd_id371655560095924">See also</h3> + </section> + <section id="notODFF"> + <paragraph role="paragraph" id="par_id251640873774457">This function is not part of the <emph>Open Document Format for Office Applications (OpenDocument) Version 1.3. Part 4: Recalculated Formula (OpenFormula) Format</emph> standard. The name space is</paragraph> + </section> + <section id="datenumbersequencenote"> + <note id="par_id301616845402409">This function ignores any text or empty cell within a data range. If you suspect wrong results from this function, look for text in the data ranges. To highlight text contents in a data range, use the <link href="text/scalc/01/03080000.xhp" name="value highlight">value highlighting</link> feature.</note> + </section> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/common_func_workdaysintl.xhp b/helpcontent2/source/text/scalc/01/common_func_workdaysintl.xhp new file mode 100644 index 000000000..cc515b8e7 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/common_func_workdaysintl.xhp @@ -0,0 +1,163 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . +--> + +<meta> + <topic id="textscalc01common_func_workdaysintlxml"> + <title id="tit" xml-lang="en-US">common workdays intl</title> + <filename>/text/scalc/01/common_func_workdaysintl.xhp</filename> + </topic> +</meta> + +<body> + + +<section id="embed_workdays_intl"> +<paragraph id="par_id231020162249541102" role="paragraph" xml-lang="en-US"><emph>Weekend</emph> is an optional parameter – a number or a string used to specify the days of the week that are weekend days and are not considered working days. Weekend is a weekend number or string that specifies when weekends occur. Weekend number values indicate the following weekend days:</paragraph> +<paragraph id="par_id231020162249545526" role="paragraph" xml-lang="en-US">Number 1 to 7 for two-day weekends and 11 to 17 for one-day weekends.</paragraph> + +<table id="Tabela1"> + <tablerow> + <tablecell> + <paragraph id="par_id231020162249542082" role="tablehead" xml-lang="en-US">Number</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id23102016224954936" role="tablehead" xml-lang="en-US">Weekend</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id231020162249548384" role="tablecontent" xml-lang="en-US">1 or omitted</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id231020162249544419" role="tablecontent" xml-lang="en-US">Saturday and Sunday</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id23102016224954966" role="tablecontent" localize="false" xml-lang="en-US">2</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id231020162249543229" role="tablecontent" xml-lang="en-US">Sunday and Monday</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id23102016224954344" role="tablecontent" localize="false" xml-lang="en-US">3</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id231020162249541638" role="tablecontent" xml-lang="en-US">Monday and Tuesday</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id231020162249542340" role="tablecontent" localize="false" xml-lang="en-US">4</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id231020162249548854" role="tablecontent" xml-lang="en-US">Tuesday and Wednesday</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id231020162249544635" role="tablecontent" localize="false" xml-lang="en-US">5</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id23102016224954803" role="tablecontent" xml-lang="en-US">Wednesday and Thursday</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id231020162249543818" role="tablecontent" localize="false" xml-lang="en-US">6</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id231020162249545913" role="tablecontent" xml-lang="en-US">Thursday and Friday</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id231020162249542217" role="tablecontent" localize="false" xml-lang="en-US">7</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id231020162249546426" role="tablecontent" xml-lang="en-US">Friday and Saturday</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id23102016224954147" role="tablecontent" localize="false" xml-lang="en-US">11</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id231020162249548630" role="tablecontent" xml-lang="en-US">Sunday only</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id231020162249546534" role="tablecontent" localize="false" xml-lang="en-US">12</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id231020162249547536" role="tablecontent" xml-lang="en-US">Monday only</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id231020162249542260" role="tablecontent" localize="false" xml-lang="en-US">13</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id231020162249545002" role="tablecontent" xml-lang="en-US">Tuesday only</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id231020162249556987" role="tablecontent" localize="false" xml-lang="en-US">14</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id231020162249554939" role="tablecontent" xml-lang="en-US">Wednesday only</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id231020162249556810" role="tablecontent" localize="false" xml-lang="en-US">15</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id231020162249558942" role="tablecontent" xml-lang="en-US">Thursday only</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id231020162249553074" role="tablecontent" localize="false" xml-lang="en-US">16</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id231020162249558763" role="tablecontent" xml-lang="en-US">Friday only</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id23102016224955626" role="tablecontent" localize="false" xml-lang="en-US">17</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id231020162249552635" role="tablecontent" xml-lang="en-US">Saturday only</paragraph> + </tablecell> + </tablerow> +</table> + +<paragraph id="par_id231020162249555313" role="paragraph" xml-lang="en-US">Weekend string provides another way to define the weekly non-working days. It must have seven (7) characters – zeros (0) for working day and ones (1) for non-working day. Each character represents a day of the week, starting with Monday. Only 1 and 0 are valid. “1111111” is an invalid string and should not be used. For example, the weekend string “0000011” defines Saturday and Sunday as non-working days.</paragraph> +<paragraph id="par_id231020162249559739" role="paragraph" xml-lang="en-US"><emph>Holidays</emph> is an optional list of dates that must be counted as non-working days. The list can be given in a cell range.</paragraph> +</section> +</body> + +</helpdocument>
\ No newline at end of file diff --git a/helpcontent2/source/text/scalc/01/data_form.xhp b/helpcontent2/source/text/scalc/01/data_form.xhp new file mode 100644 index 000000000..b65c81740 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/data_form.xhp @@ -0,0 +1,72 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> + <!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + --> + + <meta> + <topic id="textscalc01data_formxml"> + <title id="tit" xml-lang="en-US">Data Entry Form for Spreadsheet</title> + <filename>/text/scalc/01/data_form.xhp</filename> + </topic> + </meta> + + <body> + <bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/dataform/DataFormDialog" id="bm_id240920171033409926" localize="false"/> + <bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/dataform/@@nowidget@@" id="bm_id240920171033409926" localize="false"/> + <bookmark xml-lang="en-US" branch="index" id="bm_id240920171018528200"> + <bookmark_value>data entry forms;for spreadsheets</bookmark_value> + <bookmark_value>data entry forms;insert data in spreadsheets</bookmark_value> + <bookmark_value>insert data;data entry forms for spreadsheets</bookmark_value> + <bookmark_value>spreadsheet;form for inserting data</bookmark_value> + </bookmark> + <section id="data_form"> + <h1 id="hd_id240920171003006302"><link href="text/scalc/01/data_form.xhp">Form</link></h1> + <paragraph id="par_id240920171003293400" role="paragraph" xml-lang="en-US"><ahelp hid="."><emph>Data Entry Form</emph> is a tool to make table data entry easy in spreadsheets.</ahelp> With the Data Entry Form, you can enter, edit and delete records (or rows) of data and avoid horizontal scrolling when the table has many columns or when some columns are very wide.</paragraph> + </section> + + <section id="howtoget"> + <paragraph id="par_id240920171007389295" role="paragraph" xml-lang="en-US">Choose <item type="menuitem">Data – Form...</item></paragraph> + </section> + + <h2 id="hd_id291512503277077">Preparing the data entry form</h2> + <paragraph role="paragraph" id="par_id221512503284514" xml-lang="en-US">To be effective, the Calc data table should have a header row, where each cell contents is the label of the column. The header cells contents become the label of each data field in the form.</paragraph> + + <h2 id="hd_id531512503300666">Activating the form</h2> + <list type="ordered"> + <listitem> + <paragraph id="par_id551512503358101" role="listitem" xml-lang="en-US">Place the cursor in the header row of the table.</paragraph> + </listitem> + <listitem> + <paragraph id="par_id11512503369875" role="listitem" xml-lang="en-US">Choose <item type="menuitem">Data - Form...</item>.</paragraph> + </listitem> + </list> + <h2 id="hd_id361512503457039">Filling the form with data</h2> + <paragraph role="paragraph" id="par_id361512503457039" xml-lang="en-US">Enter the data in the text fields. Press Enter or click <item type="literal">New</item> to add it to the table.</paragraph> + <h2 id="hd_id111512507319306">Form dialog buttons</h2> + <paragraph role="paragraph" id="par_id981512503964001" xml-lang="en-US"><emph>New</emph>: fill the record (table row cells) with the form fields contents and jump to the next record or add a new record in the bottom of the table.</paragraph> + <paragraph role="paragraph" id="par_id91512503864256" xml-lang="en-US"><emph>Delete</emph>: deletes the current record.</paragraph> + <paragraph role="paragraph" id="par_id11512503887586" xml-lang="en-US"><emph>Restore</emph>: when a form field is edited, restore the record contents to its initial state.</paragraph> + <paragraph role="paragraph" id="par_id301512503881314" xml-lang="en-US"><emph>Previous record</emph>: move to the previous record (table row).</paragraph> + <paragraph role="paragraph" id="par_id51512503877397" xml-lang="en-US"><emph>Next record</emph>: move to the next record.</paragraph> + <paragraph role="paragraph" id="par_id971512503871672" xml-lang="en-US"><emph>Close</emph>: close the form.</paragraph> + <paragraph role="paragraph" id="par_id951512509971073" xml-lang="en-US"> + <image src="media/helpimg/sc_data_form01.png" id="img_id951512509971073"> + <alt xml-lang="en-US" id="alt_id951512509971073">The form dialog box and header row cells as field labels</alt> + </image> + </paragraph> + <tip id="par_id351512558748321">Use the <item type="input">Tab</item> and <item type="input">Shift-Tab</item> keys to jump forth and back between text boxes of the form dialog.</tip> + <tip id="par_id731512558741034">You also can use the form scroll bar to move between text boxes.</tip> + <h2 id="hd_id701512558977465">Reopening the form dialog</h2> + <paragraph role="paragraph" id="par_id181512558987528" xml-lang="en-US">To reopen the form dialog, place the cursor on the header row and open the form. The displayed record in the form dialog is the first data record. Move to the last record before entering new data otherwise the current record will be edited.</paragraph> + <section id="relatedtopics"> + <paragraph id="par_id240920171007419799" role="paragraph" xml-lang="en-US"><link href="text/shared/guide/data_forms.xhp" name="Forms">Document Forms</link></paragraph> + </section> +</body> + +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/data_provider.xhp b/helpcontent2/source/text/scalc/01/data_provider.xhp new file mode 100644 index 000000000..b7714b2d9 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/data_provider.xhp @@ -0,0 +1,52 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . +--> + +<meta> + <topic id="textscalc01data_providerxml"> + <title id="tit" xml-lang="en-US">Data Provider for Spreadsheet</title> + <filename>/text/scalc/01/data_provider.xhp</filename> + </topic> +</meta> + +<body> + + + <bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/dataprovider/DataProviderDialog" id="bm_id240920171033409926" localize="false"/> + <bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/dataprovider/@@nowidget@@" id="bm_id240920171033409926" localize="false"/> +<bookmark xml-lang="en-US" branch="index" id="bm_id240920171018528200"> +<bookmark_value>data provider;for spreadsheets</bookmark_value> +</bookmark> + +<section id="data_provider"> +<h1 id="hd_id240920171003006302"><link href="text/scalc/01/data_provider.xhp">Data Provider for Spreadsheets</link></h1> +<paragraph id="par_id240920171003293400" role="paragraph" xml-lang="en-US"><ahelp hid=".">Data Provider for Spreadsheets</ahelp></paragraph> +</section> + +<section id="howtoget"> +<paragraph id="par_id240920171007389295" role="paragraph" xml-lang="en-US">Menu <item type="menuitem">Data – Data Provider...</item></paragraph> +</section> +<embed href="text/shared/need_help.xhp#needhelp"/> + +<section id="relatedtopics"> +<paragraph id="par_id240920171007419799" role="paragraph" xml-lang="en-US">Data Provider</paragraph> +</section> +</body> + +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/databar_more_options.xhp b/helpcontent2/source/text/scalc/01/databar_more_options.xhp new file mode 100644 index 000000000..97fee0d3e --- /dev/null +++ b/helpcontent2/source/text/scalc/01/databar_more_options.xhp @@ -0,0 +1,73 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at https://mozilla.org/MPL/2.0/. + * +--> + +<meta> + <topic id="Databar-MoreOptions" indexer="include" status="PUBLISH"> + <title id="Databar-Moreoptions" xml-lang="en-US">Databar More Options</title> + <filename>/text/scalc/01/databar_more_options.xhp</filename> + </topic> +</meta> +<body> + <bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/databaroptions/DatBarOptions" id="bm_id111610564351873" localize="false"/> + <bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/databaroptions/@@nowidget@@" id="bm_id121610564351873" localize="false"/> + <bookmark xml-lang="en-US" branch="index" id="bm_id651610566601713"> +<bookmark_value>conditional formatting;data bar options</bookmark_value> +<bookmark_value>data bar formatting;data bar options</bookmark_value> +<bookmark_value>data bar options;conditional formatting</bookmark_value> +</bookmark> + <h1 id="hd_id631610470827523"><variable id="databaroptions"><link href="/text/scalc/01/databar_more_options.xhp" name="More Options for Databar">Databar More Options</link></variable></h1> +<h2 id="hd_id531610472930609">Entry Values</h2> + <h3 id="hd_id661610569199542">Minimum:</h3><paragraph role="paragraph" id="par_id861610473146895"> Set the minimum value for which the data bar does not start filling.</paragraph> + <h3 id="hd_id501610569361264">Maximum:</h3><paragraph role="paragraph" id="par_id461610473163880"> Set the maximum value for which the data bar gets completely filled.</paragraph> + <paragraph role="paragraph" id="par_id791610556114310">The options for setting the minimum and maximum values are:</paragraph><list type="unordered"> <listitem> + <paragraph id="par_id621610556164264" role="listitem"><emph>Automatic:</emph> Automatically sets the minimum and maximum value based on the values in the data set.</paragraph> + </listitem> + <listitem> + <paragraph id="par_id591610556220990" role="listitem"><emph>Minimum:</emph> Automatically sets the minimum value in the data set as minimum.</paragraph> + </listitem> + <listitem> + <paragraph id="par_id951610556245716" role="listitem"><emph>Maximum:</emph> Automatically sets the maximum value in the data set for maximum.</paragraph> + </listitem> + <listitem> + <paragraph id="par_id901610556259738" role="listitem"><emph>Percentile:</emph> Set the minimum and maximum as percentile value.</paragraph> + </listitem> + <listitem> + <paragraph id="par_id621610556295743" role="listitem"><emph>Value:</emph> Set the minimum and maximum as a specific value.</paragraph> + </listitem> + <listitem> + <paragraph id="par_id331610556326466" role="listitem"><emph>Formula:</emph> Set the minimum and maximum as a formula.</paragraph> + </listitem> +</list> + <h2 id="hd_id551610558198954">Bar Colors</h2> + <h3 id="hd_id391610569504555">Positive:</h3><paragraph role="paragraph" id="par_id611610558381528"> Set the color for positive values. It is set to blue be default.</paragraph> + <h3 id="hd_id161610569508370">Negative:</h3><paragraph role="paragraph" id="par_id451610558525398"> Set the color for negative values. It is set to red by default.</paragraph> + <h3 id="hd_id261610569510818">Fill:</h3><paragraph role="paragraph" id="par_id221610558585001"> Choose between color and gradient for the fill.</paragraph> + <h2 id="hd_id711610558701623">Axis</h2> + <h3 id="hd_id731610569777368">Position of vertical axis:</h3><paragraph role="paragraph" id="par_id901610558734975"> Set the position of vertical axis in the cell.</paragraph> +<list type="unordered"> + <listitem> + <paragraph id="par_id591610558837411" role="listitem"><emph>Automatic:</emph> Set the axis automatically</paragraph> + </listitem> + <listitem> + <paragraph id="par_id991610558892435" role="listitem"><emph>Middle:</emph> Set the vertical position to be in the middle of the cell.</paragraph> + </listitem> + <listitem> + <paragraph id="par_id971610558965550" role="listitem"><emph>None:</emph> Set the data bar to have no visible vertical axis</paragraph> + </listitem> + </list> + <h3 id="hd_id591610569865757">Color of vertical axis:</h3><paragraph role="paragraph" id="par_id601610560622213"> Choose the color of the vertical axis.</paragraph> + <h2 id="hd_id631610560675220">Bar Lengths</h2> + <h3 id="hd_id651610569932338">Minimum bar length (%):</h3><paragraph role="paragraph" id="par_id381610560706116"> Set the minimum length of the data bar in percentage with respect to the cell length.</paragraph> + <h3 id="hd_id151610569983195">Maximum bar length (%):</h3><paragraph role="paragraph" id="par_id511610560783506"> Set the maximum length of the data bar in percentage with respect to the cell length. </paragraph> + <h2 id="hd_id821610560955981">Display bar only</h2> + <paragraph role="paragraph" id="par_id501610560981306">Only databar is shown. Value becomes hidden.</paragraph> +</body> +</helpdocument>
\ No newline at end of file diff --git a/helpcontent2/source/text/scalc/01/ex_data_stat_func.xhp b/helpcontent2/source/text/scalc/01/ex_data_stat_func.xhp new file mode 100644 index 000000000..7981e9191 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/ex_data_stat_func.xhp @@ -0,0 +1,162 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * +--> + +<meta> + <topic id="textscalc01func_averageifxml"> + <title id="tit" xml-lang="en-US">Examples Dataset for Statistical Functions</title> + <filename>/text/scalc/01/ex_data_stat_func.xhp</filename> + </topic> +</meta> + +<body> +<section id="ex_func_average"> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph role="paragraph" id="hd_id2609201512474295">Consider the following table</paragraph> +<table id="table_averageif_example"> + <tablerow> + <tablecell> + </tablecell> + <tablecell> + <paragraph id="par_id2509201517430799" role="tablehead" localize="false" xml-lang="en-US">A</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id250920151743116" role="tablehead" localize="false" xml-lang="en-US">B</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id2509201517431582" role="tablehead" localize="false" xml-lang="en-US">C</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id2509201517431967" role="tablehead" localize="false" xml-lang="en-US">1</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id18260631312423" role="tablecontent" xml-lang="en-US">Product Name</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id2509201517433075" role="tablecontent" xml-lang="en-US">Sales</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id2509201519383294" role="tablecontent" xml-lang="en-US">Revenue</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id959660094035" role="tablehead" localize="false" xml-lang="en-US">2</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id2855779586764" role="tablecontent" xml-lang="en-US">pencil</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id110202156219769" role="tablecontent" localize="false" xml-lang="en-US">20</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id23281929326512" role="tablecontent" localize="false" xml-lang="en-US">65</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id2509201517432278" role="tablehead" localize="false" xml-lang="en-US">3</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id24967262611733" role="tablecontent" xml-lang="en-US">pen</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id2509201517433391" role="tablecontent" localize="false" xml-lang="en-US">35</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id250920151938352" role="tablecontent" localize="false" xml-lang="en-US">85</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id250920151743267" role="tablehead" localize="false" xml-lang="en-US">4</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id252542413030532" role="tablecontent" xml-lang="en-US">notebook</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id2509201517433781" role="tablecontent" localize="false" xml-lang="en-US">20</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id2509201519383822" role="tablecontent" localize="false" xml-lang="en-US">190</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id2509201519371339" role="tablehead" localize="false" xml-lang="en-US">5</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id2509201519374677" role="tablecontent" xml-lang="en-US">book</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id2509201519373350" role="tablecontent" localize="false" xml-lang="en-US">17</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id2509201519384171" role="tablecontent" localize="false" xml-lang="en-US">180</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id6009596127912" role="tablehead" localize="false" xml-lang="en-US">6</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id19479417931163" role="tablecontent" xml-lang="en-US">pencil-case</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id85353130721737" role="tablecontent" xml-lang="en-US">not</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id15693941827291" role="tablecontent" xml-lang="en-US">not</paragraph> + </tablecell> + </tablerow> +</table> +<warning id="par_id1191767622119">In all examples below, ranges for calculation contain the row #6, which is ignored because it contains text.</warning> +</section> +<paragraph role="paragraph" id="par_id961527953004850" xml-lang="en-US"><variable id="args">Func_Range; Range1; Criterion[; Range2; Criterion2][; … ; [Range127; Criterion127]]</variable></paragraph> +<section id="note01"> + <note id="par_id94162948227556">The logical relation between criteria can be defined as logical AND (conjunction). In other words, if and only if all given criteria are met, a value from the corresponding cell of the given <emph>Func_Range</emph> is taken into calculation.</note> +</section> +<section id="warning01"> + <paragraph id="par_id14734320631377" role="paragraph" xml-lang="en-US"><emph>Func_Range</emph> and <emph>Range1, Range2...</emph> must have the same size, otherwise the function returns err:502 - Invalid argument.</paragraph> +</section> +<section id="par00"> + <paragraph id="par_id101585468691583" role="paragraph" xml-lang="en-US"><emph>Range1</emph> – required argument. It is a range of cells, a name of a named range, or a label of a column or a row, to which the corresponding criterion is to be applied.</paragraph> + <section id="criterion"> + <paragraph role="paragraph" id="par_id621619279022341"><emph>Criterion</emph>: A criterion is a single cell Reference, Number or Text. It is used in comparisons with cell contents.</paragraph> + <paragraph role="paragraph" id="par_id731619279029255">A reference to an empty cell is interpreted as the numeric value 0.</paragraph> + <paragraph role="paragraph" id="par_id31619279035359">A matching expression can be:</paragraph> + <list type="unordered"> + <listitem> + <paragraph id="par_id171619279059462" role="listitem">A Number or Logical value. A matching cell content equals the Number or Logical value. </paragraph> + </listitem> + <listitem> + <paragraph id="par_id511619279076504" role="listitem">A value beginning with a comparator (<, <=, =, >, >=, <>).</paragraph> + <paragraph role="paragraph" id="par_id11619279168512">For =, if the value is empty it matches empty cells.</paragraph> + <paragraph role="paragraph" id="par_id161619279207350">For <>, if the value is empty it matches non-empty cells.</paragraph> + <paragraph role="paragraph" id="par_id271619279215695">For <>, if the value is not empty it matches any cell content except the value, including empty cells.</paragraph> + <paragraph role="paragraph" id="par_id861619279223855"><emph>Note:</emph> "=0" does not match empty cells.</paragraph> + <paragraph role="paragraph" id="par_id51619279363954">For = and <>, if the value is not empty and can not be interpreted as a Number type or one of its subtypes and the property <link href="text/shared/optionen/01060500.xhp" name="s">Search criteria = and <> must apply to whole cells</link> is checked, comparison is against the entire cell contents, if unchecked, comparison is against any subpart of the field that matches the criteria. For = and <>, if the value is not empty and can not be interpreted as a Number type or one of its subtypes applies. </paragraph> + </listitem> + <listitem> + <paragraph id="par_id801619279323556" role="listitem">Other Text value. If the property <link href="text/shared/optionen/01060500.xhp" name="s">Search criteria = and <> must apply to whole cells</link> is true, the comparison is against the entire cell contents, if false, comparison is against any subpart of the field that matches the criteria. The expression can contain text, numbers, regular expressions or wildcards (<link href="text/shared/optionen/01060500.xhp#wildcards" name="Wild cards">if enabled in calculation options</link>).</paragraph> + </listitem> + </list> + </section> + <paragraph id="par_id190621657742" role="paragraph" xml-lang="en-US"><emph>Range2</emph> – Optional. Range2 and all the following mean the same as Range1.</paragraph> + <paragraph id="par_id317001803813193" role="paragraph" xml-lang="en-US"><emph>Criterion2</emph> – Optional. Criterion2 and all the following mean the same as Criterion.</paragraph> +</section> +<section id="par01"> + <paragraph xml-lang="en-US" id="par_id191527781733238" role="paragraph">The function can have up to 255 arguments, meaning that you can specify 127 criteria ranges and criteria for them.</paragraph> + <paragraph id="par_id175721789527973" role="paragraph" xml-lang="en-US">If a cell contains TRUE, it is treated as 1, if a cell contains FALSE – as 0 (zero).</paragraph> +</section> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/exponsmooth_embd.xhp b/helpcontent2/source/text/scalc/01/exponsmooth_embd.xhp new file mode 100644 index 000000000..8fe3927cd --- /dev/null +++ b/helpcontent2/source/text/scalc/01/exponsmooth_embd.xhp @@ -0,0 +1,386 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. +--> + +<meta> + <topic id="ID" indexer="include"> + <title id="tit" xml-lang="en-US">embedded text for exponential smoothing</title> + <filename>/text/scalc/01/exponsmooth_embd.xhp</filename> + </topic> +</meta> +<body> +<section id="intro"> + <paragraph id="par_id0403201618694534" role="paragraph" xml-lang="en-US">Exponential Smoothing is a method to smooth real values in time series in order to forecast probable future values.</paragraph> + +<paragraph id="par_id0403201618694535" role="paragraph" xml-lang="en-US">Exponential Triple Smoothing (ETS) is a set of algorithms in which both trend and periodical (seasonal) influences are processed. Exponential Double Smoothing (EDS) is an algorithm like ETS, but without the periodical influences. EDS produces linear forecasts.</paragraph> + +<paragraph id="par_id0403201618694537" role="tip" xml-lang="en-US">See the <link href="https://en.wikipedia.org/wiki/Exponential_smoothing" name="English Wikipedia: Exponential smoothing">Wikipedia on Exponential smoothing algorithms</link> for more information.</paragraph> + </section> + +<section id="target"> +<paragraph id="par_id0403201618594534" role="paragraph" xml-lang="en-US"><emph>target (mandatory):</emph> A date, time or numeric single value or range. The data point/range for which to calculate a forecast.</paragraph> +</section> + +<section id="values"> +<paragraph id="par_id040320161859459" role="paragraph" xml-lang="en-US"><emph>values (mandatory):</emph> A numeric array or range. <emph>values</emph> are the historical values, for which you want to forecast the next points.</paragraph> +</section> + +<section id="timeline"> +<paragraph id="par_id0403201618594553" role="paragraph" xml-lang="en-US"><emph>timeline (mandatory):</emph> A numeric array or range. The timeline (x-value) range for the historical values. </paragraph> +<paragraph id="par_id040320161859450" role="note" xml-lang="en-US">The timeline does not have to be sorted, the functions will sort it for calculations.<br/>The timeline values must have a consistent step between them.<br/>If a constant step cannot be identified in the sorted timeline, the functions will return the #NUM! error.<br/>If the ranges of both the timeline and the historical values are not the same size, the functions will return the #N/A error.<br/>If the timeline contains fewer than 2 data periods, the functions will return the #VALUE! error.</paragraph> +</section> + +<section id="datacompletion"> +<paragraph id="par_id0403201618594513" role="paragraph" xml-lang="en-US"><emph>data_completion (optional):</emph> a logical value TRUE or FALSE, a numeric 1 or 0, default is 1 (TRUE). A value of 0 (FALSE) will add missing data points with zero as historical value. A value of 1 (TRUE) will add missing data points by interpolating between the neighboring data points.</paragraph> +<paragraph id="par_id0403201618594678" role="note" xml-lang="en-US">Although the time line requires a constant step between data points, the function support up to 30% missing data points, and will add these data points. </paragraph> +</section> + +<section id="aggregation"> +<paragraph id="par_id0403201618594650" role="paragraph" xml-lang="en-US"><emph>aggregation (optional):</emph> A numeric value from 1 to 7, with default 1. The aggregation parameter indicates which method will be used to aggregate identical time values:</paragraph> + +<table id="Tabela1"> + <tablerow> + <tablecell> + <paragraph id="par_id0403201618594696" role="tablehead" xml-lang="en-US">Aggregation</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id040320161859464" role="tablehead" xml-lang="en-US">Function</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id0403201618564423" role="tablecontent" localize="false" xml-lang="en-US">1</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id0403201618594636" role="tablecontent" xml-lang="en-US">AVERAGE</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id0403201618565433" role="tablecontent" localize="false" xml-lang="en-US">2</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id0403201618594692" role="tablecontent" xml-lang="en-US">COUNT</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id0403201618565982" role="tablecontent" localize="false" xml-lang="en-US">3</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id0403201618594633" role="tablecontent" xml-lang="en-US">COUNTA</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id0403201618570026" role="tablecontent" localize="false" xml-lang="en-US">4</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id040320161859460" role="tablecontent" xml-lang="en-US">MAX</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id0403201618570154" role="tablecontent" localize="false" xml-lang="en-US">5</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id0403201618594658" role="tablecontent" xml-lang="en-US">MEDIAN</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id0403201618570236" role="tablecontent" localize="false" xml-lang="en-US">6</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id0403201618594671" role="tablecontent" xml-lang="en-US">MIN</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id0403201618570394" role="tablecontent" localize="false" xml-lang="en-US">7</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id0403201618594639" role="tablecontent" xml-lang="en-US">SUM</paragraph> + </tablecell> + </tablerow> +</table> + +<paragraph id="par_id0403201618595033" role="note" xml-lang="en-US">Although the time line requires a constant step between data points, the functions will aggregate multiple points which have the same time stamp. </paragraph> +</section> + +<section id="statistics"> +<paragraph id="par_id0503201619582693" role="paragraph" xml-lang="en-US"><emph>stat_type (mandatory)</emph>: A numerical value from 1 to 9. A value indicating which statistic will be returned for the given values and x-range.</paragraph> +<paragraph id="par_id0503201619582620" role="paragraph" xml-lang="en-US">The following statistics can be returned:</paragraph> + +<table id="tbl_0503201619535874"> + <tablerow> + <tablecell> + <paragraph id="par_id0503201619582666" role="tablehead" xml-lang="en-US">stat_type</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id050320161958264" role="tablehead" xml-lang="en-US">Statistics</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id0503201619582639" role="tablecontent" localize="false" xml-lang="en-US">1</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id0503201619582658" role="tablecontent" xml-lang="en-US">Alpha smoothing parameter of ETS algorithm (base)</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id0503201619582687" role="tablecontent" localize="false" xml-lang="en-US">2</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id0503201619582673" role="tablecontent" xml-lang="en-US">Gamma smoothing parameter of ETS algorithm (trend)</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id0503201619583658" role="tablecontent" localize="false" xml-lang="en-US">3</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id0503201619582780" role="tablecontent" xml-lang="en-US">Beta smoothing parameter of ETS algorithm (periodic deviation)</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id0503201619582737" role="tablecontent" localize="false" xml-lang="en-US">4</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id0503201619582795" role="tablecontent" xml-lang="en-US">Mean absolute scaled error (MASE) - a measure of the accuracy of forecasts.</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id0503201619582782" role="tablecontent" localize="false" xml-lang="en-US">5</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id0503201619582749" role="tablecontent" xml-lang="en-US">Symmetric mean absolute percentage error (SMAPE) - an accuracy measure based on percentage errors.</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id0503201619582739" role="tablecontent" localize="false" xml-lang="en-US">6</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id0503201619582725" role="tablecontent" xml-lang="en-US">Mean absolute error (MAE) – a measure of the accuracy of forecasts.</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id0503201619582788" role="tablecontent" localize="false" xml-lang="en-US">7</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id0503201619582750" role="tablecontent" xml-lang="en-US">Root mean squared error (RMSE) - a measure of the differences between predicted and observed values.</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id0503201619582741" role="tablecontent" localize="false" xml-lang="en-US">8</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id0503201619582771" role="tablecontent" xml-lang="en-US">Step size detected time line (x-range). When a stepsize in months/quarters/years is detected, the stepsize is in months, otherwise the stepsize is in days in case of date(time) timeline and numeric in other cases. </paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id0503201619582767" role="tablecontent" localize="false" xml-lang="en-US">9</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id0503201619582717" role="tablecontent" xml-lang="en-US">Number of samples in period – this is the same as argument <emph>period_length</emph>, or the calculated number in case of argument <emph>period_length</emph> being 1. </paragraph> + </tablecell> + </tablerow> +</table> + +</section> + +<section id="confidence"> +<paragraph id="par_id0503201619582665" role="paragraph" xml-lang="en-US"><emph>confidence_level (mandatory)</emph>: A numeric value between 0 and 1 (exclusive), default is 0.95. A value indicating a confidence level for the calculated prediction interval.</paragraph> +<paragraph id="par_id0503201619582644" role="note" xml-lang="en-US">With values <= 0 or >= 1, the functions will return the #NUM! Error.</paragraph> +</section> + +<section id="numsampperiod"> +<paragraph id="par_id0603201609412381" role="paragraph" xml-lang="en-US"><emph>period_length (optional)</emph>: A numeric value >= 0, the default is 1. A positive integer indicating the number of samples in a period. </paragraph> +<paragraph id="par_id0603201609412399" role="note" xml-lang="en-US">A value of 1 indicates that Calc is to determine the number of samples in a period automatically. <br/>A value of 0 indicates no periodic effects, a forecast is calculated with EDS algorithms. <br/>For all other positive values, forecasts are calculated with ETS algorithms.<br/>For values that not being a positive whole number, the functions will return the #NUM! Error.</paragraph> +</section> + +<section id="etsadd"> +<paragraph id="par_id0603201608440579" role="code" xml-lang="en-US">forecast = basevalue + trend * ∆x + periodical_aberration.</paragraph> +</section> + +<section id="etsmult"> +<paragraph id="par_id0603201608440675" role="code" xml-lang="en-US">forecast = ( basevalue + trend * ∆x ) * periodical_aberration.</paragraph> +</section> + +<section id="exampledata"> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph id="hd_id0603201610005723" role="paragraph" xml-lang="en-US">The table below contains a timeline and its associated values:</paragraph> +<table id="Tabela3"> + <tablerow> + <tablecell> + <paragraph id="par_id0903201610293753" role="tablecontent" localize="false" xml-lang="en-US"/> + </tablecell> + <tablecell> + <paragraph id="par_id0903201610300936" role="tablehead" localize="false" xml-lang="en-US">A</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id0903201610303544" role="tablehead" localize="false" xml-lang="en-US">B</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id0903201610294112" role="tablehead" localize="false" xml-lang="en-US">1</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id0903201610312235" role="tablehead" xml-lang="en-US">Timeline</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id0903201610312228" role="tablehead" xml-lang="en-US">Values</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id090320161029434" role="tablehead" localize="false" xml-lang="en-US">2</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id0903201610301211" role="tablecontent" localize="false" xml-lang="en-US">01/2013</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id0903201610303777" role="tablecontent" localize="false" xml-lang="en-US">112</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id0903201610294532" role="tablehead" localize="false" xml-lang="en-US">3</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id0903201610301377" role="tablecontent" localize="false" xml-lang="en-US">02/2013</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id0903201610303972" role="tablecontent" localize="false" xml-lang="en-US">118</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id0903201610294658" role="tablehead" localize="false" xml-lang="en-US">4</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id0903201610301586" role="tablecontent" localize="false" xml-lang="en-US">03/2013</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id0903201610304214" role="tablecontent" localize="false" xml-lang="en-US">132</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id0903201610294721" role="tablehead" localize="false" xml-lang="en-US">5</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id0903201610301829" role="tablecontent" localize="false" xml-lang="en-US">04/2013</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id0903201610304365" role="tablecontent" localize="false" xml-lang="en-US">100</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id0903201610294810" role="tablehead" localize="false" xml-lang="en-US">6</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id0903201610301986" role="tablecontent" localize="false" xml-lang="en-US">05/2013</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id0903201610304419" role="tablecontent" localize="false" xml-lang="en-US">121</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id0903201610295069" role="tablehead" localize="false" xml-lang="en-US">7</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id0903201610302140" role="tablecontent" localize="false" xml-lang="en-US">06/2013</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id090320161030452" role="tablecontent" localize="false" xml-lang="en-US">135</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id0903201610295133" role="tablehead" localize="false" xml-lang="en-US">8</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id0903201610302288" role="tablecontent" localize="false" xml-lang="en-US">07/2013</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id0903201610304756" role="tablecontent" localize="false" xml-lang="en-US">148</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id0903201610295347" role="tablehead" localize="false" xml-lang="en-US">9</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id0903201610302389" role="tablecontent" localize="false" xml-lang="en-US">08/2013</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id090320161030480" role="tablecontent" localize="false" xml-lang="en-US">148</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id0903201610295495" role="tablehead" localize="false" xml-lang="en-US">10</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id0903201610302420" role="tablecontent" localize="false" xml-lang="en-US">09/2013</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id0903201610304994" role="tablecontent" localize="false" xml-lang="en-US">136</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id0903201610295668" role="tablehead" localize="false" xml-lang="en-US">11</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id0903201610302687" role="tablecontent" localize="false" xml-lang="en-US">10/2013</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id0903201610305156" role="tablecontent" localize="false" xml-lang="en-US">119</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id0903201610295729" role="tablehead" localize="false" xml-lang="en-US">12</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id0903201610302713" role="tablecontent" localize="false" xml-lang="en-US">11/2013</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id0903201610305294" role="tablecontent" localize="false" xml-lang="en-US">104</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id0903201610300473" role="tablehead" localize="false" xml-lang="en-US">13</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id0903201610302922" role="tablecontent" localize="false" xml-lang="en-US">12/2013</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id0903201610305330" role="tablecontent" localize="false" xml-lang="en-US">118</paragraph> + </tablecell> + </tablerow> +</table> +</section> +</body> + +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/format_graphic.xhp b/helpcontent2/source/text/scalc/01/format_graphic.xhp new file mode 100644 index 000000000..01f17a2d7 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/format_graphic.xhp @@ -0,0 +1,46 @@ +<?xml version="1.0" encoding="UTF-8"?> + + +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . + --> + +<helpdocument version="1.0"> +<meta> +<topic id="textscalc01format_graphicxhp" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">Graphic</title> +<filename>/text/scalc/01/format_graphic.xhp</filename> +</topic> +<history> +<created date="2005-07-15T13:44:54">Format Graphic menu in Calc</created> +</history> +</meta> +<body> +<section id="graphic"> +<bookmark xml-lang="en-US" branch="hid/.uno:DrawGraphicMenu" id="bm_id7711111" localize="false"/> +<paragraph role="heading" id="par_idN10548" xml-lang="en-US" level="1"><link href="text/scalc/01/format_graphic.xhp">Graphic</link></paragraph> +<paragraph role="paragraph" id="par_idN10558" xml-lang="en-US"><ahelp hid=".">Opens a submenu to edit the properties of the selected object.</ahelp></paragraph> +</section> +<embed href="text/shared/01/05230000.xhp#position_and_size"/> +<embed href="text/shared/01/05200000.xhp#line"/> +<embed href="text/shared/01/05210000.xhp#area"/> +<paragraph role="heading" id="par_id1650440" xml-lang="en-US" level="2"><link href="text/shared/01/05990000.xhp">Define Text Attributes</link></paragraph> +<paragraph role="paragraph" id="par_id363475" xml-lang="en-US">Sets the layout and anchoring properties for text in the selected drawing or text object.</paragraph> +<paragraph role="heading" id="par_id9746696" xml-lang="en-US" level="2">Points</paragraph> +<paragraph role="paragraph" id="par_id2480544" xml-lang="en-US"><ahelp hid=".">Switches <emph>Edit Points</emph> mode for an inserted freeform line on and off.</ahelp></paragraph> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/formula2value.xhp b/helpcontent2/source/text/scalc/01/formula2value.xhp new file mode 100644 index 000000000..3b06a1c7d --- /dev/null +++ b/helpcontent2/source/text/scalc/01/formula2value.xhp @@ -0,0 +1,36 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> + <!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + --> + + <meta> + <topic id="formulatovalues" indexer="include" status="PUBLISH"> + <title id="tit" xml-lang="en-US">Formula to values</title> + <filename>/text/scalc/01/formula2value.xhp</filename> + </topic> + </meta> + <body> + <bookmark id="bm_id851645222861111" xml-lang="en-US" branch="hid/.uno:ConvertFormulaToValue" localize="false"/> + <bookmark xml-lang="en-US" branch="index" id="bm_id321645231251889"> +<bookmark_value>convert;formula to values</bookmark_value> +<bookmark_value>replace formula with values</bookmark_value> +<bookmark_value>recalculate;formula to values</bookmark_value> +<bookmark_value>formula to values;convert</bookmark_value> +<bookmark_value>formula to values;recalculate</bookmark_value> + </bookmark> + <section id="formula2value"> + <h1 id="hd_id701645222861113"><variable id="formula2valueh1"><link href="text/scalc/01/formula2value.xhp" name="formula to values">Formula to value</link></variable></h1> + <paragraph id="par_id501645222861116" role="paragraph" xml-lang="en-US">Replaces the formula cell with value calculated by the formula. The formula is lost.</paragraph> + </section> + <section id="howtoget"> + <embed href="text/scalc/00/00000406.xhp#formula2value"/> + </section> + <paragraph role="paragraph" id="par_id51645230882532">Use this command to convert formula cells into data cells. The converted cells contents becomes static and will not be recalculated.</paragraph> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/ful_func.xhp b/helpcontent2/source/text/scalc/01/ful_func.xhp new file mode 100644 index 000000000..1a1f2a3a5 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/ful_func.xhp @@ -0,0 +1,93 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. +--> +<meta> + <topic id="textscalc01ful_funcxml"> + <title id="tit" xml-lang="en-US" localize="false">Frequently Used Lexemes</title> + <filename>/text/scalc/01/ful_func.xhp</filename> + </topic> +</meta> +<body> + <comment> Title in descriptions of functions </comment> + <section id="func_head_syntax"> + <h3 id="hd_id126511265112651">Syntax</h3> + </section> + <section id="func_head_example"> + <h3 id="hd_id980889808898088">Examples</h3> + </section> + <section id="func_head_returns"> + <h3 id="hd_id980889808897165">Returns</h3> + </section> + + <comment> Yes or No paragraphs to be used in description tables </comment> + <section id="Yes_par"> + <paragraph role="paragraph" id="par_id631556228511025">Yes</paragraph> + </section> + <section id="No_par"> + <paragraph role="paragraph" id="par_id631556228544875">No</paragraph> + </section> + + <comment> Notes for functions </comment> + <note id="par_id2595283314097"> + <variable id="func_im_comp_numb">A <emph>complex number</emph> is a string expression resulting in the form "a+bi" or "a+bj", where a and b are numbers.</variable> + </note> + <note id="par_id26516178768369"> + <variable id="func_im_real_numb">If the <emph>complex number</emph> is actually a real number (b=0), then it can be either a string expression or a number value.</variable> + </note> + + <comment>Warnings for functions </comment> + <warning id="par_id1566939488738"> + <variable id="func_im_return_text">The function always returns a string representing a complex number.</variable> + </warning> + <warning id="par_id9623767621137"> + <variable id="func_im_ignor_zero">If the result is a complex number with one of its parts (a or b) equal to zero, that part is not displayed.</variable> + </warning> + + <comment> Other paragraphs </comment> + <paragraph id="par_id962376732432" role="paragraph" xml-lang="en-US"> + <variable id="func_imag_zero">The imaginary part is equal to zero, so it is not displayed in the result.</variable> + </paragraph> + <section id="func_im_des"> + <paragraph id="par_id29750345314640" role="paragraph" xml-lang="en-US">The result is presented in the string format and has the character "i" or "j" as an imaginary unit.</paragraph> + </section> + + <comment>255 arguments</comment> + <paragraph role="paragraph" id="par_id71584446760037"><variable id="string255_1">String 1 [; String 2 [; … [; String 255]]]</variable></paragraph> + <section id="string255"> + <paragraph role="paragraph" id="par_id631556228516997"><emph>String 1, String 2, … , String 255</emph> are strings, references to cells or to cell ranges of strings.</paragraph> + </section> + <paragraph role="paragraph" id="par_id401584447957914"><variable id="integer255_1">Integer 1 [; Integer 2 [; … [; Integer 255]]]</variable></paragraph> + <section id="integer255"> + <paragraph role="paragraph" id="par_id1001584395844941"><emph>Integer 1, Integer 2, … , Integer 255</emph> are integers, references to cells or to cell ranges of integers.</paragraph> + </section> + <paragraph role="paragraph" id="par_id101584447971004"><variable id="number254_1">Number 1 [; Number 2 [; … [; Number 254]]]</variable></paragraph> + <section id="number254"> + <paragraph role="paragraph" id="par_id931584305947010"><emph>Number 1, Number 2, … , Number 254</emph> are numbers, references to cells or to cell ranges of numbers.</paragraph> + </section> + <paragraph role="paragraph" id="par_id101584447970004"><variable id="number255_1">Number 1 [; Number 2 [; … [; Number 255]]]</variable></paragraph> + <section id="number255"> + <paragraph role="paragraph" id="par_id931584395947010"><emph>Number 1, Number 2, … , Number 255</emph> are numbers, references to cells or to cell ranges of numbers.</paragraph> + </section> + <paragraph role="paragraph" id="par_id291584447988879"><variable id="logical255_1">Logical 1 [; Logical 2 [; … [; Logical 255]]]</variable></paragraph> + <section id="logical255"> + <paragraph role="paragraph" id="par_id931584395957010"><emph>Logical 1, Logical 2, … , Logical 255</emph> are boolean values, references to cells or to cell ranges of logical values.</paragraph> + </section> + <paragraph role="paragraph" id="par_id91584448008632"><variable id="complex255_1">Complex 1 [; Complex 2 [; … [; Complex 255]]]</variable></paragraph> + <section id="complex255"> + <paragraph role="paragraph" id="par_id931584335947010"><emph>Complex 1, Complex 2, … ,Complex 255</emph> are complex numbers, references to cells or to cell ranges of complex numbers. Complex numbers are entered in the form "x+yi" or "x+yj". </paragraph> + </section> + <paragraph role="paragraph" id="par_id61584448028298"><variable id="reference255_1">Reference 1 [; Reference 2 [; … [; Reference 255]]]</variable></paragraph> + <section id="reference255"> + <paragraph role="paragraph" id="par_id431584335947010"><emph>Reference 1, Reference 2, … ,Reference 255</emph> are references to cells.</paragraph> + </section> + <section id="func_volatile"> + <paragraph role="paragraph" id="par_id1001601332672155">This function is always recalculated whenever a recalculation occurs.</paragraph> + </section> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/func_aggregate.xhp b/helpcontent2/source/text/scalc/01/func_aggregate.xhp new file mode 100644 index 000000000..c914b0073 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/func_aggregate.xhp @@ -0,0 +1,441 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. +--> + +<meta> + <topic id="textscalc01func_aggregatexml"> + <title id="tit" xml-lang="en-US">AGGREGATE function</title> + <filename>/text/scalc/01/func_aggregate.xhp</filename> + </topic> +</meta> +<body> +<section id="aggregate_function"> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_AGGREGATE" id="bm_id13660154375100" localize="false"/> +<bookmark xml-lang="en-US" branch="index" id="bm_id126123001625791"> + <bookmark_value>AGGREGATE function</bookmark_value> +</bookmark> +<h1 id="hd_id3154073"><variable id="aggregate_head"><link href="text/scalc/01/func_aggregate.xhp">AGGREGATE</link></variable> function</h1> +<paragraph id="par_id2209201514174373" role="paragraph" xml-lang="en-US"><ahelp hid="."><variable id="aggregate_des">This function returns an aggregate result of the calculations in the range. You can use different aggregate functions listed below. The Aggregate function enables you to omit hidden rows, errors, SUBTOTAL and other AGGREGATE function results in the calculation.</variable></ahelp></paragraph> +</section> +<note id="par_id2209201514174453">AGGREGATE function is applied to vertical ranges of data with activated AutoFilter. If AutoFilter is not activated, automatic recalculation of the function result does not work for newly hidden rows. It is not supposed to work with horizontal ranges, however it can be applied to them as well, but with limitations. In particular, the AGGREGATE function applied to a horizontal data range does not recognize hiding columns, however correctly omits errors and results of SUBTOTAL and other AGGREGATE functions embedded into the row. </note> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id200801176228491" role="code" xml-lang="en-US">AGGREGATE(Function; Option; Number 1[; Number 2][; ... ;[Number 253]])</paragraph> +<paragraph id="par_id2309201516102726" role="paragraph" xml-lang="en-US">or</paragraph> +<paragraph id="par_id30181907128680" role="code" xml-lang="en-US">AGGREGATE(Function; Option; Array[; k])</paragraph> + +<paragraph id="par_id2209201514174378" role="paragraph" xml-lang="en-US"><emph>Function</emph> – obligatory argument. A function index or a reference to a cell with value from 1 to 19, in accordance with the following table. </paragraph> + +<table id="table_functions_aggregate"> + <tablerow> + <tablecell> + <paragraph id="par_id2309201511454963" role="tablehead" xml-lang="en-US">Function index</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id2309201511454945" role="tablehead" xml-lang="en-US">Function applied</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id2309201511360097" role="tablecontent" localize="false" xml-lang="en-US">1</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id2309201511360043" role="paragraph" xml-lang="en-US">AVERAGE</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id2309201511360099" role="tablecontent" localize="false" xml-lang="en-US">2</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id230920151136007" role="paragraph" xml-lang="en-US">COUNT</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id2309201511360027" role="tablecontent" localize="false" xml-lang="en-US">3</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id2309201511360018" role="paragraph" xml-lang="en-US">COUNTA</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id230920151136004" role="tablecontent" localize="false" xml-lang="en-US">4</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id2309201511360026" role="paragraph" xml-lang="en-US">MAX</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id2309201511360080" role="tablecontent" localize="false" xml-lang="en-US">5</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id2309201511360078" role="paragraph" xml-lang="en-US">MIN</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id2309201511360031" role="tablecontent" localize="false" xml-lang="en-US">6</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id2309201511360087" role="paragraph" xml-lang="en-US">PRODUCT</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id2309201511360175" role="tablecontent" localize="false" xml-lang="en-US">7</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id2309201511360153" role="paragraph" xml-lang="en-US">STDEV.S</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id255902101420976" role="tablecontent" localize="false" xml-lang="en-US">8</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id2309201511360178" role="paragraph" xml-lang="en-US">STDEV.P</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id2309201511360158" role="tablecontent" localize="false" xml-lang="en-US">9</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id2309201511360199" role="paragraph" xml-lang="en-US">SUM</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id29935318632937" role="tablecontent" localize="false" xml-lang="en-US">10</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id2309201511360174" role="paragraph" xml-lang="en-US">VAR.S</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id2309201511360133" role="tablecontent" localize="false" xml-lang="en-US">11</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id2309201511360120" role="paragraph" xml-lang="en-US">VAR.P</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id2309201511360171" role="tablecontent" localize="false" xml-lang="en-US">12</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id2309201511360122" role="paragraph" xml-lang="en-US">MEDIAN</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id2309201511360111" role="tablecontent" localize="false" xml-lang="en-US">13</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id230920151136016" role="paragraph" xml-lang="en-US">MODE.SNGL</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id2309201511360130" role="tablecontent" localize="false" xml-lang="en-US">14</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id2309201511360180" role="paragraph" xml-lang="en-US">LARGE</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id2309201511360116" role="tablecontent" localize="false" xml-lang="en-US">15</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id2309201511360150" role="paragraph" xml-lang="en-US">SMALL</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id2309201511360132" role="tablecontent" localize="false" xml-lang="en-US">16</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id2309201511360157" role="paragraph" xml-lang="en-US">PERCENTILE.INC </paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id2309201511360155" role="tablecontent" localize="false" xml-lang="en-US">17</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id2309201511360151" role="paragraph" xml-lang="en-US">QUARTILE.INC</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id2309201511360162" role="tablecontent" localize="false" xml-lang="en-US">18</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id230920151136017" role="paragraph" xml-lang="en-US">PERCENTILE.EXC</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id2309201511360141" role="tablecontent" localize="false" xml-lang="en-US">19</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id2309201511360169" role="paragraph" xml-lang="en-US">QUARTILE.EXC</paragraph> + </tablecell> + </tablerow> +</table> + +<paragraph id="par_id2209201514174372" role="paragraph" xml-lang="en-US"><emph>Option</emph> – obligatory argument. An option index or reference to a cell with value from 0 to 7 determines what to ignore in the range for the function.</paragraph> + +<table id="table_options_aggregate"> + <tablerow> + <tablecell> + <paragraph id="par_id2309201512011557" role="tablehead" xml-lang="en-US">Option index</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id2309201512011551" role="tablehead" xml-lang="en-US">Option applied</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id2309201512011582" role="tablecontent" localize="false" xml-lang="en-US">0</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id2309201512011567" role="tablecontent" xml-lang="en-US">Ignore only nested SUBTOTAL and AGGREGATE functions </paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id2309201512011554" role="tablecontent" localize="false" xml-lang="en-US">1</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id315771547630277" role="tablecontent" xml-lang="en-US">Ignore only hidden rows, nested SUBTOTAL and AGGREGATE functions </paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id2309201512011521" role="tablecontent" localize="false" xml-lang="en-US">2</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id2309201512011514" role="tablecontent" xml-lang="en-US">Ignore only errors, nested SUBTOTAL and AGGREGATE functions </paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id2309201512011568" role="tablecontent" localize="false" xml-lang="en-US">3</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id2309201512011547" role="tablecontent" xml-lang="en-US">Ignore hidden rows, errors, nested SUBTOTAL and AGGREGATE functions</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id2309201512011515" role="tablecontent" localize="false" xml-lang="en-US">4</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id2309201512011510" role="tablecontent" xml-lang="en-US">Ignore nothing</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id2309201512011558" role="tablecontent" localize="false" xml-lang="en-US">5</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id2309201512011592" role="tablecontent" xml-lang="en-US">Ignore only hidden rows</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id2309201512011524" role="tablecontent" localize="false" xml-lang="en-US">6</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id230920151201150" role="tablecontent" xml-lang="en-US">Ignore only errors</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id2309201512011519" role="tablecontent" localize="false" xml-lang="en-US">7</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id2309201512011539" role="tablecontent" xml-lang="en-US">Ignore only hidden rows and errors</paragraph> + </tablecell> + </tablerow> +</table> + +<paragraph id="par_id220402843321947" role="paragraph" xml-lang="en-US"><emph>Number1</emph> – required argument. The first numeric argument (if the range is set by a list of values inside the function) or a reference to a cell that contains it. </paragraph> +<paragraph id="par_id2309201514193338" role="paragraph" xml-lang="en-US"><emph>Number2, 3, ...</emph> – optional. A numeric argument or a reference to a cell (up to 253 arguments), for which you need the aggregate value.</paragraph> +<paragraph id="par_id99381371214702" role="paragraph" xml-lang="en-US"><emph>Array</emph> – required argument. The array can be specified by the boundaries of the range, the name of the named range or the column label.</paragraph> +<note id="par_id2309201515555812">For using column labels “Automatically find columns and rows labels” function needs to be enabled.</note> +<paragraph id="par_id2209201514174370" role="paragraph" xml-lang="en-US"><emph>k</emph> – required argument for the following functions: LARGE, SMALL, PERCENTILE.INC, QUARTILE.INC, PERCENTILE.EXC, QUARTILE.EXC. It is a numeric argument, which must correspond to the second argument of these functions.</paragraph> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> + +<table id="Table_example_aggregate"> + <tablerow> + <tablecell> + </tablecell> + <tablecell> + <paragraph id="par_id2309201517365893" role="tablehead" localize="false" xml-lang="en-US">A</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id2309201517370258" role="tablehead" localize="false" xml-lang="en-US">B</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id2309201517370634" role="tablehead" localize="false" xml-lang="en-US">C</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id2309201518440896" role="tablehead" localize="false" xml-lang="en-US">1</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id2309201518454314" role="tablecontent" xml-lang="en-US"><emph>ColumnOne</emph></paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id2309201518454361" role="tablecontent" xml-lang="en-US"><emph>ColumnTwo</emph></paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id2309201518454323" role="tablecontent" xml-lang="en-US"><emph>ColumnThree</emph></paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id2309201518441431" role="tablehead" localize="false" xml-lang="en-US">2</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id230920151737158" role="tablecontent" localize="false" xml-lang="en-US">34</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id230920151737193" role="tablecontent" localize="false" xml-lang="en-US">11</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id230920151737237" role="tablecontent" localize="false" xml-lang="en-US">12</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id2309201518441863" role="tablehead" localize="false" xml-lang="en-US">3</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id230920151737314" role="tablecontent" localize="false" xml-lang="en-US">10</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id2309201517373578" role="tablecontent" localize="false" xml-lang="en-US">56</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id2309201517373986" role="tablecontent" localize="false" xml-lang="en-US">35</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id2309201518442333" role="tablehead" localize="false" xml-lang="en-US">4</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id27530261624700" role="tablecontent" xml-lang="en-US">#DIV/0!</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id2309201517383112" role="tablecontent" localize="false" xml-lang="en-US">5</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id2309201517384053" role="tablecontent" xml-lang="en-US">3</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id2309201518442714" role="tablehead" localize="false" xml-lang="en-US">5</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id2309201517381443" role="tablecontent" localize="false" xml-lang="en-US">20</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id2309201517384793" role="tablecontent" localize="false" xml-lang="en-US">8</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id2309201517384332" role="tablecontent" localize="false" xml-lang="en-US">1</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id2309201518443189" role="tablehead" localize="false" xml-lang="en-US">6</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id2309201517381714" role="tablecontent" localize="false" xml-lang="en-US">0</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id2309201517385044" role="tablecontent" localize="false" xml-lang="en-US">8</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id2309201517390378" role="tablecontent" localize="false" xml-lang="en-US">9</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id2309201518443420" role="tablehead" localize="false" xml-lang="en-US">7</paragraph> + </tablecell> + <tablecell> + <paragraph id="id_par29987248418152" role="tablecontent" xml-lang="en-US">#VALUE!</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id2309201517385358" role="tablecontent" localize="false" xml-lang="en-US">20</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id2309201517391077" role="tablecontent" localize="false" xml-lang="en-US">21</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id2309201518443714" role="tablehead" localize="false" xml-lang="en-US">8</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id2309201517382160" role="tablecontent" localize="false" xml-lang="en-US">5</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id2309201517385765" role="tablecontent" localize="false" xml-lang="en-US">7</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id2309201517391385" role="tablecontent" localize="false" xml-lang="en-US">8</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id2309201518444120" role="tablehead" localize="false" xml-lang="en-US">9</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id2309201517382451" role="tablecontent" localize="false" xml-lang="en-US">14</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id2309201517390082" role="tablecontent" localize="false" xml-lang="en-US">0</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id2309201517391680" role="tablecontent" localize="false" xml-lang="en-US">5</paragraph> + </tablecell> + </tablerow> +</table> + +<paragraph id="par_id230920152006414" role="paragraph" xml-lang="en-US"><item type="input">=AGGREGATE(4;2;A2:A9)</item><br/>Returns maximum value for the range A2:A9 = 34, whereas <item type="input">=MAX(A2:A9)</item> returns the error Err:511.</paragraph> +<paragraph id="par_id2309201520064180" role="paragraph" xml-lang="en-US"><item type="input">=AGGREGATE(9;5;A5:C5)</item><br/>Returns sum for the range A5:C5 = 29, even if some of the columns are hidden.</paragraph> +<paragraph id="par_id2309201520064118" role="paragraph" xml-lang="en-US"><item type="input">=AGGREGATE(9;5;B2:B9)</item><br/>Returns sum of the column B = 115. If any row is hidden, the function omit its value, for example if the 7th row is hidden, the function returns 95.</paragraph> +<paragraph id="par_id196152404026557" role="paragraph" xml-lang="en-US">If you need to apply the function with a 3D range, this example shows how to do it.</paragraph> +<paragraph id="par_id2309201520180167" role="paragraph" xml-lang="en-US"><item type="input">=AGGREGATE(13;3;Sheet1.B2:B9:Sheet3.B2:B9)</item><br/>The function returns mode of the values of second columns through sheets 1:3 (that have the same data) = 8.</paragraph> +<paragraph id="par_id2309201520395365" role="paragraph" xml-lang="en-US">You can use reference to a cell or a range for every argument in the formula. The following example shows how it works. Besides, it shows that you can use column labels to specify an array.</paragraph> +<paragraph id="par_id2309201520395380" role="paragraph" xml-lang="en-US"><item type="input">=AGGREGATE(E3;E5;'ColumnOne')</item><br/>If E3 = 13 and E5 = 5, the function returns mode of the first column = 10.</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectiontechinfo"/> +<embed href="text/scalc/00/avail_release.xhp#4.4"/> +<embed href="text/scalc/01/common_func.xhp#notODFF"/> +<paragraph role="paragraph" id="par_id341640873986703" localize="false"><literal>COM.MICROSOFT.AGGREGATE</literal></paragraph> +<section id="relatedtopics"> +<paragraph id="par_id241712879431120" role="paragraph" xml-lang="en-US"><link href="text/scalc/01/04060184.xhp#average">AVERAGE</link>, <link href="text/scalc/01/04060181.xhp#count">COUNT</link>, <link href="text/scalc/01/04060181.xhp#counta">COUNTA</link>, <link href="text/scalc/01/04060184.xhp#max">MAX</link>, <link href="text/scalc/01/04060184.xhp#min">MIN</link>, <link href="text/scalc/01/04060106.xhp#Section26">PRODUCT</link>, <link href="text/scalc/01/04060185.xhp#stdevdots">STDEV.S</link>, <link href="text/scalc/01/04060185.xhp#stdevdotp">STDEV.P</link>, <link href="text/scalc/01/04060106.xhp#Section16">SUM</link>, <link href="text/scalc/01/04060185.xhp#vardots">VAR.S</link>, <link href="text/scalc/01/04060185.xhp#vardotp">VAR.P</link>, <link href="text/scalc/01/04060184.xhp#median">MEDIAN</link>, <link href="text/scalc/01/04060184.xhp#modedotsngl">MODE.SNGL</link>, <link href="text/scalc/01/04060183.xhp#large">LARGE</link>, <link href="text/scalc/01/04060183.xhp#small">SMALL</link>, <link href="text/scalc/01/04060184.xhp#percentileinc">PERCENTILE.INC</link> , <link href="text/scalc/01/04060184.xhp#quartileinc">QUARTILE.INC</link>, <link href="text/scalc/01/04060184.xhp#percentileexc">PERCENTILE.EXC</link>, <link href="text/scalc/01/04060184.xhp#quartileexc">QUARTILE.EXC</link></paragraph> +<paragraph id="par_id125062615028497" role="paragraph" xml-lang="en-US"><link href="text/shared/optionen/01060500.xhp#hd_id3156199">Automatically find column and row labels</link></paragraph> +</section> +</body> + +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/func_arabic.xhp b/helpcontent2/source/text/scalc/01/func_arabic.xhp new file mode 100644 index 000000000..b827428e8 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/func_arabic.xhp @@ -0,0 +1,42 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> +<!-- +* This file is part of the LibreOffice project. +* +* This Source Code Form is subject to the terms of the Mozilla Public +* License, v. 2.0. If a copy of the MPL was not distributed with this +* file, You can obtain one at http://mozilla.org/MPL/2.0/. +* +--> + +<meta> + <topic id="calcfuncarabic" indexer="include" status="PUBLISH"> + <title id="tit" xml-lang="en-US">ARABIC Function</title> + <filename>/text/scalc/01/func_arabic.xhp</filename> + </topic> +</meta> +<body> + <section id="func_arabic"> + <bookmark id="bm_id61542230672099" xml-lang="en-US" branch="hid/SC_HID_FUNC_ARABISCH" localize="false"/> + <bookmark xml-lang="en-US" branch="index" id="bm_id831542233029549"> + <bookmark_value>ARABIC function</bookmark_value> + <bookmark_value>text functions;convert roman numbers</bookmark_value> + </bookmark> + <h1 id="hd_id881628776094597"><variable id="Arabic_h1"><link href="text/scalc/01/func_arabic.xhp" name="function ARABIC">ARABIC</link></variable></h1> + <paragraph id="par_id541542230672101" role="paragraph"><variable id="func_arabic_desc"><ahelp hid=".">Returns the numeric value corresponding to a Roman number expressed as text.</ahelp></variable></paragraph> + </section> + <note id="par_id151634221012221">The largest Roman number that can be converted is MMMCMXCIX (or one of its simplified versions), which is equivalent to 3999.</note> + <embed href="text/scalc/01/ful_func.xhp#func_head_syntax"/> + <paragraph role="paragraph" id="par_id701542231253817"><input>ARABIC(Text)</input></paragraph> + <paragraph role="paragraph" id="par_id621542232197446"><emph>Text</emph>: text representing a Roman number.</paragraph> + <embed href="text/scalc/01/ful_func.xhp#func_head_example"/> + <paragraph role="paragraph" id="par_id451628776707264"><input>=ARABIC("MXIV")</input> returns the numeric value 1014.</paragraph> + <paragraph role="paragraph" id="par_id101628778036375"><input>=ARABIC("MMII")</input> returns the numeric value 2002.</paragraph> + <paragraph role="paragraph" id="par_id101628778036134"><input>=ARABIC("")</input> returns 0.</paragraph> + + <section id="relatedtopics"> + <embed href="text/scalc/01/func_roman.xhp#Roman_h1"/> + <paragraph role="paragraph" id="par_id81634670394769" localize="false"><embedvar href="text/scalc/01/04060110.xhp#head_text"/></paragraph> + </section> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/func_asc.xhp b/helpcontent2/source/text/scalc/01/func_asc.xhp new file mode 100644 index 000000000..c828efb66 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/func_asc.xhp @@ -0,0 +1,42 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> +<!-- +* This file is part of the LibreOffice project. +* +* This Source Code Form is subject to the terms of the Mozilla Public +* License, v. 2.0. If a copy of the MPL was not distributed with this +* file, You can obtain one at http://mozilla.org/MPL/2.0/. +* +--> + +<meta> + <topic id="calcfuncasc" indexer="include" status="PUBLISH"> + <title id="tit" xml-lang="en-US">ASC Function</title> + <filename>/text/scalc/01/func_asc.xhp</filename> + </topic> +</meta> +<body> + <section id="func_asc"> + <bookmark id="bm_id61542230672099" xml-lang="en-US" branch="hid/SC_HID_FUNC_ASC" localize="false"/> + <bookmark xml-lang="en-US" branch="index" id="bm_id831542233029549"> + <bookmark_value>ASC function</bookmark_value> + <bookmark_value>text functions;katakana characters</bookmark_value> + </bookmark> + <h1 id="hd_id881628776094597"><variable id="Asc_h1"><link href="text/scalc/01/func_asc.xhp" name="function ASC">ASC</link></variable></h1> + <paragraph id="par_id541542230672101" role="paragraph"><variable id="func_asc_desc"><ahelp hid=".">Converts double-byte (full-width) characters to single-byte (half-width) ASCII and katakana characters.</ahelp></variable></paragraph> + </section> + <note id="par_id151634221012221">See <link href="https://wiki.documentfoundation.org/Calc/Features/JIS_and_ASC_functions" name="wiki.documentfoundation.org Calc/Features/JIS and ASC functions">https://wiki.documentfoundation.org/Calc/Features/JIS_and_ASC_functions</link> for a conversion table.</note> + <embed href="text/scalc/01/ful_func.xhp#func_head_syntax"/> + <paragraph role="paragraph" id="par_id701542231253817"><input>ASC(Text)</input></paragraph> + <paragraph role="paragraph" id="par_id621542232197446"><emph>Text</emph>: the text string that contains characters to be converted.</paragraph> + <note id="par_id481637763523789">Applying the ASC function to a string composed of single-byte characters will return the input string without any modifications.</note> + <embed href="text/scalc/01/ful_func.xhp#func_head_example"/> + <paragraph role="paragraph" id="par_id451628776707264"><input>=ASC("LibreOffice")</input> returns the string "LibreOffice". No modifications were made because all characters are single-byte characters.</paragraph> + <paragraph role="paragraph" id="par_id101628778036375"><input>=ASC("ライト")</input> returns the string "ライト", which is composed of single-byte characters.</paragraph> + + <section id="relatedtopics"> + <embed href="text/scalc/01/func_jis.xhp#Jis_h1"/> + <embed href="text/scalc/01/04060110.xhp#head_text"/> + </section> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/func_averageif.xhp b/helpcontent2/source/text/scalc/01/func_averageif.xhp new file mode 100644 index 000000000..5d41712cc --- /dev/null +++ b/helpcontent2/source/text/scalc/01/func_averageif.xhp @@ -0,0 +1,84 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * +--> + +<meta> + <topic id="textscalc01func_averageifxml"> + <title id="tit" xml-lang="en-US">AVERAGEIF function</title> + <filename>/text/scalc/01/func_averageif.xhp</filename> + </topic> +</meta> + +<body> +<section id="averageif_function"> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_AVERAGEIF" id="bm_id19444137534261" localize="false"/> +<bookmark xml-lang="en-US" branch="index" id="bm_id237812197829662"> + <bookmark_value>AVERAGEIF function</bookmark_value> + <bookmark_value>arithmetic mean;satisfying condition</bookmark_value> +</bookmark> +<h2 id="hd_id16852304621982"><variable id="averageif_head"><link href="text/scalc/01/func_averageif.xhp">AVERAGEIF</link></variable> function</h2> +<paragraph id="par_id7281266615152" role="paragraph" xml-lang="en-US"><ahelp hid="."><variable id="averageif_des">Returns the arithmetic mean of all cells in a range that satisfy a given condition. The AVERAGEIF function sums up all the results that match the logical test and divides this sum by the quantity of selected values.</variable></ahelp></paragraph> +</section> +<embed href="text/scalc/00/avail_release.xhp#4.0"/> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id200801176228491" role="code" xml-lang="en-US">AVERAGEIF(Range; Criterion [; Average_Range ])</paragraph> +<paragraph id="par_id15226321619829" role="paragraph" xml-lang="en-US"><emph>Range</emph> – required argument. An array, a name of named range or a label of a column or a row containing numbers for averaging or numbers or text for the condition.</paragraph> +<embed href="text/scalc/01/ex_data_stat_func.xhp#criterion"/> +<embed href="text/shared/00/00000001.xhp#regex"/> +<paragraph id="par_id174711913219765" role="paragraph" xml-lang="en-US"><emph>Average_Range</emph> – optional. It is a range of values for calculating the mean.</paragraph> +<note id="par_id45123108916423">If the <emph>Average_Range</emph> is not specified, <emph>Range</emph> is used for both, the calculation of the mean and the search according to the condition. If <emph>Average_Range</emph> is specified, the <emph>Range</emph> is used only for the condition test, while <emph>Average_Range</emph> is used for the average calculation.</note> +<embed href="text/scalc/01/ODFF.xhp#odff"/> +<warning id="par_id278275053653">If a cell in a range of values for calculating the mean is empty or contains text, function AVERAGEIF ignores this cell.<br/> +If the whole range is empty, contains only text or all values of the range do not satisfy the condition (or any combination of those), the function returns the #DIV/0! error. </warning> +<embed href="text/scalc/01/ex_data_stat_func.xhp#ex_func_average"/> +<h4 id="hd_id229513120314273">Simple usage</h4> +<paragraph id="par_id2509201519225446" role="paragraph" xml-lang="en-US"><item type="input">=AVERAGEIF(B2:B6;"<35")</item></paragraph> +<paragraph id="par_id11322891219251" role="paragraph" xml-lang="en-US">Calculates the average for values of the range B2:B6 that are less than 35. Returns 19, because the second row does not participate in the calculation.</paragraph> +<paragraph id="par_id250920151922590" role="paragraph" xml-lang="en-US"><item type="input">=AVERAGEIF(B2:B6;"<"&MAX(B2:B6))</item></paragraph> +<paragraph id="par_id3813266131474" role="paragraph" xml-lang="en-US">Calculates the average for values of the same range that are less than the maximum value of this range. Returns 19, because the largest value (the second row) does not participate in the calculation.</paragraph> +<paragraph id="par_id2509201519230832" role="paragraph" xml-lang="en-US"><item type="input">=AVERAGEIF(B2:B6;">"&SMALL(B2:B6;1))</item></paragraph> +<paragraph id="par_id243522732832394" role="paragraph" xml-lang="en-US">Calculates the average for values of the same range that are greater than the first smallest value of this range. Returns 25, because the first smallest value (the fourth row) does not participate in the calculation.</paragraph> +<h4 id="hd_id2101254257133">Using the Average_Range</h4> +<paragraph id="par_id2509201519315584" role="paragraph" xml-lang="en-US"><item type="input">=AVERAGEIF(B2:B6;"<35";C2:C6)</item></paragraph> +<paragraph id="par_id148222637631350" role="paragraph" xml-lang="en-US">The function searches what values are less than 35 in the B2:B6 range, and calculates the average of corresponding values from the C2:C6 range. Returns 145, because the second row does not participate in the calculation. </paragraph> +<paragraph id="par_id2509201519315535" role="paragraph" xml-lang="en-US"><item type="input">=AVERAGEIF(B2:B6;">"&MIN(B2:B6);C2:C6)</item></paragraph> +<paragraph id="par_id2412836525208" role="paragraph" xml-lang="en-US">The function searches what values from the range B2:B6 are greater than the least value in the B2:B6 range, and calculates the average of corresponding values from the C2:C6 range. Returns 113.3, because the fourth row (where there is the least value in the range B2:B6) does not participate in the calculation.</paragraph> +<paragraph id="par_id2509201519315547" role="paragraph" xml-lang="en-US"><item type="input">=AVERAGEIF(B2:B6;"<"&LARGE(B2:B6;2);C2:C6)</item></paragraph> +<paragraph id="par_id173931101529497" role="paragraph" xml-lang="en-US">The function searches what values from the range B2:B6 are less than the second large value in the B2:B6 range, and calculates the average of corresponding values from the C2:C6 range. Returns 180, because only the fourth row participates in the calculation. </paragraph> +<h4 id="hd_id30054471316969">Using regular expressions</h4> +<paragraph id="par_id2509201519360514" role="paragraph" xml-lang="en-US"><item type="input">=AVERAGEIF(A2:A6;"pen";B2:B6)</item></paragraph> +<paragraph id="par_id14714860719948" role="paragraph" xml-lang="en-US">The function searches what cells from the range A2:A6 contain only the word “pen”, and calculates the average of corresponding values from the B2:B6 range. Returns 35, because only the second row participates in the calculation. The search is performed in the A2:A6 range, but the values are returned from the B2:B6 range.</paragraph> +<paragraph id="par_id250920151936096" role="paragraph" xml-lang="en-US"><item type="input">=AVERAGEIF(A2:A6;"pen.*";B2:B6)</item></paragraph> +<paragraph id="par_id26959239098104" role="paragraph" xml-lang="en-US">The function searches what cells from the range A2:A6 begin with “pen” ending with any quantity of other characters, and calculates the average of corresponding values from the B2:B6 range. Returns 27.5, because now also “pencil” satisfies the condition, and both, first and second rows participate in the calculation. </paragraph> +<paragraph id="par_id2509201519361352" role="paragraph" xml-lang="en-US"><item type="input">=AVERAGEIF(A2:A6;".*book.*";B2:B6)</item></paragraph> +<paragraph id="par_id227041304619482" role="paragraph" xml-lang="en-US">The function searches what cells from the range A2:A6 contain “book” starting and ending with any quantity of other characters, and calculates the average of corresponding values from the B2:B6 range. Returns 18.5, because only third and fourth rows participate in the calculation.</paragraph> +<h4 id="hd_id251309885188">Reference to a cell as a criterion</h4> +<paragraph id="par_id177972099720424" role="paragraph" xml-lang="en-US">If you need to change a criterion easily, you may want to specify it in a separate cell and use a reference to this cell in the condition of AVERAGEIF function. </paragraph> +<paragraph id="par_id134941261230060" role="paragraph" xml-lang="en-US"><item type="input">=AVERAGEIF(A2:A6;".*"&E2&".*";B2:B6)</item></paragraph> +<paragraph id="par_id172572288310247" role="paragraph" xml-lang="en-US">The function searches what cells from the range A2:A6 contain a combination of characters specified in E2 starting and ending with any quantity of other characters, and calculates the average of corresponding values from the B2:B6 range. If E2 = book, the function returns 18.5.</paragraph> +<paragraph id="par_id316901523627285" role="paragraph" xml-lang="en-US"><item type="input">=AVERAGEIF(B2:B6;"<"&E2;C2:C6)</item></paragraph> +<paragraph id="par_id302181300528607" role="paragraph" xml-lang="en-US">The function searches what cells from the range B2:B6 are less than the value specified in E2, and calculates the average of corresponding values from the C2:C6 range. If E2 = 35, the function returns 145.</paragraph> +<section id="relatedtopics"> + <paragraph id="par_id11921178730928" role="paragraph" xml-lang="en-US" localize="false"> + <embedvar href="text/scalc/01/04060184.xhp#average_head"/>, + <embedvar href="text/scalc/01/04060184.xhp#averagea_head"/>, + <embedvar href="text/scalc/01/04060184.xhp#avedev_head"/> + </paragraph> + <paragraph id="par_id11931178730928" role="paragraph" xml-lang="en-US" localize="false"> + <embedvar href="text/scalc/01/func_countifs.xhp#countifs_head"/>, + <embedvar href="text/scalc/01/func_minifs.xhp#minifs_head"/>, + <embedvar href="text/scalc/01/func_maxifs.xhp#maxifs_head"/>, + <embedvar href="text/scalc/01/func_averageifs.xhp#averageifs_head"/>, + <embedvar href="text/scalc/01/func_sumifs.xhp#sumifs_head"/> + </paragraph> +<paragraph id="par_id251321802714497" role="paragraph" localize="false" xml-lang="en-US"><embedvar href="text/shared/01/02100001.xhp#02100001"/></paragraph> +</section> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/func_averageifs.xhp b/helpcontent2/source/text/scalc/01/func_averageifs.xhp new file mode 100644 index 000000000..e94dc7bea --- /dev/null +++ b/helpcontent2/source/text/scalc/01/func_averageifs.xhp @@ -0,0 +1,74 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * +--> + +<meta> + <topic id="textscalc01func_averageifsxml"> + <title id="tit" xml-lang="en-US">AVERAGEIFS function</title> + <filename>/text/scalc/01/func_averageifs.xhp</filename> + </topic> +</meta> + +<body> +<section id="averageifs_function"> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_AVERAGEIFS" id="bm_id536295362953629" localize="false"/> +<bookmark xml-lang="en-US" branch="index" id="bm_id536715367153671"> + <bookmark_value>AVERAGEIFS function</bookmark_value> + <bookmark_value>arithmetic mean;satisfying conditions</bookmark_value> +</bookmark> +<h2 id="hd_id537445374453744"><variable id="averageifs_head"><link href="text/scalc/01/func_averageifs.xhp">AVERAGEIFS</link></variable> function</h2> +<paragraph id="par_id538405384053840" role="paragraph" xml-lang="en-US"><ahelp hid="."><variable id="averageifs_des">Returns the arithmetic mean of all cells in a range that satisfy given multiple criteria. The AVERAGEIFS function sums up all the results that match the logical tests and divides this sum by the quantity of selected values.</variable></ahelp></paragraph> +</section> +<embed href="text/scalc/00/avail_release.xhp#4.0"/> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id21050267713178" role="code" xml-lang="en-US">AVERAGEIFS(<embedvar href="text/scalc/01/ex_data_stat_func.xhp#args" markup="ignore"/>)</paragraph> +<paragraph id="par_id165832700711773" role="paragraph" xml-lang="en-US"><emph>Func_range</emph> – required argument. It is a range of cells, a name of a named range or a label of a column or a row containing values for calculating the mean.</paragraph> + +<embed href="text/scalc/01/ex_data_stat_func.xhp#par00"/> +<embed href="text/shared/00/00000001.xhp#regex"/> +<embed href="text/scalc/01/ex_data_stat_func.xhp#warning01"/> +<embed href="text/scalc/01/ex_data_stat_func.xhp#note01"/> +<embed href="text/scalc/01/ex_data_stat_func.xhp#par01"/> + +<embed href="text/scalc/01/ODFF.xhp#odff"/> +<embed href="text/scalc/01/ex_data_stat_func.xhp#ex_func_average"/> +<h4 id="hd_id20733192524041">Simple usage</h4> +<paragraph id="par_id24004653627203" role="paragraph" xml-lang="en-US"><item type="input">=AVERAGEIFS(B2:B6;B2:B6;">=20")</item></paragraph> +<paragraph id="par_id30201168686268" role="paragraph" xml-lang="en-US">Calculates the average for values of the range B2:B6 that are greater than or equal to 20. Returns 25, because the fifth row does not meet the criterion.</paragraph> +<paragraph id="par_id30279247419921" role="paragraph" xml-lang="en-US"><item type="input">=AVERAGEIFS(C2:C6;B2:B6;">=20";C2:C6;">70")</item></paragraph> +<paragraph id="par_id2930764965983" role="paragraph" xml-lang="en-US">Calculates the average for values of the range C2:C6 that are greater than 70 and correspond to cells of B2:B6 with values greater than or equal to 20. Returns 137.5, because the second and fifth rows do not meet at least one criterion.</paragraph> +<h4 id="hd_id317532515726820">Using regular expressions and nested functions</h4> +<paragraph id="par_id457966021670" role="paragraph" xml-lang="en-US"><item type="input">=AVERAGEIFS(C2:C6;B2:B6;">"&MIN(B2:B6);B2:B6;"<"&MAX(B2:B6))</item></paragraph> +<paragraph id="par_id66091035229950" role="paragraph" xml-lang="en-US">Calculates the average for values of the range C2:C6 that correspond to all values of the range B2:B6 except its minimum and maximum. Returns 127.5, because the third and fifth rows do not meet at least one criterion.</paragraph> +<paragraph id="par_id303162761931870" role="paragraph" xml-lang="en-US"><item type="input">=AVERAGEIFS(C2:C6;A2:A6;"pen.*";B2:B6;"<"&MAX(B2:B6))</item></paragraph> +<paragraph id="par_id40031348913642" role="paragraph" xml-lang="en-US">Calculates the average for values of the range C2:C6 that correspond to all cells of the A2:A6 range starting with "pen" and to all cells of the B2:B6 range except its maximum. Returns 65, because only second row meets all criteria.</paragraph> +<h4 id="hd_id31201205191857">Reference to a cell as a criterion</h4> +<paragraph id="par_id316794795433" role="paragraph" xml-lang="en-US">If you need to change a criterion easily, you may want to specify it in a separate cell and use a reference to this cell in the condition of AVERAGEIFS function. For example, the above function can be rewritten as follows:</paragraph> +<paragraph id="par_id67531072426731" role="paragraph" xml-lang="en-US"><item type="input">=AVERAGEIFS(C2:C6;A2:A6;E2&".*";B2:B6;"<"&MAX(B2:B6))</item></paragraph> +<paragraph id="par_id65612244926745" role="paragraph" xml-lang="en-US">If E2 = pen, the function returns 65, because the link to the cell is substituted with its content.</paragraph> +<embed href="text/scalc/06/calcsamplefiles.xhp#func_ifs"/> +<section id="relatedtopics"> + <paragraph id="par_id11921178730928" role="paragraph" xml-lang="en-US" localize="false"> + <embedvar href="text/scalc/01/04060184.xhp#average_head"/>, + <embedvar href="text/scalc/01/04060184.xhp#averagea_head"/>, + <embedvar href="text/scalc/01/04060184.xhp#avedev_head"/>, + <embedvar href="text/scalc/01/func_averageif.xhp#averageif_head"/> + </paragraph> + <paragraph id="par_id11931178730928" role="paragraph" xml-lang="en-US" localize="false"> + <embedvar href="text/scalc/01/func_countifs.xhp#countifs_head"/>, + <embedvar href="text/scalc/01/func_minifs.xhp#minifs_head"/>, + <embedvar href="text/scalc/01/func_maxifs.xhp#maxifs_head"/>, + <embedvar href="text/scalc/01/func_averageifs.xhp#averageifs_head"/>, + <embedvar href="text/scalc/01/func_sumifs.xhp#sumifs_head"/> + </paragraph> +<paragraph id="par_id20741445030307" role="paragraph" localize="false" xml-lang="en-US"><embedvar href="text/shared/01/02100001.xhp#02100001"/></paragraph> +</section> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/func_ceiling.xhp b/helpcontent2/source/text/scalc/01/func_ceiling.xhp new file mode 100644 index 000000000..e671f6093 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/func_ceiling.xhp @@ -0,0 +1,150 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> + <!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + --> + <meta> + <topic id="scalcceilingfunction" indexer="include" status="PUBLISH"> + <title id="tit" xml-lang="en-US">Ceiling functions</title> + <filename>/text/scalc/01/func_ceiling.xhp</filename> + </topic> + </meta> + <body> + <h1 id="hd_id971586216771519">Ceiling functions</h1> + <section id="ceiling"> +<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"/> + <h2 id="hd_id3152518"><variable id="CEILINGh1"><link href="text/scalc/01/func_ceiling.xhp#ceiling" name="CEILING">CEILING</link></variable></h2> + <paragraph id="par_id3153422" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_OBERGRENZE">Rounds a number to the nearest multiple of a significance value.</ahelp></paragraph> + <paragraph role="paragraph" id="par_id601586207136514">For a positive number and a positive significance value, the function rounds up (away from zero). For a negative number and a negative significance value, the direction of rounding is determined by the value of a mode parameter. The function returns an error if the number and significance values have opposite signs.</paragraph> + <warning id="par_id3163792">If the spreadsheet is exported to Microsoft Excel, the CEILING function is exported as the equivalent CEILING.MATH function that has existed since Excel 2013. If you plan to use the spreadsheet with earlier Excel versions, use either CEILING.PRECISE that has existed since Excel 2010, or CEILING.XCL that is exported as the CEILING function compatible with all Excel versions.</warning> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph id="par_id3153454" role="code" xml-lang="en-US">CEILING(Number [; Significance [; Mode]])</paragraph> + <section id="argnumber"> + <paragraph id="par_id3153467" role="paragraph" xml-lang="en-US"><emph>Number</emph> is the number that is to be rounded, or a reference to a cell containing the number.</paragraph> + </section> + <paragraph id="par_id3155000" role="paragraph" xml-lang="en-US"><emph>Significance</emph> (optional) is the value, or a reference to a cell containing the value, to whose multiple <emph>Number</emph> is to be rounded. It defaults to +1 or -1 depending on the sign of <emph>Number</emph>.</paragraph> + <paragraph id="par_id3155020" role="paragraph" xml-lang="en-US"><emph>Mode</emph> (optional) is a number, or a reference to a cell containing a number. The function only uses <emph>Mode</emph> if both <emph>Number</emph> and <emph>Significance</emph> are negative. Then if <emph>Mode</emph> is given and not equal to zero, numbers are rounded down (away from zero); if <emph>Mode</emph> is equal to zero or not given, negative numbers are rounded up (towards zero).</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph role="paragraph" id="par_id281586208138400"><input>=CEILING(3.45)</input> returns 4.</paragraph> + <paragraph role="paragraph" id="par_id921586208142416"><input>=CEILING(3.45; 3)</input> returns 6.</paragraph> + <paragraph role="paragraph" id="par_id921586208146984"><input>=CEILING(-1.234)</input> returns -1.</paragraph> + <paragraph role="paragraph" id="par_id491586208152183"><input>=CEILING(-45.67; -2; 0)</input> returns -44.</paragraph> + <paragraph role="paragraph" id="par_id291586208158119"><input>=CEILING(-45.67; -2; 1)</input> returns -46.</paragraph> + <comment>see also FLOOR, EVEN, ODD, MROUND, INT, TRUNC, ROUND, ROUNDDOWN, ROUNDUP</comment> + </section> + + <section id="ceilingprecise"> +<bookmark xml-lang="en-US" branch="index" id="bm_id2952518"> +<bookmark_value>CEILING.PRECISE 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_CEIL_MS" id="bm_id2952530" localize="false"/> + <h2 id="hd_id2952518"><variable id="CEILING.PRECISEh1"><link href="text/scalc/01/func_ceiling.xhp#ceilingprecise" name="CEILING.PRECISE">CEILING.PRECISE</link></variable></h2> + <paragraph id="par_id2953422" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_CEIL_MS">Rounds a number up to the nearest multiple of a significance value.</ahelp></paragraph> + <paragraph role="paragraph" id="par_id151586642494759">For a positive number the function rounds up (away from zero). For a negative number, the function rounds up (towards zero). The sign of the significance value is ignored.</paragraph> + <note id="par_id631586642933797">This function calculates identical results to the <link href="text/scalc/01/func_ceiling.xhp#isoceiling" name="iso ceiling">ISO.CEILING</link> function.</note> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph id="par_id2953454" role="code" xml-lang="en-US">CEILING.PRECISE(Number [; Significance])</paragraph> + <embed href="text/scalc/01/func_ceiling.xhp#argnumber"/> + <paragraph id="par_id2955000" role="paragraph" xml-lang="en-US"><emph>Significance</emph> (optional) is the value, or a reference to a cell containing the value, to whose multiple <emph>Number</emph> is to be rounded. It defaults to 1.</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph role="paragraph" id="par_id201586213398634"><input>=CEILING.PRECISE(3.45)</input> returns 4.</paragraph> + <paragraph role="paragraph" id="par_id651586213406243"><input>=CEILING.PRECISE(-45.67; 2)</input> returns -44.</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectiontechinfo"/> + <embed href="text/scalc/00/avail_release.xhp#4.3"/> + <embed href="text/scalc/01/common_func.xhp#notODFF"/> + <paragraph role="paragraph" id="par_id341640373986703" localize="false"><literal>COM.MICROSOFT.CEILING.PRECISE</literal></paragraph> + <comment>see also FLOOR, EVEN, ODD, MROUND, INT, TRUNC, ROUND, ROUNDDOWN, ROUNDUP</comment> + </section> + + <section id="ceilingmath"> +<bookmark xml-lang="en-US" branch="index" id="bm_id911516997198644"> +<bookmark_value>CEILING.MATH function</bookmark_value> +</bookmark> + <bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_CEIL_MATH" id="bm_id511516997249645" localize="false"/> + <h2 id="hd_id91516997330445"><variable id="CEILING.MATHh1"><link href="text/scalc/01/func_ceiling.xhp#ceilingmath" name="CEILING.MATH">CEILING.MATH</link></variable></h2> + <paragraph role="paragraph" id="par_id81516997342088" xml-lang="en-US"><ahelp hid="HID_FUNC_CEIL_MATH">Rounds a number to the nearest multiple of a significance value.</ahelp></paragraph> + <paragraph role="paragraph" id="par_id911586642319078">For a positive number the function rounds up (away from zero). For a negative number, the direction of rounding is determined by the value of a mode parameter. The sign of the significance value is ignored.</paragraph> + <warning id="par_id291516998575663">This function exists for interoperability with Microsoft Excel 2013 or newer.</warning> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph role="code" id="par_id841516997669932" xml-lang="en-US">CEILING.MATH(Number [; Significance [; Mode]])</paragraph> + <embed href="text/scalc/01/func_ceiling.xhp#argnumber"/> + <paragraph role="paragraph" id="par_id491516997725772" xml-lang="en-US"><emph>Significance</emph> (optional) is the value, or a reference to a cell containing the value, to whose multiple <emph>Number</emph> is to be rounded. It defaults to 1.</paragraph> + <paragraph role="paragraph" id="par_id451516997742909" xml-lang="en-US"><emph>Mode</emph> (optional) is a number, or a reference to a cell containing a number. If <emph>Mode</emph> is given and not equal to zero, a negative <emph>Number</emph> is rounded down (away from zero). If <emph>Mode</emph> is equal to zero or is not given, a negative <emph>Number</emph> is rounded up (towards zero).</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph role="paragraph" id="par_id331586208590009"><input>=CEILING.MATH(3.45)</input> returns 4.</paragraph> + <paragraph role="paragraph" id="par_id481586208595809"><input>=CEILING.MATH(3.45; -3)</input> returns 6.</paragraph> + <paragraph role="paragraph" id="par_id641586208600665"><input>=CEILING.MATH(-1.234)</input> returns -1.</paragraph> + <paragraph role="paragraph" id="par_id151586208604536"><input>=CEILING.MATH(-45.67; -2; 0)</input> returns -44.</paragraph> + <paragraph role="paragraph" id="par_id971586208611345"><input>=CEILING.MATH(-45.67; +2; 1)</input> returns -46.</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectiontechinfo"/> + <embed href="text/scalc/00/avail_release.xhp#5.0"/> + <embed href="text/scalc/01/common_func.xhp#notODFF"/> + <paragraph role="paragraph" id="par_id341646873986703" localize="false"><literal>COM.MICROSOFT.CEILING.MATH</literal></paragraph> + </section> + <section id="ceilingxcl"> +<bookmark xml-lang="en-US" branch="index" id="bm_id921516998608939"> +<bookmark_value>CEILING.XCL function</bookmark_value> +</bookmark> + <bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_CEIL_MS" id="bm_id221516998652517" localize="false"/> + <h2 id="hd_id411516998838823"><variable id="CEILING.XCLh1"><link href="text/scalc/01/func_ceiling.xhp#ceilingxcl" name="CEILING.XCL">CEILING.XCL</link></variable></h2> + <paragraph role="paragraph" id="par_id811516998845826" xml-lang="en-US"><ahelp hid="HID_FUNC_CEIL_MS">Rounds a number to the nearest multiple of a significance value.</ahelp></paragraph> + <paragraph role="paragraph" id="par_id361586213828675">For a positive number and a positive significance value, the function rounds up (away from zero). For a negative number and a positive significance value, the function rounds up (towards zero). For a negative number and a negative significance value, the function rounds down (away from zero). The function returns an error if the number is positive and the significance value is negative.</paragraph> + <warning id="par_id881586213934118">This function exists for interoperability with Microsoft Excel 2007 or older. If a Calc spreadsheet is exported to Microsoft Excel, references to Calc’s CEILING.XCL function are exported as references to Excel’s CEILING function, which is compatible with all Excel versions. If a Microsoft Excel spreadsheet is imported into Calc, references to Excel’s CEILING function are imported as references to Calc’s CEILING.XCL function.</warning> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph role="code" id="par_id251516998856873" xml-lang="en-US">CEILING.XCL(Number; Significance)</paragraph> + <embed href="text/scalc/01/func_ceiling.xhp#argnumber"/> + <paragraph role="paragraph" id="par_id151516998882622" xml-lang="en-US"><emph>Significance</emph> is the value, or a reference to a cell containing the value, to whose multiple <emph>Number</emph> is to be rounded.</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph role="paragraph" id="par_id421586214128242"><input>=CEILING.XCL(3.45,2)</input> returns 4.</paragraph> + <paragraph role="paragraph" id="par_id651586214132234"><input>=CEILING.XCL(-45.67; 2)</input> returns -44.</paragraph> + <paragraph role="paragraph" id="par_id811586214136666"><input>=CEILING.XCL(-45.67; -2)</input> returns -46.</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectiontechinfo"/> + <embed href="text/scalc/00/avail_release.xhp#5.0"/> + <embed href="text/scalc/01/common_func.xhp#notODFF"/> + <paragraph role="paragraph" id="par_id341640873786703" localize="false"><literal>COM.MICROSOFT.CEILING</literal></paragraph> + </section> + <section id="isoceiling"> +<bookmark xml-lang="en-US" branch="index" id="bm_id8952518"> +<bookmark_value>ISO.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_CEIL_ISO" id="bm_id8952530" localize="false"/> + + <h2 id="hd_id8952518"><variable id="ISO.CEILINGh1"><link href="text/scalc/01/func_ceiling.xhp#isoceiling" name="ISO.CEILING">ISO.CEILING</link></variable></h2> + <paragraph id="par_id8953422" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_CEIL_ISO">Rounds a number up to the nearest multiple of a significance value.</ahelp></paragraph> + <paragraph role="paragraph" id="par_id101586214229587">For a positive number the function rounds up (away from zero). For a negative number, the function rounds up (towards zero). The sign of the significance value is ignored.</paragraph> + <note id="par_id821586214265060">This function calculates identical results to the <link href="text/scalc/01/func_ceiling.xhp#ceilingprecise" name="ceiling precise">CEILING.PRECISE</link> function.</note> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph id="par_id8953454" role="code" xml-lang="en-US">ISO.CEILING(Number [; Significance])</paragraph> + <embed href="text/scalc/01/func_ceiling.xhp#argnumber"/> + <paragraph id="par_id8955000" role="paragraph" xml-lang="en-US"><emph>Significance</emph> (optional) is the value, or a reference to a cell containing the value, to whose multiple <emph>Number</emph> is to be rounded. It defaults to 1.</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph role="paragraph" id="par_id801586214431463"><input>=ISO.CEILING(3.45)</input> returns 4.</paragraph> + <paragraph role="paragraph" id="par_id181586214438808"><input>=ISO.CEILING(-45.67; 2)</input> returns -44.</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectiontechinfo"/> + <embed href="text/scalc/00/avail_release.xhp#4.3"/> + <embed href="text/scalc/01/common_func.xhp#notODFF"/> + <paragraph role="paragraph" id="par_id341640873989703" localize="false"><literal>COM.MICROSOFT.ISO.CEILING</literal></paragraph> + <comment>see also FLOOR, EVEN, ODD, MROUND, INT, TRUNC, ROUND, ROUNDDOWN, ROUNDUP</comment> + </section> + <section id="relatedtopics"> + <embed href="text/scalc/01/func_floor.xhp#FLOORh1"/> + <embed href="text/scalc/01/func_floor.xhp#FLOOR.XCLh1"/> + <embed href="text/scalc/01/func_floor.xhp#FLOOR.PRECISEh1"/> + <embed href="text/scalc/01/func_floor.xhp#FLOOR.MATHh1"/> + </section> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/func_color.xhp b/helpcontent2/source/text/scalc/01/func_color.xhp new file mode 100644 index 000000000..26b6b6722 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/func_color.xhp @@ -0,0 +1,53 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . +--> + + <meta> + <topic id="textscalc01func_colorxml"> + <title id="tit" xml-lang="en-US">COLOR function</title> + <filename>/text/scalc/01/func_color.xhp</filename> + </topic> + </meta> + <body> + <section id="func_color"> + <bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_COLOR" id="bm_id1102201617042146" localize="false"/> + <bookmark xml-lang="en-US" branch="index" id="bm_id1102201617201921"> + <bookmark_value>colors;numerical values</bookmark_value> + <bookmark_value>colors;calculating in spreadsheets</bookmark_value> + <bookmark_value>COLOR function</bookmark_value> + </bookmark> + <h1 id="hd_id456845684568"><variable id="color_head"><link href="text/scalc/01/func_color.xhp">COLOR</link></variable></h1> + <paragraph id="par_id1102201617001848" role="paragraph" xml-lang="en-US"><ahelp hid=".">Return a numeric value calculated by a combination of three colors (red, green and blue) and the alpha channel, in the RGBA color system.</ahelp> The result depends on the color system used by your computer.</paragraph> + </section> + <embed href="text/scalc/01/ful_func.xhp#func_head_syntax"/> + <paragraph id="par_id27421466710275" role="code" xml-lang="en-US">COLOR(Red; Green; Blue [; Alpha])</paragraph> + <paragraph id="par_id242131304318587" role="paragraph" xml-lang="en-US"><emph>Red, Green and Blue</emph> – required arguments. The value for the red, green and blue components of the color. The values must be between 0 and 255. Zero means no color component and 255 means full color component.</paragraph> + <paragraph id="par_id242131304315587" role="paragraph" xml-lang="en-US"><emph>Alpha</emph> – optional argument. The value for the alpha channel or alpha composite. Alpha is a integer value between 0 and 255. The value of zero for alpha means the color is fully transparent, whereas a value of 255 in the alpha channel gives a fully opaque color.</paragraph> + <embed href="text/scalc/01/ful_func.xhp#func_head_example"/> + <paragraph id="par_id1102201617001888" role="paragraph" xml-lang="en-US"><item type="input">COLOR(255;255;255;1)</item> returns 33554431</paragraph> + <paragraph id="par_id1102201618185378" role="paragraph" xml-lang="en-US"><item type="input">COLOR(0;0;255;0)</item> returns 255 </paragraph> + <paragraph id="par_id1102201618185326" role="paragraph" xml-lang="en-US"><item type="input">COLOR(0;0;255;255)</item> returns 4278190335 </paragraph> + <paragraph id="par_id1102201618188326" role="paragraph" xml-lang="en-US"><item type="input">COLOR(0;0;400;0)</item> returns Err:502 (Invalid argument) because the blue value is greater than 255. + </paragraph> + <embed href="text/scalc/01/common_func.xhp#sectiontechinfo"/> + <embed href="text/scalc/00/avail_release.xhp#4.4"/> + <embed href="text/scalc/01/common_func.xhp#notODFF"/> + <paragraph role="paragraph" id="par_id311640873986703" localize="false"><literal>ORG.LIBREOFFICE.COLOR</literal></paragraph> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/func_concat.xhp b/helpcontent2/source/text/scalc/01/func_concat.xhp new file mode 100644 index 000000000..5063ac92a --- /dev/null +++ b/helpcontent2/source/text/scalc/01/func_concat.xhp @@ -0,0 +1,43 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> + <!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + --> + + <meta> + <topic id="functconcat" indexer="include" status="PUBLISH"> + <title id="tit" xml-lang="en-US">CONCAT function</title> + <filename>/text/scalc/01/func_concat.xhp</filename> + </topic> + </meta> + <body> + <section id="concat01"> + <bookmark id="bm_id941556226436779" xml-lang="en-US" branch="hid/SC_HID_FUNC_CONCAT_MS" localize="false"/> + <bookmark xml-lang="en-US" branch="index" id="bm_id741556228031712"> + <bookmark_value>CONCAT function</bookmark_value> + </bookmark> + <h2 id="hd_id471556226436779"><variable id="concatfunct"><link href="text/scalc/01/func_concat.xhp" name="concat">CONCAT</link></variable></h2> + <paragraph id="par_id891556226436781" role="paragraph" xml-lang="en-US"><variable id="concatfunction"><ahelp hid=".">Concatenates one or more strings</ahelp></variable></paragraph> + </section> + <paragraph role="paragraph" id="par_id701556226865876">CONCAT is an enhancement of CONCATENATE, as CONCAT also accepts ranges as arguments, like B2:E5, K:K or K:M.</paragraph> + <paragraph role="paragraph" id="par_id461556226873963">When ranges are used, the cells are traversed row by row (from top to bottom) to concatenate.</paragraph> + <embed href="text/scalc/01/ful_func.xhp#func_head_syntax"/> + <paragraph role="code" id="par_id911556226813412">CONCAT( <embedvar href="text/scalc/01/ful_func.xhp#string255_1" markup="keep"/> )</paragraph> + <embed href="text/scalc/01/ful_func.xhp#string255"/> + <embed href="text/scalc/01/ful_func.xhp#func_head_example"/> + <paragraph role="paragraph" id="par_id531556227248228"><input>=CONCAT("Hello ", A1:C3)</input> concatenates the string "Hello" with all strings in range <literal>A1:C3</literal>.</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectiontechinfo"/> + <embed href="text/scalc/00/avail_release.xhp#5.2"/> + <embed href="text/scalc/01/common_func.xhp#notODFF"/> + <paragraph role="paragraph" id="par_id341640873986703" localize="false"><literal>COM.MICROSOFT.CONCAT</literal></paragraph> + <section id="relatedtopics"> + <embed href="text/scalc/01/func_textjoin.xhp#textjoinfunct"/> + <paragraph role="paragraph" id="par_id781556244709752"><link href="text/scalc/01/04060110.xhp#concatenate" name="concatenate">CONCATENATE</link></paragraph> + </section> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/func_convert.xhp b/helpcontent2/source/text/scalc/01/func_convert.xhp new file mode 100644 index 000000000..c422ba5bd --- /dev/null +++ b/helpcontent2/source/text/scalc/01/func_convert.xhp @@ -0,0 +1,1744 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. +--> +<meta> + <topic id="textscalc01func_convertxml"> + <title id="tit" xml-lang="en-US">CONVERT function</title> + <filename>/text/scalc/01/func_convert.xhp</filename> + </topic> +</meta> +<body> +<section id="convert_function"> + <bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_CONVERT" id="bm_id3150773" localize="false"/> + <bookmark xml-lang="en-US" branch="index" id="bm_id3148446"> + <bookmark_value>CONVERT function</bookmark_value> + </bookmark> + <h2 id="hd_id9522389625800"> + <variable id="convert_head"> + <link href="text/scalc/01/func_convert.xhp">CONVERT</link> + </variable> function + </h2> + <paragraph xml-lang="en-US" id="par_id3154902" role="paragraph"> + <ahelp hid="HID_AAI_FUNC_CONVERT"><variable id="convert_desc">Converts a value from one unit of measurement to the corresponding value in another unit of measurement.</variable></ahelp> Enter the units of measurement directly as text in quotation marks or as a reference. The units of measurement specified through the arguments must match the supported unit symbols, which are case-sensitive. For example, the symbol for the unit "newton" is the uppercase "N".</paragraph> + <paragraph role="paragraph" id="par_id761620414839890">The measurement units recognized by <literal>CONVERT</literal> fall into 13 groups, which are listed <link href="text/scalc/01/func_convert.xhp#Unit_Groups" name="Unit_Groups_Section">below</link>. CONVERT will perform conversions between any two units within one group but reject any request to convert between units in different groups.</paragraph> + <paragraph role="paragraph" id="par_id861620428840333">You can also add binary and decimal prefixes to units of measurement that support them. The list of all prefixes and their corresponding multipliers are shown <link href="text/scalc/01/func_convert.xhp#Prefixes" name="Prefixes_Section">below</link>.</paragraph> +</section> + <warning id="par_id601621101375988">This function may not be compatible with other spreadsheet software.</warning> + +<embed href="text/scalc/01/ful_func.xhp#func_head_syntax"/> + <paragraph id="par_id23219159944266" role="paragraph"> + <input>CONVERT(Number; FromUnit; ToUnit)</input> + </paragraph> + <paragraph id="par_id3147522" role="paragraph"> + <emph>Number</emph> is the number to be converted. + </paragraph> + <paragraph id="par_id3154472" role="paragraph"> + <emph>FromUnit</emph> is the unit from which conversion is taking place. + </paragraph> + <paragraph id="par_id3153790" role="paragraph"> + <emph>ToUnit</emph> is the unit to which conversion is taking place. Both units must be of the same type. + </paragraph> + <warning id="par_id541620414925560">If <literal>FromUnit</literal> and <literal>ToUnit</literal> are not valid units from the same group, then <literal>CONVERT</literal> reports an invalid argument error (Err:502).</warning> + + <embed href="text/scalc/01/ful_func.xhp#func_head_example"/> + <paragraph xml-lang="en-US" id="par_id3156336" role="paragraph"> + <input>=CONVERT(-10; "C"; "F")</input></paragraph> + <paragraph role="paragraph" id="par_id951620413562988">Here the function converts -10 degrees Celsius to degrees Fahrenheit, returning the value 14. There is not a simple multiplicative relationship between temperature units, as different reference points are used. Hence, as in this case, an input negative number may be converted to a positive value.</paragraph> + <paragraph xml-lang="en-US" id="par_id3154834" role="paragraph"> + <input>=CONVERT(3.5; "mi"; "yd")</input></paragraph> + <paragraph role="paragraph" id="par_id971620413678102">Here the function converts 3.5 international miles to yards, returning the value 6160. Both units are in the Length and distance group.</paragraph> + <paragraph role="paragraph" id="par_id741620413834726"> + <input>=CONVERT(256; "Gibit"; "Mibyte")</input></paragraph> + <paragraph role="paragraph" id="par_id261620413900652">Here the function converts 256 gigibits to mebibytes, returning the value 32768. Both units (bit and byte) are in the Information group and support binary prefixes.</paragraph> + <paragraph role="paragraph" id="par_id761620413966496"> + <input>=CONVERT(1; "dyn"; "e")</input></paragraph> + <paragraph role="paragraph" id="par_id531620414005955">Here the function returns an invalid argument error (Err:502) because the two units (dyne and erg) are in different groups (Force and Energy respectively).</paragraph> + + <section id="Unit_Groups"> + <h2 id="hd_id261620415240175">Units of measurement</h2> + </section> + <paragraph role="paragraph" id="par_id481620428685029">Below are the unit measurement groups supported by the <literal>CONVERT</literal> function. Beware that conversions can only happen between units that belong to the same group.</paragraph> + <note id="par_id461620429183259">The column Prefix indicates whether or not a given unit of measurement supports <link href="text/scalc/01/func_convert.xhp#Prefixes" name="Prefixes_Section">prefixes</link>.</note> + + <h3 id="hd_id301620415514760">Area</h3> + <note id="par_id121620479750266">Some measurement units have more than one accepted symbol. The accepted unit symbols are separated by semicolons in the <emph>Unit symbol</emph> column.</note> + <table id="tab_id331620415562966"> + <tablerow> + <tablecell> + <paragraph id="par_id831620415562967" role="tablehead">Unit symbol</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id251620415562967" role="tablehead">Description</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id151620415562967" role="tablehead">Prefix</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id521620415562967" localize="false" role="tablecontent">"ang2" ; "ang^2"</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id61620415562967" role="tablecontent">Square angstrom</paragraph> + </tablecell> + <tablecell> + <embed href="text/scalc/01/ful_func.xhp#Yes_par"/> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id981620415903827" localize="false" role="tablecontent">"ar"</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id71620415903987" role="tablecontent">Are</paragraph> + </tablecell> + <tablecell> + <embed href="text/scalc/01/ful_func.xhp#Yes_par"/> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id351620415904306" localize="false" role="tablecontent">"ft2" ; "ft^2"</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id631620415904448" role="tablecontent">Square foot</paragraph> + </tablecell> + <tablecell> + <embed href="text/scalc/01/ful_func.xhp#No_par"/> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id91620415904747" localize="false" role="tablecontent">"ha"</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id651620415904891" role="tablecontent">Hectare</paragraph> + </tablecell> + <tablecell> + <embed href="text/scalc/01/ful_func.xhp#No_par"/> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id901620415905195" localize="false" role="tablecontent">"in2" ; "in^2"</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id561620415905331" role="tablecontent">Square inch</paragraph> + </tablecell> + <tablecell> + <embed href="text/scalc/01/ful_func.xhp#No_par"/> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id901620415905225" localize="false" role="tablecontent">"ly2" ; "ly^2"</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id561620415905004" role="tablecontent">Square light-year</paragraph> + </tablecell> + <tablecell> + <embed href="text/scalc/01/ful_func.xhp#No_par"/> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id911620416024191" localize="false" role="tablecontent">"m2" ; "m^2"</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id781620416024343" role="tablecontent">Square meter</paragraph> + </tablecell> + <tablecell> + <embed href="text/scalc/01/ful_func.xhp#Yes_par"/> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id971620416024652" localize="false" role="tablecontent">"mi2" ; "mi^2"</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id731620416024782" role="tablecontent">Square international mile</paragraph> + </tablecell> + <tablecell> + <embed href="text/scalc/01/ful_func.xhp#No_par"/> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id271620416250801" localize="false" role="tablecontent">"Morgen"</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id621620416250948" role="tablecontent">Morgen</paragraph> + </tablecell> + <tablecell> + <embed href="text/scalc/01/ful_func.xhp#No_par"/> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id21620416251236" localize="false" role="tablecontent">"Nmi2" ; "Nmi^2"</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id661620416251507" role="tablecontent">Square nautical mile</paragraph> + </tablecell> + <tablecell> + <embed href="text/scalc/01/ful_func.xhp#No_par"/> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id181620416251827" localize="false" role="tablecontent">"Pica2" ; "Pica^2" ; "picapt2" ; "picapt^2"</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id791620416251948" role="tablecontent">Square pica point</paragraph> + </tablecell> + <tablecell> + <embed href="text/scalc/01/ful_func.xhp#No_par"/> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id611620416252242" localize="false" role="tablecontent">"pica2" ; "pica^2"</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id771620416417874" role="tablecontent">Square pica</paragraph> + </tablecell> + <tablecell> + <embed href="text/scalc/01/ful_func.xhp#No_par"/> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id111620416418168" localize="false" role="tablecontent">"uk_acre" ; "acre"</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id621620416418311" role="tablecontent">International acre</paragraph> + </tablecell> + <tablecell> + <embed href="text/scalc/01/ful_func.xhp#No_par"/> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id731620416418608" localize="false" role="tablecontent">"us_acre"</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id71620416418768" role="tablecontent">US survey acre</paragraph> + </tablecell> + <tablecell> + <embed href="text/scalc/01/ful_func.xhp#No_par"/> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id731620416418769" localize="false" role="tablecontent">"yd2" ; "yd^2"</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id71620416418025" role="tablecontent">Square yard</paragraph> + </tablecell> + <tablecell> + <embed href="text/scalc/01/ful_func.xhp#No_par"/> + </tablecell> + </tablerow> + </table> + + <h3 id="hd_id661620418842010">Energy</h3> + <table id="tab_id298181355938591"> + <tablerow> + <tablecell> + <paragraph id="par_id133389281727763" role="tablehead">Unit symbol</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id215779983443756" role="tablehead">Description</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id986783687128923" role="tablehead">Prefix</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id569445286862812" localize="false" role="tablecontent">"BTU" ; "btu"</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id797688281572156" role="tablecontent">British thermal unit</paragraph> + </tablecell> + <tablecell> + <embed href="text/scalc/01/ful_func.xhp#No_par"/> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id956443293167821" localize="false" role="tablecontent">"c"</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id844417659281393" role="tablecontent">Thermochemical calorie</paragraph> + </tablecell> + <tablecell> + <embed href="text/scalc/01/ful_func.xhp#Yes_par"/> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id563678512847366" localize="false" role="tablecontent">"cal"</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id672765982649722" role="tablecontent">International Steam Table calorie</paragraph> + </tablecell> + <tablecell> + <embed href="text/scalc/01/ful_func.xhp#Yes_par"/> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id881893877326413" localize="false" role="tablecontent">"e"</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id798492531882282" role="tablecontent">erg</paragraph> + </tablecell> + <tablecell> + <embed href="text/scalc/01/ful_func.xhp#Yes_par"/> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id554868456893697" localize="false" role="tablecontent">"eV" ; "ev"</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id547247548598782" role="tablecontent">Electron volt</paragraph> + </tablecell> + <tablecell> + <embed href="text/scalc/01/ful_func.xhp#Yes_par"/> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id461373165135142" localize="false" role="tablecontent">"flb"</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id587393171297892" role="tablecontent">Foot-pound</paragraph> + </tablecell> + <tablecell> + <embed href="text/scalc/01/ful_func.xhp#No_par"/> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id898877643333425" localize="false" role="tablecontent">"HPh" ; "hh"</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id695171299238861" role="tablecontent">Horsepower-hour</paragraph> + </tablecell> + <tablecell> + <embed href="text/scalc/01/ful_func.xhp#No_par"/> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id261123119875248" localize="false" role="tablecontent">"J"</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id498448587944728" role="tablecontent">Joule</paragraph> + </tablecell> + <tablecell> + <embed href="text/scalc/01/ful_func.xhp#Yes_par"/> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id432889499844711" localize="false" role="tablecontent">"Wh" ; "wh"</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id324829753758823" role="tablecontent">Watt-hour</paragraph> + </tablecell> + <tablecell> + <embed href="text/scalc/01/ful_func.xhp#Yes_par"/> + </tablecell> + </tablerow> + </table> + + <h3 id="hd_id281620418969165">Flux density</h3> + <table id="tab_id964977165727472"> + <tablerow> + <tablecell> + <paragraph id="par_id474271648545953" role="tablehead">Unit symbol</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id747764511138273" role="tablehead">Description</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id689379352231556" role="tablehead">Prefix</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id771569221719597" localize="false" role="tablecontent">"ga"</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id114822916257326" role="tablecontent">Gauss</paragraph> + </tablecell> + <tablecell> + <embed href="text/scalc/01/ful_func.xhp#Yes_par"/> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id868398115225815" localize="false" role="tablecontent">"T"</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id626213287964265" role="tablecontent">Tesla</paragraph> + </tablecell> + <tablecell> + <embed href="text/scalc/01/ful_func.xhp#Yes_par"/> + </tablecell> + </tablerow> + </table> + + <h3 id="hd_id511620419033332">Force</h3> + <table id="tab_id473572963491635"> + <tablerow> + <tablecell> + <paragraph id="par_id786326578562174" role="tablehead">Unit symbol</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id613697367784781" role="tablehead">Description</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id338735929142246" role="tablehead">Prefix</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id741853522962135" localize="false" role="tablecontent">"dyn" ; "dy"</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id332679599387353" role="tablecontent">Dyne</paragraph> + </tablecell> + <tablecell> + <embed href="text/scalc/01/ful_func.xhp#Yes_par"/> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id559749726818243" localize="false" role="tablecontent">"N"</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id297688664469184" role="tablecontent">Newton</paragraph> + </tablecell> + <tablecell> + <embed href="text/scalc/01/ful_func.xhp#Yes_par"/> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id991778936374989" localize="false" role="tablecontent">"lbf"</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id413835658896999" role="tablecontent">Pound-force</paragraph> + </tablecell> + <tablecell> + <embed href="text/scalc/01/ful_func.xhp#No_par"/> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id722282244689641" localize="false" role="tablecontent">"pond"</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id472715992174398" role="tablecontent">Pond</paragraph> + </tablecell> + <tablecell> + <embed href="text/scalc/01/ful_func.xhp#Yes_par"/> + </tablecell> + </tablerow> + </table> + + <h3 id="hd_id61620419155285">Information</h3> + <table id="tab_id655651615396453"> + <tablerow> + <tablecell> + <paragraph id="par_id426724696915849" role="tablehead">Unit symbol</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id612374956817974" role="tablehead">Description</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id538681812985912" role="tablehead">Prefix</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id328775657319692" localize="false" role="tablecontent">"bit"</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id287396172896473" role="tablecontent">Bit</paragraph> + </tablecell> + <tablecell> + <embed href="text/scalc/01/ful_func.xhp#Yes_par"/> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id732213932268164" localize="false" role="tablecontent">"byte"</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id288619461492324" role="tablecontent">Byte</paragraph> + </tablecell> + <tablecell> + <embed href="text/scalc/01/ful_func.xhp#Yes_par"/> + </tablecell> + </tablerow> + </table> + + <h3 id="hd_id21620419214852">Length and distance</h3> + <table id="tab_id151282723362773"> + <tablerow> + <tablecell> + <paragraph id="par_id939442657661828" role="tablehead">Unit symbol</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id385965635167839" role="tablehead">Description</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id783715738435884" role="tablehead">Prefix</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id975194925284695" localize="false" role="tablecontent">"ang"</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id871414798381246" role="tablecontent">Angstrom</paragraph> + </tablecell> + <tablecell> + <embed href="text/scalc/01/ful_func.xhp#Yes_par"/> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id462251953683395" localize="false" role="tablecontent">"ell"</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id667871614381886" role="tablecontent">Ell</paragraph> + </tablecell> + <tablecell> + <embed href="text/scalc/01/ful_func.xhp#No_par"/> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id427353475581798" localize="false" role="tablecontent">"ft"</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id116286449743311" role="tablecontent">Foot</paragraph> + </tablecell> + <tablecell> + <embed href="text/scalc/01/ful_func.xhp#No_par"/> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id554928677482461" localize="false" role="tablecontent">"in"</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id174995614358222" role="tablecontent">Inch</paragraph> + </tablecell> + <tablecell> + <embed href="text/scalc/01/ful_func.xhp#No_par"/> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id759221157681496" localize="false" role="tablecontent">"ly" ; "lightyear"</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id597477613742668" role="tablecontent">Light-year</paragraph> + </tablecell> + <tablecell> + <embed href="text/scalc/01/ful_func.xhp#Yes_par"/> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id576527667856118" localize="false" role="tablecontent">"m"</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id414782652978666" role="tablecontent">Meter</paragraph> + </tablecell> + <tablecell> + <embed href="text/scalc/01/ful_func.xhp#Yes_par"/> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id785562982269695" localize="false" role="tablecontent">"mi"</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id246972715165395" role="tablecontent">International mile</paragraph> + </tablecell> + <tablecell> + <embed href="text/scalc/01/ful_func.xhp#No_par"/> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id278335187628755" localize="false" role="tablecontent">"Nmi"</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id664674443288268" role="tablecontent">Nautical mile</paragraph> + </tablecell> + <tablecell> + <embed href="text/scalc/01/ful_func.xhp#No_par"/> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id832181127538982" localize="false" role="tablecontent">"parsec" ; "pc"</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id139127915416429" role="tablecontent">Parsec</paragraph> + </tablecell> + <tablecell> + <embed href="text/scalc/01/ful_func.xhp#Yes_par"/> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id396691995323256" localize="false" role="tablecontent">"Pica" ; "picapt"</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id343241931577938" role="tablecontent">Pica point</paragraph> + </tablecell> + <tablecell> + <embed href="text/scalc/01/ful_func.xhp#No_par"/> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id331128785553249" localize="false" role="tablecontent">"pica"</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id314567699952918" role="tablecontent">Pica</paragraph> + </tablecell> + <tablecell> + <embed href="text/scalc/01/ful_func.xhp#No_par"/> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id891632362725632" localize="false" role="tablecontent">"survey_mi"</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id579641593251685" role="tablecontent">US survey mile</paragraph> + </tablecell> + <tablecell> + <embed href="text/scalc/01/ful_func.xhp#No_par"/> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id314284197456168" localize="false" role="tablecontent">"yd"</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id247251727323315" role="tablecontent">Yard</paragraph> + </tablecell> + <tablecell> + <embed href="text/scalc/01/ful_func.xhp#No_par"/> + </tablecell> + </tablerow> + </table> + + <h3 id="hd_id101620426269258">Mass and weight</h3> + <table id="tab_id987592258455319"> + <tablerow> + <tablecell> + <paragraph id="par_id662733781297324" role="tablehead">Unit symbol</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id314237495552874" role="tablehead">Description</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id543131496247122" role="tablehead">Prefix</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id414474992528385" localize="false" role="tablecontent">"cwt" ; "shweight"</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id163896825569756" role="tablecontent">Short hundredweight</paragraph> + </tablecell> + <tablecell> + <embed href="text/scalc/01/ful_func.xhp#No_par"/> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id449514439345839" localize="false" role="tablecontent">"g"</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id219736221925573" role="tablecontent">Gram</paragraph> + </tablecell> + <tablecell> + <embed href="text/scalc/01/ful_func.xhp#Yes_par"/> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id313343851458777" localize="false" role="tablecontent">"grain"</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id613363919875679" role="tablecontent">Grain</paragraph> + </tablecell> + <tablecell> + <embed href="text/scalc/01/ful_func.xhp#No_par"/> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id724595483326729" localize="false" role="tablecontent">"lbm"</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id961199633533431" role="tablecontent">Pound</paragraph> + </tablecell> + <tablecell> + <embed href="text/scalc/01/ful_func.xhp#No_par"/> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id939963948418678" localize="false" role="tablecontent">"ozm"</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id655456352143671" role="tablecontent">Ounce</paragraph> + </tablecell> + <tablecell> + <embed href="text/scalc/01/ful_func.xhp#No_par"/> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id188555391191767" localize="false" role="tablecontent">"pweight"</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id613492674545171" role="tablecontent">Pennyweight</paragraph> + </tablecell> + <tablecell> + <embed href="text/scalc/01/ful_func.xhp#No_par"/> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id657645272418762" localize="false" role="tablecontent">"sg"</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id566783887997575" role="tablecontent">Slug</paragraph> + </tablecell> + <tablecell> + <embed href="text/scalc/01/ful_func.xhp#No_par"/> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id323583787534183" localize="false" role="tablecontent">"stone"</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id731498557457276" role="tablecontent">Stone</paragraph> + </tablecell> + <tablecell> + <embed href="text/scalc/01/ful_func.xhp#No_par"/> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id554919533186898" localize="false" role="tablecontent">"ton"</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id618416327957968" role="tablecontent">Short ton</paragraph> + </tablecell> + <tablecell> + <embed href="text/scalc/01/ful_func.xhp#No_par"/> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id482546497575283" localize="false" role="tablecontent">"u"</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id556166667325333" role="tablecontent">Unified atomic mass unit</paragraph> + </tablecell> + <tablecell> + <embed href="text/scalc/01/ful_func.xhp#Yes_par"/> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id242665252964996" localize="false" role="tablecontent">"uk_cwt" ; "lcwt" ; "hweight"</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id161338688697922" role="tablecontent">Long hundredweight</paragraph> + </tablecell> + <tablecell> + <embed href="text/scalc/01/ful_func.xhp#No_par"/> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id825123652593813" localize="false" role="tablecontent">"uk_ton" ; "LTON" ; "brton"</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id616379569614142" role="tablecontent">Long ton</paragraph> + </tablecell> + <tablecell> + <embed href="text/scalc/01/ful_func.xhp#No_par"/> + </tablecell> + </tablerow> + </table> + + <h3 id="hd_id1001620426284123">Power</h3> + <table id="tab_id159466558733727"> + <tablerow> + <tablecell> + <paragraph id="par_id765457372987543" role="tablehead">Unit symbol</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id222988613874967" role="tablehead">Description</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id954629589584711" role="tablehead">Prefix</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id337716541277233" localize="false" role="tablecontent">"HP" ; "h"</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id578436173796358" role="tablecontent">Mechanical horsepower</paragraph> + </tablecell> + <tablecell> + <embed href="text/scalc/01/ful_func.xhp#No_par"/> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id938191464394781" localize="false" role="tablecontent">"PS"</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id418898833841613" role="tablecontent">Pferdestärke or metric horsepower</paragraph> + </tablecell> + <tablecell> + <embed href="text/scalc/01/ful_func.xhp#No_par"/> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id232851659252123" localize="false" role="tablecontent">"W" ; "w"</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id239893771814786" role="tablecontent">Watt</paragraph> + </tablecell> + <tablecell> + <embed href="text/scalc/01/ful_func.xhp#Yes_par"/> + </tablecell> + </tablerow> + </table> + + <h3 id="hd_id541620426359069">Pressure</h3> + <table id="tab_id919321584131771"> + <tablerow> + <tablecell> + <paragraph id="par_id843387541961981" role="tablehead">Unit symbol</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id385992865555923" role="tablehead">Description</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id513642579177244" role="tablehead">Prefix</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id921213995456776" localize="false" role="tablecontent">"atm" ; ("at")<sup>(1)</sup></paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id888153229712212" role="tablecontent">Standard atmosphere</paragraph> + </tablecell> + <tablecell> + <embed href="text/scalc/01/ful_func.xhp#Yes_par"/> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id445134526598488" localize="false" role="tablecontent">"mmHg"</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id849582553771429" role="tablecontent">Millimeter of mercury</paragraph> + </tablecell> + <tablecell> + <embed href="text/scalc/01/ful_func.xhp#Yes_par"/> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id142795818733368" localize="false" role="tablecontent">"Pa"</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id477235647442515" role="tablecontent">Pascal</paragraph> + </tablecell> + <tablecell> + <embed href="text/scalc/01/ful_func.xhp#Yes_par"/> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id253344479916294" localize="false" role="tablecontent">"psi"</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id453587511744492" role="tablecontent">Pound per square inch</paragraph> + </tablecell> + <tablecell> + <embed href="text/scalc/01/ful_func.xhp#No_par"/> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id698366341151136" localize="false" role="tablecontent">"Torr"</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id385442861685423" role="tablecontent">Torr</paragraph> + </tablecell> + <tablecell> + <embed href="text/scalc/01/ful_func.xhp#No_par"/> + </tablecell> + </tablerow> + </table> + <warning id="par_id911641306487164">1 - The "at" unit is deprecated. Use "atm" instead.</warning> + + <h3 id="hd_id61620426438099">Speed</h3> + <table id="tab_id699528473861629"> + <tablerow> + <tablecell> + <paragraph id="par_id589222947765948" role="tablehead">Unit symbol</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id886677898259849" role="tablehead">Description</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id439227432319741" role="tablehead">Prefix</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id954749535393193" localize="false" role="tablecontent">"admkn"</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id391572877557741" role="tablecontent">Admiralty knot</paragraph> + </tablecell> + <tablecell> + <embed href="text/scalc/01/ful_func.xhp#No_par"/> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id865786778481645" localize="false" role="tablecontent">"kn"</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id152721538362456" role="tablecontent">International knot</paragraph> + </tablecell> + <tablecell> + <embed href="text/scalc/01/ful_func.xhp#No_par"/> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id753435843689377" localize="false" role="tablecontent">"m/h" ; "m/hr"</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id117898736774311" role="tablecontent">Meters per hour</paragraph> + </tablecell> + <tablecell> + <embed href="text/scalc/01/ful_func.xhp#Yes_par"/> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id587139589261195" localize="false" role="tablecontent">"m/s" ; "m/sec"</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id145334267535329" role="tablecontent">Meters per second</paragraph> + </tablecell> + <tablecell> + <embed href="text/scalc/01/ful_func.xhp#Yes_par"/> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id618827791738926" localize="false" role="tablecontent">"mph"</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id233825548718154" role="tablecontent">Miles per hour</paragraph> + </tablecell> + <tablecell> + <embed href="text/scalc/01/ful_func.xhp#No_par"/> + </tablecell> + </tablerow> + </table> + + <h3 id="hd_id351620426496272">Temperature</h3> + <table id="tab_id611159446581557"> + <tablerow> + <tablecell> + <paragraph id="par_id916682468647914" role="tablehead">Unit symbol</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id828222863857386" role="tablehead">Description</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id131675777393493" role="tablehead">Prefix</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id872111334289956" localize="false" role="tablecontent">"C" ; "cel"</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id611894272236225" role="tablecontent">Degree Celsius</paragraph> + </tablecell> + <tablecell> + <embed href="text/scalc/01/ful_func.xhp#No_par"/> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id938578588825866" localize="false" role="tablecontent">"F" ; "fah"</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id446899599712639" role="tablecontent">Degree Fahrenheit</paragraph> + </tablecell> + <tablecell> + <embed href="text/scalc/01/ful_func.xhp#No_par"/> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id125231983731839" localize="false" role="tablecontent">"K" ; "kel"</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id452842161272274" role="tablecontent">Kelvin</paragraph> + </tablecell> + <tablecell> + <embed href="text/scalc/01/ful_func.xhp#Yes_par"/> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id194122867228313" localize="false" role="tablecontent">"Rank"</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id946395673872875" role="tablecontent">Degree Rankine</paragraph> + </tablecell> + <tablecell> + <embed href="text/scalc/01/ful_func.xhp#No_par"/> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id483363447419939" localize="false" role="tablecontent">"Reau"</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id718454351326149" role="tablecontent">Degree Réaumur</paragraph> + </tablecell> + <tablecell> + <embed href="text/scalc/01/ful_func.xhp#No_par"/> + </tablecell> + </tablerow> + </table> + + <h3 id="hd_id291620426558219">Time</h3> + <table id="tab_id755647196118982"> + <tablerow> + <tablecell> + <paragraph id="par_id935221689591996" role="tablehead">Unit symbol</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id664526138752768" role="tablehead">Description</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id889226439751962" role="tablehead">Prefix</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id381382398556233" localize="false" role="tablecontent">"day" ; "d"</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id246817386878489" role="tablecontent">Day</paragraph> + </tablecell> + <tablecell> + <embed href="text/scalc/01/ful_func.xhp#No_par"/> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id945715595918177" localize="false" role="tablecontent">"hr"</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id464925665919665" role="tablecontent">Hour</paragraph> + </tablecell> + <tablecell> + <embed href="text/scalc/01/ful_func.xhp#No_par"/> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id869887353345544" localize="false" role="tablecontent">"mn" ; "min"</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id134873473826283" role="tablecontent">Minute</paragraph> + </tablecell> + <tablecell> + <embed href="text/scalc/01/ful_func.xhp#No_par"/> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id949824769914642" localize="false" role="tablecontent">"sec" ; "s"</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id424852859961766" role="tablecontent">Second</paragraph> + </tablecell> + <tablecell> + <embed href="text/scalc/01/ful_func.xhp#Yes_par"/> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id986426975385483" localize="false" role="tablecontent">"yr"</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id546198897664738" role="tablecontent">Year</paragraph> + </tablecell> + <tablecell> + <embed href="text/scalc/01/ful_func.xhp#No_par"/> + </tablecell> + </tablerow> + </table> + + <h3 id="hd_id151620426617693">Volume</h3> + <table id="tab_id262859621658125"> + <tablerow> + <tablecell> + <paragraph id="par_id245659124219512" role="tablehead">Unit symbol</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id954441838321316" role="tablehead">Description</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id487448753979859" role="tablehead">Prefix</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id742373482648115" localize="false" role="tablecontent">"ang3" ; "ang^3"</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id254311578719497" role="tablecontent">Cubic angstrom</paragraph> + </tablecell> + <tablecell> + <embed href="text/scalc/01/ful_func.xhp#Yes_par"/> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id194119333251239" localize="false" role="tablecontent">"barrel"</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id545825775819166" role="tablecontent">Oil barrel</paragraph> + </tablecell> + <tablecell> + <embed href="text/scalc/01/ful_func.xhp#No_par"/> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id673312966527425" localize="false" role="tablecontent">"bushel"</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id976829653577442" role="tablecontent">US bushel</paragraph> + </tablecell> + <tablecell> + <embed href="text/scalc/01/ful_func.xhp#No_par"/> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id388214653874841" localize="false" role="tablecontent">"cup"</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id184258429676826" role="tablecontent">US cup</paragraph> + </tablecell> + <tablecell> + <embed href="text/scalc/01/ful_func.xhp#No_par"/> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id347348699465995" localize="false" role="tablecontent">"ft3" ; "ft^3"</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id278184952564879" role="tablecontent">Cubic foot</paragraph> + </tablecell> + <tablecell> + <embed href="text/scalc/01/ful_func.xhp#No_par"/> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id253793989186841" localize="false" role="tablecontent">"gal"</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id466397614396366" role="tablecontent">US gallon</paragraph> + </tablecell> + <tablecell> + <embed href="text/scalc/01/ful_func.xhp#No_par"/> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id477248257624964" localize="false" role="tablecontent">"Glass"<sup>(2)</sup></paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id938562498562468" role="tablecontent">Australian glass (200 milliliters)</paragraph> + </tablecell> + <tablecell> + <embed href="text/scalc/01/ful_func.xhp#No_par"/> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id927845313892281" localize="false" role="tablecontent">"GRT" ; "regton"</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id471177863127144" role="tablecontent">Gross register tonnage</paragraph> + </tablecell> + <tablecell> + <embed href="text/scalc/01/ful_func.xhp#No_par"/> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id584476153629656" localize="false" role="tablecontent">"Humpen"<sup>(2)</sup></paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id347175644673122" role="tablecontent">Humpen (500 milliliters)</paragraph> + </tablecell> + <tablecell> + <embed href="text/scalc/01/ful_func.xhp#No_par"/> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id143322419863673" localize="false" role="tablecontent">"in3" ; "in^3"</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id995576717914988" role="tablecontent">Cubic inch</paragraph> + </tablecell> + <tablecell> + <embed href="text/scalc/01/ful_func.xhp#No_par"/> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id231695939242594" localize="false" role="tablecontent">"l" ; "L" ; "lt"</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id842329689485738" role="tablecontent">Liter</paragraph> + </tablecell> + <tablecell> + <embed href="text/scalc/01/ful_func.xhp#Yes_par"/> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id915284957397584" localize="false" role="tablecontent">"ly3" ; "ly^3"</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id236636296681258" role="tablecontent">Cubic light-year</paragraph> + </tablecell> + <tablecell> + <embed href="text/scalc/01/ful_func.xhp#No_par"/> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id572433334412695" localize="false" role="tablecontent">"m3" ; "m^3"</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id538319527687728" role="tablecontent">Cubic meter</paragraph> + </tablecell> + <tablecell> + <embed href="text/scalc/01/ful_func.xhp#Yes_par"/> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id395785921258135" localize="false" role="tablecontent">"mi3" ; "mi^3"</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id463843338576911" role="tablecontent">Cubic international mile</paragraph> + </tablecell> + <tablecell> + <embed href="text/scalc/01/ful_func.xhp#No_par"/> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id648645827638713" localize="false" role="tablecontent">"Middy"<sup>(2)</sup></paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id995778363641811" role="tablecontent">Australian middy (285 milliliters)</paragraph> + </tablecell> + <tablecell> + <embed href="text/scalc/01/ful_func.xhp#No_par"/> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id913659161224112" localize="false" role="tablecontent">"MTON"</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id894695318848125" role="tablecontent">Measurement ton</paragraph> + </tablecell> + <tablecell> + <embed href="text/scalc/01/ful_func.xhp#No_par"/> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id673916153456138" localize="false" role="tablecontent">"Nmi3" ; "Nmi^3"</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id392284181269245" role="tablecontent">Cubic nautical mile</paragraph> + </tablecell> + <tablecell> + <embed href="text/scalc/01/ful_func.xhp#No_par"/> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id929374968461384" localize="false" role="tablecontent">"oz"</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id371262895179554" role="tablecontent">US fluid ounce</paragraph> + </tablecell> + <tablecell> + <embed href="text/scalc/01/ful_func.xhp#No_par"/> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id242677566736799" localize="false" role="tablecontent">"Pica3" ; "Pica^3" ; "picapt3" ; "picapt^3"</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id895488213141468" localize="false" role="tablecontent">Cubic pica point</paragraph> + </tablecell> + <tablecell> + <embed href="text/scalc/01/ful_func.xhp#No_par"/> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id122859286345561" localize="false" role="tablecontent">"pica3" ; "pica^3"</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id956867693183654" role="tablecontent">Cubic pica</paragraph> + </tablecell> + <tablecell> + <embed href="text/scalc/01/ful_func.xhp#No_par"/> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id582142994514436" localize="false" role="tablecontent">"pt" ; "us_pt"</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id698697624265559" role="tablecontent">US pint</paragraph> + </tablecell> + <tablecell> + <embed href="text/scalc/01/ful_func.xhp#No_par"/> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id988446288764263" localize="false" role="tablecontent">"qt"</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id615917164511264" role="tablecontent">US quart</paragraph> + </tablecell> + <tablecell> + <embed href="text/scalc/01/ful_func.xhp#No_par"/> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id828968322594669" localize="false" role="tablecontent">"Schooner"<sup>(2)</sup></paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id653481929342877" role="tablecontent">Australian schooner (425 milliliters)</paragraph> + </tablecell> + <tablecell> + <embed href="text/scalc/01/ful_func.xhp#No_par"/> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id377965813595534" localize="false" role="tablecontent">"Sixpack"<sup>(2)</sup></paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id912821548196546" role="tablecontent">Six pack (2 liters)</paragraph> + </tablecell> + <tablecell> + <embed href="text/scalc/01/ful_func.xhp#No_par"/> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id218578441553519" localize="false" role="tablecontent">"tbs"</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id248216629889251" role="tablecontent">US tablespoon</paragraph> + </tablecell> + <tablecell> + <embed href="text/scalc/01/ful_func.xhp#No_par"/> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id312637427526639" localize="false" role="tablecontent">"tsp"</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id745625921159327" role="tablecontent">US teaspoon</paragraph> + </tablecell> + <tablecell> + <embed href="text/scalc/01/ful_func.xhp#No_par"/> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id679171851162521" localize="false" role="tablecontent">"tspm"</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id864223151994899" role="tablecontent">Metric teaspoon</paragraph> + </tablecell> + <tablecell> + <embed href="text/scalc/01/ful_func.xhp#No_par"/> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id744654238369282" localize="false" role="tablecontent">"uk_gal"</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id311759289592485" role="tablecontent">Imperial gallon</paragraph> + </tablecell> + <tablecell> + <embed href="text/scalc/01/ful_func.xhp#No_par"/> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id567929573533886" localize="false" role="tablecontent">"uk_pt"</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id673293916128784" role="tablecontent">Imperial pint</paragraph> + </tablecell> + <tablecell> + <embed href="text/scalc/01/ful_func.xhp#No_par"/> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id884657269767431" localize="false" role="tablecontent">"uk_qt"</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id213353742979736" role="tablecontent">Imperial quart</paragraph> + </tablecell> + <tablecell> + <embed href="text/scalc/01/ful_func.xhp#No_par"/> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id711842253848897" localize="false" role="tablecontent">"yd3" ; "yd^3"</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id817884513513347" role="tablecontent">Cubic yard</paragraph> + </tablecell> + <tablecell> + <embed href="text/scalc/01/ful_func.xhp#No_par"/> + </tablecell> + </tablerow> + </table> + <note id="par_id671641306535516">2 - These units are not part of the <emph>Open Document Format for Office Applications (OpenDocument) Version 1.3. Part 4: Recalculated Formula (OpenFormula) Format</emph> standard for the CONVERT function. They are preserved for backward compatibility.</note> + <section id="Prefixes"> + <h2 id="hd_id21620415408286">Prefixes</h2> + </section> + <h3 id="hd_id731620426688645">Decimal prefixes</h3> + <table id="tab_id828724674227638"> + <tablerow> + <tablecell> + <paragraph id="par_id772395422122114" role="tablehead">Prefix</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id448471762246791" role="tablehead">Multiplier</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id464235713977297" localize="false" role="tablecontent">Y (yotta)</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id382297381124942" localize="false" role="tablecontent">10<sup>24</sup></paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id195969296892884" localize="false" role="tablecontent">Z (zetta)</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id729358319725611" localize="false" role="tablecontent">10<sup>21</sup></paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id896911765974332" localize="false" role="tablecontent">E (exa)</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id382641377245968" localize="false" role="tablecontent">10<sup>18</sup></paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id621313155398871" localize="false" role="tablecontent">P (peta)</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id883541189319954" localize="false" role="tablecontent">10<sup>15</sup></paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id771989892374889" localize="false" role="tablecontent">T (tera)</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id733531858969553" localize="false" role="tablecontent">10<sup>12</sup></paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id413938379889651" localize="false" role="tablecontent">G (giga)</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id483273257579936" localize="false" role="tablecontent">10<sup>9</sup></paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id782419487516479" localize="false" role="tablecontent">M (mega)</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id637295562743228" localize="false" role="tablecontent">10<sup>6</sup></paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id897563426716439" localize="false" role="tablecontent">k (kilo)</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id172178771518245" localize="false" role="tablecontent">10<sup>3</sup></paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id667993131196768" localize="false" role="tablecontent">h (hecto)</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id624783418367776" localize="false" role="tablecontent">10<sup>2</sup></paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id864465688672221" localize="false" role="tablecontent">e (deca)</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id815223592146618" localize="false" role="tablecontent">10<sup>1</sup></paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id346425652937897" localize="false" role="tablecontent">d (deci)</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id876256467492564" localize="false" role="tablecontent">10<sup>-1</sup></paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id922142991788446" localize="false" role="tablecontent">c (centi)</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id252929881889423" localize="false" role="tablecontent">10<sup>-2</sup></paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id881839868947749" localize="false" role="tablecontent">m (milli)</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id698257386584299" localize="false" role="tablecontent">10<sup>-3</sup></paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id239316775738957" localize="false" role="tablecontent">u (micro)</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id322211739146687" localize="false" role="tablecontent">10<sup>-6</sup></paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id654828299623554" localize="false" role="tablecontent">n (nano)</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id642127274228539" localize="false" role="tablecontent">10<sup>-9</sup></paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id658216627833144" localize="false" role="tablecontent">p (pico)</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id252946687944726" localize="false" role="tablecontent">10<sup>-12</sup></paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id238422159622315" localize="false" role="tablecontent">f (femto)</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id642676564889834" localize="false" role="tablecontent">10<sup>-15</sup></paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id117872718654341" localize="false" role="tablecontent">a (atto)</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id261649234231835" localize="false" role="tablecontent">10<sup>-18</sup></paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id469149385818358" localize="false" role="tablecontent">z (zepto)</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id223582154553896" localize="false" role="tablecontent">10<sup>-21</sup></paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id332536816216951" localize="false" role="tablecontent">y (yocto)</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id318813222624119" localize="false" role="tablecontent">10<sup>-24</sup></paragraph> + </tablecell> + </tablerow> + </table> + + <h3 id="hd_id91620427193950">Binary prefixes</h3> + <table id="tab_id264635321234215"> + <tablerow> + <tablecell> + <paragraph id="par_id422991712375461" role="tablehead">Prefix</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id553637738674151" role="tablehead">Multiplier</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id173164235173819" localize="false" role="tablecontent">Yi (yobi)</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id998779957548991" localize="false" role="tablecontent">2<sup>80</sup></paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id177634268414555" localize="false" role="tablecontent">Zi (zebi)</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id971825321168754" localize="false" role="tablecontent">2<sup>70</sup></paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id618448379119254" localize="false" role="tablecontent">Ei (exbi)</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id454829637857684" localize="false" role="tablecontent">2<sup>60</sup></paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id969745425575594" localize="false" role="tablecontent">Pi (pebi)</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id941231646574848" localize="false" role="tablecontent">2<sup>50</sup></paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id493761634389785" localize="false" role="tablecontent">Ti (tebi)</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id958478788867513" localize="false" role="tablecontent">2<sup>40</sup></paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id378317685761813" localize="false" role="tablecontent">Gi (gibi)</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id199491346693428" localize="false" role="tablecontent">2<sup>30</sup></paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id261868876761555" localize="false" role="tablecontent">Mi (mebi)</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id621531875259349" localize="false" role="tablecontent">2<sup>20</sup></paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id499638781156135" localize="false" role="tablecontent">ki (kibi)</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id573129416738365" localize="false" role="tablecontent">2<sup>10</sup></paragraph> + </tablecell> + </tablerow> + </table> + <embed href="text/scalc/01/common_func.xhp#sectiontechinfo"/> + <embed href="text/scalc/01/common_func.xhp#notODFF"/> + <paragraph role="paragraph" id="par_id311640873986703" localize="false"><literal>ORG.OPENOFFICE.CONVERT</literal></paragraph> + <section id="relatedtopics"> + <paragraph role="paragraph" id="par_id871621424421294"><link href="https://wiki.documentfoundation.org/Documentation/Calc_Functions/CONVERT">CONVERT Wiki page</link></paragraph> + </section> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/func_countifs.xhp b/helpcontent2/source/text/scalc/01/func_countifs.xhp new file mode 100644 index 000000000..d2af44ba1 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/func_countifs.xhp @@ -0,0 +1,76 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * +--> + +<meta> + <topic id="textscalc01func_countifsxml"> + <title id="tit" xml-lang="en-US">COUNTIFS function</title> + <filename>/text/scalc/01/func_countifs.xhp</filename> + </topic> +</meta> + +<body> +<section id="countifs_function"> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_COUNTIFS" id="bm_id449544954495" localize="false"/> +<bookmark xml-lang="en-US" branch="index" id="bm_id452245224522"> + <bookmark_value>COUNTIFS function</bookmark_value> + <bookmark_value>counting row;satisfying criteria</bookmark_value> + <bookmark_value>counting column;satisfying criteria</bookmark_value> +</bookmark> +<h1 id="hd_id456845684568"><variable id="countifs_head"><link href="text/scalc/01/func_countifs.xhp">COUNTIFS</link></variable></h1> +<paragraph id="par_id462646264626" role="paragraph" xml-lang="en-US"><ahelp hid="."><variable id="countifs_des">Returns the count of cells that meet criteria in multiple ranges.</variable></ahelp></paragraph> +</section> +<embed href="text/scalc/00/avail_release.xhp#4.0"/> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + +<paragraph id="par_id27421466710275" role="code" xml-lang="en-US">COUNTIFS(Range; Criterion[; Range2; Criterion2][; ... ; [Range127; Criterion127]])</paragraph> +<embed href="text/scalc/01/ex_data_stat_func.xhp#par00"/> +<embed href="text/shared/00/00000001.xhp#regex"/> +<paragraph role="paragraph" id="par_id14734320631377"><emph>Range, Range2, ...</emph> and <emph>Criterion, Criterion2, ...</emph> must have the same size, otherwise the function returns err:502 - Invalid argument.</paragraph> +<embed href="text/scalc/01/ex_data_stat_func.xhp#note01"/> +<embed href="text/scalc/01/ex_data_stat_func.xhp#par01"/> +<embed href="text/scalc/01/ODFF.xhp#odff"/> +<embed href="text/scalc/01/ex_data_stat_func.xhp#ex_func_average"/> +<h4 id="hd_id3861259759512">Simple usage</h4> +<paragraph id="par_id15856592423333" role="paragraph" xml-lang="en-US"><item type="input">=COUNTIFS(B2:B6;">=20")</item></paragraph> +<paragraph id="par_id323511393121175" role="paragraph" xml-lang="en-US">Counts the amount of rows of the range B2:B6 with values greater than or equal to 20. Returns 3, because the fifth and the sixth rows do not meet the criterion.</paragraph> +<paragraph id="par_id74301057922522" role="paragraph" xml-lang="en-US"><item type="input">=COUNTIFS(B2:B6;">=20";C2:C6;">70")</item></paragraph> +<paragraph id="par_id109622995127628" role="paragraph" xml-lang="en-US">Counts the amount of rows that contain simultaneously values greater than 70 in the C2:C6 range and values greater than or equal to 20 in the B2:B6 range. Returns 2, because the second, the fifth and the sixth rows do not meet at least one criterion.</paragraph> +<h4 id="hd_id298462825526166">Using regular expressions and nested functions</h4> +<paragraph role="paragraph" id="par_id831605805755075">For these examples to work as described, make sure that <emph>Enable regular expressions in formulas</emph> is selected in <switchinline select="sys"><caseinline select="MAC"><menuitem>%PRODUCTNAME - Preferences</menuitem></caseinline><defaultinline><menuitem>Tools - Options</menuitem></defaultinline></switchinline><menuitem> - $[officename] Calc - Calculate</menuitem>.</paragraph> +<paragraph id="par_id22736248573471" role="paragraph" xml-lang="en-US"><item type="input">=COUNTIFS(B2:B6;"[:alpha:]*")</item></paragraph> +<paragraph id="par_id22137303324873" role="paragraph" xml-lang="en-US">Counts the amount of rows of the B2:B6 range that contain only alphabet symbols. Returns 1, because only sixth row meets the criterion.</paragraph> +<paragraph id="par_id82271340221411" role="paragraph" xml-lang="en-US"><item type="input">=COUNTIFS(B2:B6;">"&MIN(B2:B6);B2:B6;"<"&MAX(B2:B6))</item></paragraph> +<paragraph id="par_id1105320769334" role="paragraph" xml-lang="en-US">Counts the amount of rows of the B2:B6 range excluding rows with minimum and maximum values of this range. Returns 2, because the third, the fifth and the sixth rows do not meet at least one criterion.</paragraph> +<paragraph id="par_id267603146513224" role="paragraph" xml-lang="en-US"><item type="input">=COUNTIFS(A2:A6;"pen.*";B2:B6;"<"&MAX(B2:B6))</item></paragraph> +<paragraph id="par_id111252614832220" role="paragraph" xml-lang="en-US">Counts the amount of rows that correspond to all cells of the A2:A6 range starting with "pen" and to all cells of the B2:B6 range with exception of its maximum. Returns 1, because only second row meets all criteria.</paragraph> +<h4 id="hd_id212582362610399">Reference to a cell as a criterion</h4> +<paragraph id="par_id3245551524846" role="paragraph" xml-lang="en-US">If you need to change a criterion easily, you may want to specify it in a separate cell and use a reference to this cell in the condition of the COUNTIFS function. For example, the above function can be rewritten as follows:</paragraph> +<paragraph id="par_id109501907712434" role="paragraph" xml-lang="en-US"><item type="input">=COUNTIFS(A2:A6;E2&".*";B2:B6;"<"&MAX(B2:B6))</item></paragraph> +<paragraph id="par_id738533068520" role="paragraph" xml-lang="en-US">If E2 = pen, the function returns 1, because the link to the cell is substituted with its content and it works as a function above.</paragraph> +<embed href="text/scalc/06/calcsamplefiles.xhp#func_ifs"/> +<section id="relatedtopics"> + <paragraph id="par_id11921178730928" role="paragraph" xml-lang="en-US" localize="false"> + <embedvar href="text/scalc/01/04060181.xhp#count_head"/>, + <embedvar href="text/scalc/01/04060181.xhp#countif_head"/>, + <embedvar href="text/scalc/01/04060181.xhp#countblank_head"/>, + <embedvar href="text/scalc/01/04060181.xhp#counta_head"/> + </paragraph> + <paragraph id="par_id11931178730928" role="paragraph" xml-lang="en-US" localize="false"> + <embedvar href="text/scalc/01/func_countifs.xhp#countifs_head"/>, + <embedvar href="text/scalc/01/func_minifs.xhp#minifs_head"/>, + <embedvar href="text/scalc/01/func_maxifs.xhp#maxifs_head"/>, + <embedvar href="text/scalc/01/func_averageifs.xhp#averageifs_head"/>, + <embedvar href="text/scalc/01/func_sumifs.xhp#sumifs_head"/> + </paragraph> +<paragraph id="par_id235992404316585" role="paragraph" localize="false" xml-lang="en-US"><embedvar href="text/shared/01/02100001.xhp#02100001"/></paragraph> +</section> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/func_date.xhp b/helpcontent2/source/text/scalc/01/func_date.xhp new file mode 100644 index 000000000..bb05e1f80 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/func_date.xhp @@ -0,0 +1,50 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . + --> +<helpdocument version="1.0"> +<meta> +<topic id="textscalc01func_datexml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">DATE</title> +<filename>/text/scalc/01/func_date.xhp</filename> +</topic> +</meta> +<body> +<bookmark xml-lang="en-US" branch="index" id="bm_id3155511"><bookmark_value>DATE function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_DATUM" id="bm_id3149022" localize="false"/><h2 id="hd_id3155511"><variable id="date"><link href="text/scalc/01/func_date.xhp">DATE</link> +</variable></h2> +<paragraph role="paragraph" id="par_id3153551" xml-lang="en-US"><ahelp hid="HID_FUNC_DATUM">This function calculates a date specified by year, month, day and displays it in the cell's formatting.</ahelp> The default format of a cell containing the DATE function is the date format, but you can format the cells with any other number format.</paragraph> +<embed href="text/scalc/01/ODFF.xhp#odff"/> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph role="code" id="par_id3150474" xml-lang="en-US">DATE(Year; Month; Day)</paragraph> +<paragraph role="paragraph" id="par_id3152815" xml-lang="en-US"> +<emph>Year</emph> is an integer between 1583 and 9957 or between 0 and 99.</paragraph> +<paragraph role="paragraph" id="par_id3153222" xml-lang="en-US">In <switchinline select="sys"><caseinline select="MAC"><item type="menuitem">%PRODUCTNAME - Preferences</item></caseinline><defaultinline><item type="menuitem">Tools - Options</item></defaultinline></switchinline><item type="menuitem"> - $[officename] - General </item>you can set from which year a two-digit number entry is recognized as 20xx.</paragraph> +<paragraph role="paragraph" id="par_id3155817" xml-lang="en-US"> +<emph>Month</emph> is an integer indicating the month.</paragraph> +<paragraph role="paragraph" id="par_id3153183" xml-lang="en-US"> +<emph>Day</emph> is an integer indicating the day of the month.</paragraph> +<paragraph role="paragraph" id="par_id3156260" xml-lang="en-US">If the values for month and day are out of bounds, they are carried over to the next digit. If you enter <item type="input">=DATE(00;12;31)</item> the result will be 2000-12-31. If, on the other hand, you enter <item type="input">=DATE(00;13;31)</item> the result will be 2001-01-31.</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph role="paragraph" id="par_id3152589" xml-lang="en-US"> +<item type="input">=DATE(00;1;31)</item> yields 1/31/00 if the cell format setting is MM/DD/YY.</paragraph> +<section id="relatedtopics"> + <embed href="text/scalc/01/04060102.xhp#datetimefunctions"/> +</section> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/func_datedif.xhp b/helpcontent2/source/text/scalc/01/func_datedif.xhp new file mode 100644 index 000000000..c8dae66be --- /dev/null +++ b/helpcontent2/source/text/scalc/01/func_datedif.xhp @@ -0,0 +1,113 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * +--> +<helpdocument version="1.0"> +<meta> +<topic id="textscalc01func_datedifxml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">DATEDIF</title> +<filename>/text/scalc/01/func_datedif.xhp</filename> +</topic> +</meta> +<body> +<bookmark xml-lang="en-US" branch="index" id="bm_id3155511"><bookmark_value>DATEDIF function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_DATEDIF" id="bm_id3149022" localize="false"/> +<h2 id="hd_id3155511"><variable id="datedif"><link href="text/scalc/01/func_datedif.xhp">DATEDIF</link></variable></h2> +<paragraph role="paragraph" id="par_id3153551" xml-lang="en-US"><ahelp hid="HID_FUNC_DATEDIF">This function returns the number of whole days, months or years between Start date and End date.</ahelp></paragraph> +<embed href="text/scalc/00/avail_release.xhp#3.6"/> +<embed href="text/scalc/01/ODFF.xhp#odff"/> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph role="paragraph" id="par_id531642776283977"> + <input>DATEDIF(Start date; End date; Interval)</input> +</paragraph> +<paragraph role="paragraph" id="par_id3152815" xml-lang="en-US"> +<emph>Start date</emph> is the date from when the calculation is carried out.</paragraph> +<paragraph role="paragraph" id="par_id3155817" xml-lang="en-US"> +<emph>End date</emph> is the date until the calculation is carried out. End date must be later, than Start date.</paragraph> +<paragraph role="paragraph" id="par_id3153183" xml-lang="en-US"> +<emph>Interval</emph> is a string that determines how the difference will be calculated. Possible values are "d", "m", "y", "ym", "md" or "yd" regardless of the current language settings.</paragraph> +<embed href="text/scalc/01/04060102.xhp#datenumberinfo"/> +<embed href="text/scalc/01/04060102.xhp#datenumberwarn"/> +<table id="tbl_id1342204"> +<tablerow> +<tablecell> +<paragraph role="tablehead" id="par_id5735953" xml-lang="en-US">Value for "Interval"<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">Return value</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph role="tablecontent" id="par_id9648731" xml-lang="en-US" localize="false">"d"</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablecontent" id="par_id908841" xml-lang="en-US">Number of whole days between Start date and End date.</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> + <paragraph role="tablecontent" id="par_id8193914" xml-lang="en-US" localize="false">"m"</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablecontent" id="par_id9841608" xml-lang="en-US">Number of whole months between Start date and End date.</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> + <paragraph role="tablecontent" id="par_id2701803" xml-lang="en-US" localize="false">"y"</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablecontent" id="par_id2136295" xml-lang="en-US">Number of whole years between Start date and End date.</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> + <paragraph role="tablecontent" id="par_id9200109" xml-lang="en-US" localize="false">"ym"</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablecontent" id="par_id4186223" xml-lang="en-US">Number of whole months when subtracting years from the difference of Start date and End date.</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> + <paragraph role="tablecontent" id="par_id5766472" xml-lang="en-US" localize="false">"md"</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablecontent" id="par_id1491134" xml-lang="en-US">Number of whole days when subtracting years and months from the difference of Start date and End date.</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> + <paragraph role="tablecontent" id="par_id5866472" xml-lang="en-US" localize="false">"yd"</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablecontent" id="par_id1591134" xml-lang="en-US">Number of whole days when subtracting years from the difference of Start date and End date.</paragraph> +</tablecell> +</tablerow> +</table> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph role="paragraph" id="par_id3152589" xml-lang="en-US"> +Birthday calculation. A man was born on 1974-04-17. Today is 2012-06-13.</paragraph> +<paragraph role="paragraph" id="par_id3252589" xml-lang="en-US"><item type="input">=DATEDIF("1974-04-17";"2012-06-13";"y")</item> yields 38.</paragraph> +<paragraph role="paragraph" id="par_id451535132395328" xml-lang="en-US"><item type="input">=DATEDIF("1974-04-17";"2012-06-13";"ym")</item> yields 1.</paragraph> +<paragraph role="paragraph" id="par_id611535132402642" xml-lang="en-US"><item type="input">=DATEDIF("1974-04-17";"2012-06-13";"md")</item> yields 27.</paragraph> +<paragraph role="paragraph" id="par_id511535132411940" xml-lang="en-US">So he is 38 years, 1 month and 27 days old.</paragraph> +<paragraph role="paragraph" id="par_id3352589" xml-lang="en-US"> +<item type="input">=DATEDIF(DATE(1974,4,17);"2012-06-13";"m")</item> yields 457, he has been living for 457 months.</paragraph> +<paragraph role="paragraph" id="par_id3452589" xml-lang="en-US"> +<item type="input">=DATEDIF("1974-04-17";"2012-06-13";"d")</item> yields 13937, he has been living for 13937 days.</paragraph> +<paragraph role="paragraph" id="par_id3752589" xml-lang="en-US"> +<item type="input">=DATEDIF("1974-04-17";DATE(2012;06;13);"yd")</item> yields 57, his birthday was 57 days ago.</paragraph> +<section id="relatedtopics"> + <embed href="text/scalc/01/04060102.xhp#datetimefunctions"/> +</section> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/func_datevalue.xhp b/helpcontent2/source/text/scalc/01/func_datevalue.xhp new file mode 100644 index 000000000..963c85926 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/func_datevalue.xhp @@ -0,0 +1,51 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> + +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . + --> + + +<meta> + <topic id="textscalc01func_datevaluexml" indexer="include" status="PUBLISH"> + <title xml-lang="en-US" id="tit">DATEVALUE </title> + <filename>/text/scalc/01/func_datevalue.xhp</filename> + </topic> +</meta> +<body> + <bookmark xml-lang="en-US" branch="index" id="bm_id3145621"> + <bookmark_value>DATEVALUE function</bookmark_value> + </bookmark> + <bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_DATWERT" id="bm_id3163820" localize="false"/> + <h1 id="hd_id3145621"><variable id="datevalue"><link href="text/scalc/01/func_datevalue.xhp">DATEVALUE</link></variable></h1> + <paragraph xml-lang="en-US" id="par_id3145087" role="paragraph"><ahelp hid="HID_FUNC_DATWERT">Returns the internal date number for text in quotes.</ahelp></paragraph> + <paragraph xml-lang="en-US" id="par_id3149281" role="paragraph">The internal date number is returned as a number. The number is determined by the date system that is used by $[officename] to calculate dates.</paragraph> + <paragraph xml-lang="en-US" id="par_id0119200903491982" role="paragraph">If the text string also includes a time value, DATEVALUE only returns the integer part of the conversion.</paragraph> + <embed href="text/scalc/01/ODFF.xhp#odff"/> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph xml-lang="en-US" id="par_id3149268" role="code">DATEVALUE("Text")</paragraph> + <paragraph xml-lang="en-US" id="par_id3154819" role="paragraph"><emph>Text</emph> is a valid date expression and must be entered with quotation marks.</paragraph> + <embed href="text/scalc/01/04060102.xhp#datenumberinfo"/> + <embed href="text/scalc/01/04060102.xhp#datenumberwarn"/> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph xml-lang="en-US" id="par_id3155841" role="paragraph"> + <item type="input">=DATEVALUE("1954-07-20")</item> yields 19925.</paragraph> + <section id="relatedtopics"> + <embed href="text/scalc/01/04060102.xhp#datetimefunctions"/> + </section> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/func_day.xhp b/helpcontent2/source/text/scalc/01/func_day.xhp new file mode 100644 index 000000000..33804020e --- /dev/null +++ b/helpcontent2/source/text/scalc/01/func_day.xhp @@ -0,0 +1,46 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . + --> +<helpdocument version="1.0"> +<meta> +<topic id="textscalc01func_dayxml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">DAY </title> +<filename>/text/scalc/01/func_day.xhp</filename> +</topic> +</meta> +<body> +<bookmark xml-lang="en-US" branch="index" id="bm_id3147317"><bookmark_value>DAY function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_TAG" id="bm_id3151283" localize="false"/><h2 id="hd_id3147317"><variable id="day"><link href="text/scalc/01/func_day.xhp">DAY</link> +</variable></h2> +<paragraph role="paragraph" id="par_id3147584" xml-lang="en-US"><ahelp hid="HID_FUNC_TAG">Returns the day of given date value.</ahelp> The day is returned as an integer between 1 and 31. You can also enter a negative date/time value.</paragraph> +<embed href="text/scalc/01/ODFF.xhp#odff"/> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph role="code" id="par_id3149430" xml-lang="en-US">DAY(Number)</paragraph> +<paragraph role="paragraph" id="par_id3149443" xml-lang="en-US"><emph>Number</emph> is the internal date number.</paragraph> +<embed href="text/scalc/01/04060102.xhp#datenumberinfo"/> +<embed href="text/scalc/01/04060102.xhp#datenumberwarn"/> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph role="paragraph" id="par_id3151200" xml-lang="en-US"><item type="input">=DAY(1)</item> returns 31 (since $[officename] starts counting at zero from December 30, 1899)</paragraph> +<paragraph role="paragraph" id="par_id3154130" xml-lang="en-US"><item type="input">=DAY(NOW())</item> returns the current day.</paragraph> +<paragraph role="paragraph" id="par_id3159190" xml-lang="en-US"><item type="input">=DAY(C4)</item> returns 5 if you enter 1901-08-05 in cell C4 (the date value might get formatted differently after you press Enter).</paragraph> +<section id="relatedtopics"> + <embed href="text/scalc/01/04060102.xhp#datetimefunctions"/> +</section> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/func_days.xhp b/helpcontent2/source/text/scalc/01/func_days.xhp new file mode 100644 index 000000000..fb50701a7 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/func_days.xhp @@ -0,0 +1,46 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . + --> +<helpdocument version="1.0"> +<meta> +<topic id="textscalc01func_daysxml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">DAYS </title> +<filename>/text/scalc/01/func_days.xhp</filename> +</topic> +</meta> +<body> +<bookmark xml-lang="en-US" branch="index" id="bm_id3151328"><bookmark_value>DAYS function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_TAGE" id="bm_id3148893" localize="false"/><h2 id="hd_id3151328"><variable id="days"><link href="text/scalc/01/func_days.xhp">DAYS</link> +</variable></h2> +<paragraph role="paragraph" id="par_id3155139" xml-lang="en-US"><ahelp hid="HID_FUNC_TAGE">Calculates the difference between two date values.</ahelp> The result returns the number of days between the two days.</paragraph> +<embed href="text/scalc/01/ODFF.xhp#odff"/> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph role="code" id="par_id3149578" xml-lang="en-US">DAYS(Date2; Date1)</paragraph> +<paragraph role="paragraph" id="par_id3151376" xml-lang="en-US"> +<emph>Date1</emph> is the start date, <emph>Date2</emph> is the end date. If <emph>Date2</emph> is an earlier date than <emph>Date1</emph> the result is a negative number.</paragraph> +<embed href="text/scalc/01/04060102.xhp#datenumberinfo"/> +<embed href="text/scalc/01/04060102.xhp#datenumberwarn"/> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph role="paragraph" id="par_id3159101" xml-lang="en-US"><item type="input">=DAYS(NOW();"2010-01-01"))</item> returns the number of days from January 1, 2010 until today.</paragraph> +<paragraph role="paragraph" id="par_id3163720" xml-lang="en-US"><item type="input">=DAYS("1990-10-10";"1980-10-10")</item> returns 3652 days.</paragraph> +<section id="relatedtopics"> + <embed href="text/scalc/01/04060102.xhp#datetimefunctions"/> +</section> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/func_days360.xhp b/helpcontent2/source/text/scalc/01/func_days360.xhp new file mode 100644 index 000000000..822d7f44f --- /dev/null +++ b/helpcontent2/source/text/scalc/01/func_days360.xhp @@ -0,0 +1,45 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . + --> +<helpdocument version="1.0"> +<meta> +<topic id="textscalc01func_days360xml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">DAYS360 </title> +<filename>/text/scalc/01/func_days360.xhp</filename> +</topic> +</meta> +<body> +<bookmark xml-lang="en-US" branch="index" id="bm_id3148555"><bookmark_value>DAYS360 function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_TAGE360" id="bm_id3155906" localize="false"/><h2 id="hd_id3148555"><variable id="days360"><link href="text/scalc/01/func_days360.xhp">DAYS360</link> +</variable></h2> +<paragraph role="paragraph" id="par_id3156032" xml-lang="en-US"><ahelp hid="HID_FUNC_TAGE360">Returns the difference between two dates based on the 360 day year used in interest calculations.</ahelp></paragraph> +<embed href="text/scalc/01/ODFF.xhp#odff"/> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph role="code" id="par_id3155313" xml-lang="en-US">DAYS360(Date1; Date2[; Type])</paragraph> +<paragraph role="paragraph" id="par_id3145263" xml-lang="en-US">If <emph>Date2</emph> is earlier than <emph>Date1</emph>, the function will return a negative number.</paragraph> +<paragraph role="paragraph" id="par_id3151064" xml-lang="en-US">The optional argument <emph>Type</emph> determines the type of difference calculation. If Type = 0 or if the argument is missing, the US method (NASD, National Association of Securities Dealers) is used. If Type <> 0, the European method is used.</paragraph> +<embed href="text/scalc/01/04060102.xhp#datenumberinfo"/> +<embed href="text/scalc/01/04060102.xhp#datenumberwarn"/> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph role="paragraph" id="par_id3156348" xml-lang="en-US"><item type="input">=DAYS360("2000-01-01";NOW())</item> returns the number of interest days from January 1, 2000 until today.</paragraph> +<section id="relatedtopics"> + <embed href="text/scalc/01/04060102.xhp#datetimefunctions"/> +</section> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/func_eastersunday.xhp b/helpcontent2/source/text/scalc/01/func_eastersunday.xhp new file mode 100644 index 000000000..8227311c4 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/func_eastersunday.xhp @@ -0,0 +1,50 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . + --> +<helpdocument version="1.0"> +<meta> +<topic id="textscalc01func_eastersundayxml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">EASTERSUNDAY</title> +<filename>/text/scalc/01/func_eastersunday.xhp</filename> +</topic> +</meta> +<body> +<bookmark xml-lang="en-US" branch="index" id="bm_id3152960"><bookmark_value>EASTERSUNDAY function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_OSTERSONNTAG" id="bm_id3156270" localize="false"/><h2 id="hd_id3152960"><variable id="eastersunday"><link href="text/scalc/01/func_eastersunday.xhp">EASTERSUNDAY</link> +</variable></h2> +<paragraph role="paragraph" id="par_id3154570" xml-lang="en-US"><ahelp hid="HID_FUNC_OSTERSONNTAG">Returns the date of Easter Sunday for the entered year.</ahelp></paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph role="code" id="par_id2113711" xml-lang="en-US">EASTERSUNDAY(Year)</paragraph> +<paragraph role="paragraph" id="par_id3938413" xml-lang="en-US"> +<emph>Year</emph> is an integer between 1583 and 9956 or 0 and 99. You can also calculate other holidays by simple addition with this date.</paragraph> +<paragraph role="paragraph" id="par_id3156156" xml-lang="en-US">Easter Monday = EASTERSUNDAY(Year) + 1</paragraph> +<paragraph role="paragraph" id="par_id3147521" xml-lang="en-US">Good Friday = EASTERSUNDAY(Year) - 2</paragraph> +<paragraph role="paragraph" id="par_id3146072" xml-lang="en-US">Pentecost Sunday = EASTERSUNDAY(Year) + 49</paragraph> +<paragraph role="paragraph" id="par_id3149553" xml-lang="en-US">Pentecost Monday = EASTERSUNDAY(Year) + 50</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph role="paragraph" id="par_id3154472" xml-lang="en-US"><item type="input">=EASTERSUNDAY(2000)</item> returns 2000-04-23.</paragraph> +<paragraph role="paragraph" id="par_id3150940" xml-lang="en-US"><item type="input">=EASTERSUNDAY(2000)+49</item> returns the internal serial number 36688. The result is 2000-06-11. Format the serial date number as a date, for example in the format YYYY-MM-DD.</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectiontechinfo"/> +<embed href="text/scalc/01/common_func.xhp#notODFF"/> +<paragraph role="paragraph" id="par_id311640873986703" localize="false"><literal>ORG.OPENOFFICE.EASTERSUNDAY</literal></paragraph> +<section id="relatedtopics"> + <embed href="text/scalc/01/04060102.xhp#datetimefunctions"/> +</section> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/func_edate.xhp b/helpcontent2/source/text/scalc/01/func_edate.xhp new file mode 100644 index 000000000..14b050236 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/func_edate.xhp @@ -0,0 +1,49 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . + --> +<helpdocument version="1.0"> +<meta> +<topic id="textscalc01func_edatexml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">EDATE</title> +<filename>/text/scalc/01/func_edate.xhp</filename> +</topic> +</meta> +<body> +<bookmark xml-lang="en-US" branch="index" id="bm_id3151184"><bookmark_value>EDATE function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_EDATE" id="bm_id3150761" localize="false"/><h2 id="hd_id3151184"><variable id="edate"><link href="text/scalc/01/func_edate.xhp">EDATE</link> +</variable></h2> +<paragraph role="paragraph" id="par_id3150880" xml-lang="en-US"><ahelp hid="HID_AAI_FUNC_EDATE">The result is a date which is a number of <emph>months</emph> away from the <emph>start date</emph>. Only months are considered; days are not used for calculation.</ahelp></paragraph> +<embed href="text/scalc/01/ODFF.xhp#odff"/> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph role="code" id="par_id3153212" xml-lang="en-US">EDATE(StartDate; Months)</paragraph> +<paragraph role="paragraph" id="par_id3146860" xml-lang="en-US"> +<emph>StartDate</emph> is a date.</paragraph> +<paragraph role="paragraph" id="par_id3152929" xml-lang="en-US"> +<emph>Months</emph> is the number of months before (negative) or after (positive) the start date.</paragraph> +<embed href="text/scalc/01/04060102.xhp#datenumberinfo"/> +<embed href="text/scalc/01/04060102.xhp#datenumberwarn"/> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph role="paragraph" id="par_id3155845" xml-lang="en-US">What date is one month prior to 2001-03-31?</paragraph> +<paragraph role="paragraph" id="par_id3155999" xml-lang="en-US"> +<item type="input">=EDATE("2001-03-31";-1)</item> returns the serial number 36950. Formatted as a date, this is 2001-02-28.</paragraph> +<section id="relatedtopics"> + <embed href="text/scalc/01/04060102.xhp#datetimefunctions"/> +</section> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/func_eomonth.xhp b/helpcontent2/source/text/scalc/01/func_eomonth.xhp new file mode 100644 index 000000000..74d3af592 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/func_eomonth.xhp @@ -0,0 +1,49 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . + --> +<helpdocument version="1.0"> +<meta> +<topic id="textscalc01func_eomonthxml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">EOMONTH</title> +<filename>/text/scalc/01/func_eomonth.xhp</filename> +</topic> +</meta> +<body> +<bookmark xml-lang="en-US" branch="index" id="bm_id3150991"><bookmark_value>EOMONTH function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_EOMONTH" id="bm_id3158439" localize="false"/><h2 id="hd_id3150991"><variable id="eomonth"><link href="text/scalc/01/func_eomonth.xhp">EOMONTH</link> +</variable></h2> +<paragraph role="paragraph" id="par_id3152766" xml-lang="en-US"><ahelp hid="HID_AAI_FUNC_EOMONTH">Returns the date of the last day of a month which falls months away from the start date.</ahelp></paragraph> +<embed href="text/scalc/01/ODFF.xhp#odff"/> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph role="code" id="par_id3150351" xml-lang="en-US">EOMONTH(StartDate; Months)</paragraph> +<paragraph role="paragraph" id="par_id3146787" xml-lang="en-US"> +<emph>StartDate</emph> is a date (the starting point of the calculation).</paragraph> +<paragraph role="paragraph" id="par_id3155615" xml-lang="en-US"> +<emph>Months</emph> is the number of months before (negative) or after (positive) the start date.</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph role="paragraph" id="par_id3154829" xml-lang="en-US">What is the last day of the month that falls 6 months after September 14 2001?</paragraph> + +<paragraph role="paragraph" id="par_id3156143" xml-lang="en-US"><item type="input">=EOMONTH(DATE(2001;9;14);6)</item> returns the serial number 37346. Formatted as a date, this is 2002-03-31.</paragraph> +<paragraph role="paragraph" id="par_id3156144" xml-lang="en-US"><item type="input">=EOMONTH("2001-09-14";6)</item> works as well. If you specify the date directly, we recommend using the standard ISO 8601 format because this should be independent of your selected locale settings.</paragraph> +<section id="relatedtopics"> + <paragraph role="paragraph" id="par_id681621540307527"><link href="https://wiki.documentfoundation.org/Documentation/Calc_Functions/EOMONTH">EOMONTH wiki page</link></paragraph> + <embed href="text/scalc/01/04060102.xhp#datetimefunctions"/> +</section> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/func_error_type.xhp b/helpcontent2/source/text/scalc/01/func_error_type.xhp new file mode 100644 index 000000000..a1e92361d --- /dev/null +++ b/helpcontent2/source/text/scalc/01/func_error_type.xhp @@ -0,0 +1,129 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * +--> + +<meta> + <topic id="textscalc01func_error_typexml"> + <title id="tit" xml-lang="en-US">ERROR.TYPE function</title> + <filename>/text/scalc/01/func_error_type.xhp</filename> + </topic> +</meta> + +<body> + +<section id="error_type_function"> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_ERROR_TYPE_ODF" id="bm_id346023460234602" localize="false"/> +<bookmark xml-lang="en-US" branch="index" id="bm_id346793467934679"> + <bookmark_value>ERROR.TYPE function</bookmark_value> + <bookmark_value>index of the Error type</bookmark_value> +</bookmark> + +<paragraph id="hd_id348223482234822" role="heading" level="2" xml-lang="en-US"><variable id="error_type_head"><link href="text/scalc/01/func_error_type.xhp">ERROR.TYPE</link></variable> function</paragraph> +<paragraph id="par_id350283502835028" role="paragraph" xml-lang="en-US"><ahelp hid="."><variable id="error_type_des">Returns a number representing a specific Error type, or the error value #N/A, if there is no error. </variable></ahelp></paragraph> +</section> +<embed href="text/scalc/00/avail_release.xhp#5.0"/> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id1861223540440" role="code" xml-lang="en-US">ERROR.TYPE(Error_value)</paragraph> +<paragraph id="par_id217737315" role="paragraph" xml-lang="en-US"><emph>Error_value</emph> – required argument. The error value or a reference to a cell, whose value needs to be processed.</paragraph> + +<table id="func_error_type_des_table"> + <tablerow> + <tablecell> + <paragraph id="par_id15254419018421" role="tablehead" xml-lang="en-US">Error value</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id134093102310948" role="tablehead" xml-lang="en-US">Returns</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id121020152053105891" role="tablecontent" xml-lang="en-US">Err:511</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id121020152052446273" role="tablecontent" localize="false" xml-lang="en-US">1</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id121020152053148760" role="tablecontent" xml-lang="en-US">#DIV/0!</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id121020152052481542" role="tablecontent" localize="false" xml-lang="en-US">2</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id121020152053296785" role="tablecontent" xml-lang="en-US">#VALUE!</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id121020152052517316" role="tablecontent" localize="false" xml-lang="en-US">3</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id121020152053329868" role="tablecontent" xml-lang="en-US">#REF!</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id121020152052546364" role="tablecontent" localize="false" xml-lang="en-US">4</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id121020152053353976" role="tablecontent" xml-lang="en-US">#NAME?</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id121020152052574920" role="tablecontent" localize="false" xml-lang="en-US">5</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id121020152053408216" role="tablecontent" xml-lang="en-US">#NUM!</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id121020152052596412" role="tablecontent" localize="false" xml-lang="en-US">6</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id121020152054007072" role="tablecontent" xml-lang="en-US">#N/A</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id121020152053027085" role="tablecontent" localize="false" xml-lang="en-US">7</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id121020152054075191" role="tablecontent" xml-lang="en-US">Anything else</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id121020152054075192" role="tablecontent" xml-lang="en-US">#N/A</paragraph> + </tablecell> + </tablerow> +</table> +<embed href="text/scalc/01/ODFF.xhp#odff"/> + +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="hd_id182972884627444" role="heading" level="4" xml-lang="en-US">Simple usage</paragraph> +<paragraph id="par_id15812966716957" role="paragraph" xml-lang="en-US"><item type="input">=ERROR.TYPE(#N/A)</item></paragraph> +<paragraph id="par_id280533214928308" role="paragraph" xml-lang="en-US">Returns 7, because 7 is the index number of the error value #N/A.</paragraph> +<paragraph id="par_id1047088636291" role="paragraph" xml-lang="en-US"><item type="input">=ERROR.TYPE(A3)</item></paragraph> +<paragraph id="par_id24308515918391" role="paragraph" xml-lang="en-US">If A3 contains an expression equivalent to the division by zero, the function returns 2, because 2 is the index number of the error value #DIV/0!</paragraph> +<paragraph id="hd_id9842206115046" role="heading" level="4" xml-lang="en-US">More advanced way</paragraph> +<paragraph id="par_id90121141327448" role="paragraph" xml-lang="en-US">If in division A1 by A2, A2 can turn to zero, you can handle the situation as follows:</paragraph> +<paragraph id="par_id16083887218317" role="paragraph" xml-lang="en-US"><item type="input">=IF(ISERROR(A1/A2);IF(ERROR.TYPE(A1/A2)=2;"the denominator can't be equal to zero");A1/A2)</item></paragraph> +<paragraph id="par_id12475201719494" role="paragraph" xml-lang="en-US">The ISERROR function returns TRUE or FALSE depending on whether there is an error or not. If the error takes place, the function IF addresses to the second argument, if there is no error, it returns the result of the division. The second argument checks the index number representing the specific Error type, and if it is equal to 2, it returns the specified text "the denominator can't be zero" or 0 otherwise. Thus, clear text would signify the division by zero, the result of the division would appear when the division is successful, or if there is, for example, an error of another type, zero would be returned.</paragraph> +<paragraph id="par_id26251175451270" role="warning" xml-lang="en-US">If the ERROR.TYPE function is used as condition of the IF function and the ERROR.TYPE returns #N/A, the IF function returns #N/A as well. Use ISERROR to avoid it as shown in the example above.</paragraph> +<section id="relatedtopics"> +<paragraph id="par_id352953529535295" role="paragraph" xml-lang="en-US"><link href="text/scalc/01/04060104.xhp#iserror">ISERROR</link>, <link href="text/scalc/01/04060104.xhp#na">NA</link>, <link href="text/scalc/01/04060104.xhp#Section4">IF</link></paragraph> +<paragraph id="par_id312932390024933" role="paragraph" xml-lang="en-US"><link href="text/scalc/05/02140000.xhp" name="Error codes">Error codes</link></paragraph> +</section> +</body> + +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/func_findb.xhp b/helpcontent2/source/text/scalc/01/func_findb.xhp new file mode 100644 index 000000000..e28e5e971 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/func_findb.xhp @@ -0,0 +1,45 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> + <!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + --> + + <meta> + <topic id="functionfindb" indexer="include" status="PUBLISH"> + <title id="tit" xml-lang="en-US">FINDB Function</title> + <filename>/text/scalc/01/func_findb.xhp</filename> + </topic> + </meta> + <body> + <section id="findbh1"> + <bookmark id="bm_id461573508637964" xml-lang="en-US" branch="hid/SC_HID_FUNC_FINDB" localize="false"/> + <bookmark xml-lang="en-US" branch="index" id="bm_id141573508995071"> + <bookmark_value>FINDB Function</bookmark_value> + <bookmark_value>find text;FINDB Function</bookmark_value> + </bookmark> + <h1 id="hd_id771573508637966"><variable id="findb"><link href="text/scalc/01/func_findb.xhp" name="findb">FINDB</link></variable></h1> + <paragraph id="par_id831573508637970" role="paragraph" xml-lang="en-US"><variable id="variable name"><ahelp hid=".">Returns the starting position of a given text, using byte positions. FINDB is case sensitive.</ahelp></variable></paragraph> + </section> + <embed href="text/scalc/00/avail_release.xhp#6.0"/> + <embed href="text/scalc/01/ful_func.xhp#func_head_syntax"/> + <paragraph role="code" id="par_id221573517641172">FINDB(Find Text ; Text [; Position])</paragraph> + <paragraph role="paragraph" id="par_id241573517292388"><emph>Find Text</emph>: The text or text expression to be found.</paragraph> + <paragraph role="paragraph" id="par_id991573517299918"><emph>Text</emph>: the text in which the search is to be made.</paragraph> + <paragraph role="paragraph" id="par_id521573517305077"><emph>Position</emph>: The position in the text where the search starts.</paragraph> + <embed href="text/scalc/01/ful_func.xhp#func_head_example"/> + <paragraph role="paragraph" id="par_id481573517830373"><input>=FINDB("a"; "LibreOffice Calc")</input> returns 15. The <emph>Find Text</emph> argument is a text string that comprises a full-width, double-byte "a" character, while the <emph>Text</emph> argument comprises 12 single-byte characters followed by four full-width, double-byte characters.</paragraph> + <section id="relatedtopics"> + <paragraph role="paragraph" localize="false" id="par_id961573510093188"><embedvar href="text/scalc/01/func_replaceb.xhp#replaceb" markup="ignore"/></paragraph> + <paragraph role="paragraph" localize="false" id="par_id831573510098350"><embedvar href="text/scalc/01/func_searchb.xhp#searchb" markup="ignore"/></paragraph> + <paragraph role="paragraph" localize="false" id="par_id251573510740369"><embedvar href="text/scalc/01/04060110.xhp#lenbvar" markup="ignore"/></paragraph> + <paragraph role="paragraph" localize="false" id="par_id121573511036023"><embedvar href="text/scalc/01/04060110.xhp#leftbvar" markup="ignore"/></paragraph> + <paragraph role="paragraph" localize="false" id="par_id591573511169353"><embedvar href="text/scalc/01/04060110.xhp#rightbvar" markup="ignore"/></paragraph> + <paragraph role="paragraph" localize="false" id="par_id381573511326662"><embedvar href="text/scalc/01/04060110.xhp#midbvar" markup="ignore"/></paragraph> + </section> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/func_floor.xhp b/helpcontent2/source/text/scalc/01/func_floor.xhp new file mode 100644 index 000000000..044fee3e2 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/func_floor.xhp @@ -0,0 +1,132 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> + <!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + --> + <meta> + <topic id="scalcfloorfunctions" indexer="include" status="PUBLISH"> + <title id="tit" xml-lang="en-US">FLOOR Functions</title> + <filename>/text/scalc/01/func_floor.xhp</filename> + </topic> + </meta> + <body> + <h1 id="hd_id391586285373874">FLOOR Functions</h1> + <section id="floor"> +<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"/> + <h2 id="hd_id3157404"><variable id="FLOORh1"><link href="text/scalc/01/func_floor.xhp#floor" name="FLOOR">FLOOR</link></variable></h2> + <paragraph id="par_id3157432" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_UNTERGRENZE">Rounds a number to the nearest multiple of a significance value.</ahelp></paragraph> + <paragraph role="paragraph" id="par_id661586285977707">For a positive number and a positive significance value, the function rounds down (towards zero). For a negative number and a negative significance value, the direction of rounding is determined by the value of a mode parameter. The function returns an error if the number and significance values have opposite signs.</paragraph> + <section id="floor_warn"> + <warning id="par_id3163894">If the spreadsheet is exported to Microsoft Excel, the FLOOR function is exported as the equivalent FLOOR.MATH function that has existed since Excel 2013. If you plan to use the spreadsheet with earlier Excel versions, use either FLOOR.PRECISE that has existed since Excel 2010, or FLOOR.XCL that is exported as the FLOOR function compatible with all Excel versions.</warning> + </section> + + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph id="par_id3157464" role="code" xml-lang="en-US">FLOOR(Number[; Significance[; Mode]])</paragraph> + <section id="argnumber"> + <paragraph id="par_id3153467" role="paragraph" xml-lang="en-US"><emph>Number</emph> is the number that is to be rounded, or a reference to a cell containing the number.</paragraph> + </section> + <paragraph id="par_id3157497" role="paragraph" xml-lang="en-US"><emph>Significance</emph> (optional) is the value, or a reference to a cell containing the value, to whose multiple <emph>Number</emph> is to be rounded. It defaults to +1 or -1 depending on the sign of <emph>Number</emph>.</paragraph> + <paragraph id="par_id3157517" role="paragraph" xml-lang="en-US"><emph>Mode</emph> (optional) is a number, or a reference to a cell containing a number. The function only uses <emph>Mode</emph> if both <emph>Number</emph> and <emph>Significance</emph> are negative. Then if <emph>Mode</emph> is given and not equal to zero, numbers are rounded up (towards zero); if <emph>Mode</emph> is equal to zero or not given, negative numbers are rounded down (away from zero).</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph role="paragraph" id="par_id761586287595376"><input>=FLOOR(3.45)</input> returns 3.</paragraph> + <paragraph role="paragraph" id="par_id311586287600048"><input>=FLOOR(3.45, 3)</input> returns 3.</paragraph> + <paragraph role="paragraph" id="par_id661586287604519"><input>=FLOOR(-1.234)</input> returns -2.</paragraph> + <paragraph role="paragraph" id="par_id741586287608968"><input>=FLOOR(-45.67, -2, 0)</input> returns -46.</paragraph> + <paragraph role="paragraph" id="par_id431586287616089"><input>=FLOOR(-45.67, -2, 1)</input> returns -44.</paragraph> + <comment>see also CEILING, EVEN, ODD, MROUND, INT, TRUNC, ROUND, ROUNDDOWN, ROUNDUP</comment> + </section> + + <section id="floormath"> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_FLOOR_MATH" id="bm_id3167415" localize="false"/> +<bookmark xml-lang="en-US" branch="index" id="bm_id811586290952465"> +<bookmark_value>FLOOR.MATH function</bookmark_value> +</bookmark> +<h2 id="hd_id1001586287279297"><variable id="FLOOR.MATHh1"><link href="text/scalc/01/func_floor.xhp#floormath" name="FLOOR.MATH">FLOOR.MATH</link></variable></h2> + <paragraph role="paragraph" id="par_id721586287302689">Rounds a number to the nearest multiple of a significance value.</paragraph> + <paragraph role="paragraph" id="par_id311586287323417">For a positive number the function rounds down (towards zero). For a negative number, the direction of rounding is determined by the value of a mode parameter. The sign of the significance value is ignored.</paragraph> + <warning id="par_id851586287535879">This function exists for interoperability with Microsoft Excel 2013 or newer.</warning> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph role="code" id="par_id161586287421523">FLOOR.MATH(Number[; Significance[; Mode]])</paragraph> + <embed href="text/scalc/01/func_floor.xhp#argnumber"/> + <paragraph role="paragraph" id="par_id231586287448716"><emph>Significance</emph> (optional) is the value, or a reference to a cell containing the value, to whose multiple <emph>Number</emph> is to be rounded. It defaults to 1.</paragraph> + <paragraph role="paragraph" id="par_id261586287494401"><emph>Mode</emph> (optional) is a number, or a reference to a cell containing a number. If <emph>Mode</emph> is given and not equal to zero, a negative <emph>Number</emph> is rounded up (towards zero). If <emph>Mode</emph> is equal to zero or is not given, a negative <emph>Number</emph> is rounded down (away from zero).</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph role="paragraph" id="par_id101586287621816"><input>=FLOOR.MATH(3.45)</input> returns 3.</paragraph> + <paragraph role="paragraph" id="par_id771586287627784"><input>=FLOOR.MATH(3.45,-3)</input> returns 3.</paragraph> + <paragraph role="paragraph" id="par_id981586287632392"><input>=FLOOR.MATH(-1.234)</input> returns -2.</paragraph> + <paragraph role="paragraph" id="par_id631586287637256"><input>=FLOOR.MATH(-45.67,-2, 0)</input> returns -46.</paragraph> + <paragraph role="paragraph" id="par_id371586287641888"><input>=FLOOR.MATH(-45.67,+2, 1)</input> returns -44.</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectiontechinfo"/> + <embed href="text/scalc/00/avail_release.xhp#5.0"/> + <embed href="text/scalc/01/common_func.xhp#notODFF"/> + <paragraph role="paragraph" id="par_id541640873986703" localize="false"><literal>COM.MICROSOFT.FLOOR.MATH</literal></paragraph> + </section> + + <section id="floorprecise"> +<bookmark xml-lang="en-US" branch="index" id="bm_id2957404"> +<bookmark_value>FLOOR.PRECISE 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_FLOOR_MS" id="bm_id2957415" localize="false"/> + <bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_FLOOR_PRECISE" id="bm_id2957215" localize="false"/> + + <h2 id="hd_id2957404"><variable id="FLOOR.PRECISEh1"><link href="text/scalc/01/func_floor.xhp#floorprecise" name="FLOOR.PRECISE">FLOOR.PRECISE</link></variable></h2> + <paragraph id="par_id2957432" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_FLOOR_MS">Rounds a number down to the nearest multiple of a significance value.</ahelp></paragraph> + <paragraph role="paragraph" id="par_id261586641501175">For a positive number the function rounds down (towards zero). For a negative number, the function rounds down (away form zero). The sign of the significance value is ignored.</paragraph> + <embed href="text/scalc/01/func_floor.xhp#floor_warn"/> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph id="par_id2957464" role="code" xml-lang="en-US">FLOOR.PRECISE(Number[; Significance])</paragraph> + <embed href="text/scalc/01/func_floor.xhp#argnumber"/> + <paragraph id="par_id2957497" role="paragraph" xml-lang="en-US"><emph>Significance</emph> (optional) is the value, or a reference to a cell containing the value, to whose multiple <emph>Number</emph> is to be rounded. It defaults to 1.</paragraph> + + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph role="paragraph" id="par_id981586291388900"><input>=FLOOR.PRECISE(3.45)</input> returns 3.</paragraph> + <paragraph role="paragraph" id="par_id831586291395477"><input>=FLOOR.PRECISE(-45.67,2)</input> returns -46.</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectiontechinfo"/> + <embed href="text/scalc/00/avail_release.xhp#4.3"/> + <embed href="text/scalc/01/common_func.xhp#notODFF"/> + <paragraph role="paragraph" id="par_id341650873986703" localize="false"><literal>COM.MICROSOFT.FLOOR.PRECISE</literal></paragraph> + <comment>see also CEILING, EVEN, ODD, MROUND,INT, TRUNC, ROUND, ROUNDDOWN, ROUNDUP</comment> + </section> + + <section id="floorxcl"> +<bookmark xml-lang="en-US" branch="index" id="bm_id171586291849333"> +<bookmark_value>FLOOR.XCL function</bookmark_value> +</bookmark> +<h2 id="hd_id791586291468176"><variable id="FLOOR.XCLh1"><link href="text/scalc/01/func_floor.xhp#floorxcl" name="FLOOR.XCL">FLOOR.XCL</link></variable></h2> + <paragraph role="paragraph" id="par_id521586291476023">Rounds a number to the nearest multiple of a significance value.</paragraph> + <paragraph role="paragraph" id="par_id401586291488768">For a positive number and a positive significance value, the function rounds down (towards zero). For a negative number and a positive significance value, the function rounds down (away from zero). For a negative number and a negative significance value, the function rounds up (towards zero). The function returns an error if the number is positive and the significance value is negative.</paragraph> + <warning id="par_id231586291503319">This function exists for interoperability with Microsoft Excel 2007 or older. If a Calc spreadsheet is exported to Microsoft Excel, references to Calc’s FLOOR.XCL function are exported as references to Excel’s FLOOR function, which is compatible with all Excel versions. If a Microsoft Excel spreadsheet is imported into Calc, references to Excel’s FLOOR function are imported as references to Calc’s FLOOR.XCL function.</warning> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph role="code" id="par_id491586291532177">FLOOR.XCL(Number; Significance)</paragraph> + <embed href="text/scalc/01/func_floor.xhp#argnumber"/> + <paragraph role="paragraph" id="par_id761586291578755"><emph>Significance</emph> is the value, or a reference to a cell containing the value, to whose multiple <emph>Number</emph> is to be rounded.</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph role="paragraph" id="par_id531586291622306"><input>=FLOOR.XCL(3.45,2)</input> returns 2.</paragraph> + <paragraph role="paragraph" id="par_id361586291628003"><input>=FLOOR.XCL(-45.67,2)</input> returns -46.</paragraph> + <paragraph role="paragraph" id="par_id801586291641099"><input>=FLOOR.XCL(-45.67,-2)</input> returns -44.</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectiontechinfo"/> + <embed href="text/scalc/00/avail_release.xhp#5.0"/> + <embed href="text/scalc/01/common_func.xhp#notODFF"/> + <paragraph role="paragraph" id="par_id341640873978703" localize="false"><literal>COM.MICROSOFT.FLOOR</literal></paragraph> + </section> + <section id="relatedtopics"> + <embed href="text/scalc/01/func_ceiling.xhp#CEILINGh1"/> + <embed href="text/scalc/01/func_ceiling.xhp#CEILING.MATHh1"/> + <embed href="text/scalc/01/func_ceiling.xhp#CEILING.PRECISEh1"/> + <embed href="text/scalc/01/func_ceiling.xhp#CEILING.XCLh1"/> + <embed href="text/scalc/01/func_ceiling.xhp#ISO.CEILINGh1"/> + </section> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/func_forecastetsadd.xhp b/helpcontent2/source/text/scalc/01/func_forecastetsadd.xhp new file mode 100644 index 000000000..bc981239e --- /dev/null +++ b/helpcontent2/source/text/scalc/01/func_forecastetsadd.xhp @@ -0,0 +1,64 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. +--> + +<meta> + <topic id="textscalc01func_forecastetsaddxml"> + <title id="tit" xml-lang="en-US">FORECAST.ETS.ADD</title> + <filename>/text/scalc/01/func_forecastetsadd.xhp</filename> + </topic> +</meta> + +<body> + +<section id="function_forecastetsadd"> + <bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_FORECAST_ETS_ADD" id="bm_id0603201610024692" localize="false"/> + <bookmark xml-lang="en-US" branch="index" id="bm_id976559765597655"> +<bookmark_value>FORECAST.ETS.ADD function</bookmark_value> +</bookmark> + +<h1 id="hd_id0603201610022291"><link href="text/scalc/01/func_forecastetsadd.xhp">FORECAST.ETS.ADD function</link></h1> +<paragraph id="par_id0603201610023949" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_FORECAST_ETS_ADD">Calculates the additive forecast(s) (future values) based on the historical data using ETS or EDS algorithms</ahelp>. EDS is used when argument <emph>period_length</emph> is 0, otherwise ETS is used.</paragraph> +<embed href="text/scalc/01/exponsmooth_embd.xhp#intro"/> +<paragraph id="par_id0603201608440530" role="paragraph" xml-lang="en-US">FORECAST.ETS.ADD calculates with the model</paragraph> +<embed href="text/scalc/01/exponsmooth_embd.xhp#etsadd"/> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id0403201618594544" role="code" xml-lang="en-US">FORECAST.ETS.ADD(targets, values, timeline, [period_length], [data_completion], [aggregation]) </paragraph> +<embed href="text/scalc/01/exponsmooth_embd.xhp#target"/> +<embed href="text/scalc/01/exponsmooth_embd.xhp#values"/> +<embed href="text/scalc/01/exponsmooth_embd.xhp#timeline"/> +<embed href="text/scalc/01/exponsmooth_embd.xhp#numsampperiod"/> +<embed href="text/scalc/01/exponsmooth_embd.xhp#datacompletion"/> +<embed href="text/scalc/01/exponsmooth_embd.xhp#aggregation"/> + +<embed href="text/scalc/01/exponsmooth_embd.xhp#exampledata"/> + <paragraph id="hd_id04032016185123" role="code" xml-lang="en-US">=FORECAST.ETS.ADD(DATE(2014;1;1);Values;Timeline;1;TRUE();1)</paragraph> + <paragraph id="hd_id04032016112394554" role="paragraph" xml-lang="en-US">Returns 157.166666666667, the additive forecast for January 2014 based on <emph>Values</emph> and <emph>Timeline</emph> named ranges above, with one sample per period, no missing data, and AVERAGE as aggregation.</paragraph> + <paragraph id="hd_id04032123185123" role="code" xml-lang="en-US">=FORECAST.ETS.ADD(DATE(2014;1;1);Values;Timeline;4;TRUE();7)</paragraph> + <paragraph id="hd_id040312316112394554" role="paragraph" xml-lang="en-US">Returns 113.251442038722, the additive forecast for January 2014 based on <emph>Values</emph> and <emph>Timeline</emph> named ranges above, with period length of 4, no missing data, and SUM as aggregation.</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectiontechinfo"/> +<embed href="text/scalc/00/avail_release.xhp#5.2"/> +<embed href="text/scalc/01/common_func.xhp#notODFF"/> +<paragraph role="paragraph" id="par_id341640873986703" localize="false"><literal>COM.MICROSOFT.FORECAST.ETS</literal></paragraph> +</section> +<section id="relatedtopics"> +<paragraph id="par_id0603201619261276" role="paragraph" xml-lang="en-US">See also: + <link href="text/scalc/01/func_forecastetsmult.xhp">FORECAST.ETS.MULT</link>, + <link href="text/scalc/01/func_forecastetsstatadd.xhp">FORECAST.ETS.STAT.ADD</link>, + <link href="text/scalc/01/func_forecastetsstatmult.xhp">FORECAST.ETS.STAT.MULT</link>, + <link href="text/scalc/01/func_forecastetspiadd.xhp">FORECAST.ETS.PI.ADD</link>, + <link href="text/scalc/01/func_forecastetspimult.xhp">FORECAST.ETS.PI.MULT</link>, + <link href="text/scalc/01/func_forecastetsseason.xhp">FORECAST.ETS.SEASONALITY</link>, + <link href="text/scalc/01/04060185.xhp#forecast">FORECAST</link>, + <link href="text/scalc/01/04060185.xhp#forecastlinear">FORECAST.LINEAR</link> + </paragraph> +</section> +</body> + +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/func_forecastetsmult.xhp b/helpcontent2/source/text/scalc/01/func_forecastetsmult.xhp new file mode 100644 index 000000000..49ea19fd5 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/func_forecastetsmult.xhp @@ -0,0 +1,65 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. +--> + +<meta> + <topic id="textscalc01func_forecastetsmultxml"> + <title id="tit" xml-lang="en-US">FORECAST.ETS.MULT</title> + <filename>/text/scalc/01/func_forecastetsmult.xhp</filename> + </topic> +</meta> + +<body> + +<section id="function_forecastetsmult"> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_FORECAST_ETS_MULT" id="bm_id0603201610024692" localize="false"/> +<bookmark xml-lang="en-US" branch="index" id="bm_id976559765597655"> +<bookmark_value>FORECAST.ETS.MULT function</bookmark_value> +</bookmark> + +<h1 id="hd_id0603201610022291"><link href="text/scalc/01/func_forecastetsmult.xhp">FORECAST.ETS.MULT Function</link></h1> + +<paragraph id="par_id0603201610023949" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_FORECAST_ETS_MULT">Calculates the multiplicative forecast(s) (future values) based on the historical data using ETS or EDS algorithms</ahelp>. EDS is used when argument <emph>period_length</emph> is 0, otherwise ETS is used.</paragraph> +<embed href="text/scalc/01/exponsmooth_embd.xhp#intro"/> +<paragraph id="par_id0603201608440530" role="paragraph" xml-lang="en-US">FORECAST.ETS.MULT calculates with the model </paragraph> +<embed href="text/scalc/01/exponsmooth_embd.xhp#etsmult"/> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id0403201618594544" role="code" xml-lang="en-US">FORECAST.ETS.MULT(targets, values, timeline, [period_length], [data_completion], [aggregation]) </paragraph> +<embed href="text/scalc/01/exponsmooth_embd.xhp#target"/> +<embed href="text/scalc/01/exponsmooth_embd.xhp#values"/> +<embed href="text/scalc/01/exponsmooth_embd.xhp#timeline"/> +<embed href="text/scalc/01/exponsmooth_embd.xhp#numsampperiod"/> +<embed href="text/scalc/01/exponsmooth_embd.xhp#datacompletion"/> +<embed href="text/scalc/01/exponsmooth_embd.xhp#aggregation"/> + +<embed href="text/scalc/01/exponsmooth_embd.xhp#exampledata"/> + <paragraph id="hd_id04032016185123" role="code" xml-lang="en-US">=FORECAST.ETS.MULT(DATE(2014;1;1);Values;Timeline;1;TRUE();1)</paragraph> + <paragraph id="hd_id04032016112394554" role="paragraph" xml-lang="en-US">Returns 131.71437427439, the multiplicative forecast for January 2014 based on <emph>Values</emph> and <emph>Timeline</emph> named ranges above, with one sample per period, no missing data, and AVERAGE as aggregation.</paragraph> + <paragraph id="hd_id04032123185123" role="code" xml-lang="en-US">=FORECAST.ETS.MULT(DATE(2014;1;1);Values;Timeline;4;TRUE();7)</paragraph> + <paragraph id="hd_id040312316112394554" role="paragraph" xml-lang="en-US">Returns 120.747806144882, the multiplicative forecast for January 2014 based on <emph>Values</emph> and <emph>Timeline</emph> named ranges above, with period length of 4, no missing data, and SUM as aggregation.</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectiontechinfo"/> + <embed href="text/scalc/00/avail_release.xhp#5.2"/> + <embed href="text/scalc/01/common_func.xhp#notODFF"/> + <paragraph role="paragraph" id="par_id311640873986703" localize="false"><literal>ORG.LIBREOFFICE.FORECAST.ETS.MULT</literal></paragraph> +</section> +<section id="relatedtopics"> +<paragraph id="par_id0603201619261276" role="paragraph" xml-lang="en-US">See also: + <link href="text/scalc/01/func_forecastetsadd.xhp">FORECAST.ETS.ADD</link>, + <link href="text/scalc/01/func_forecastetsstatadd.xhp">FORECAST.ETS.STAT.ADD</link>, + <link href="text/scalc/01/func_forecastetsstatmult.xhp">FORECAST.ETS.STAT.MULT</link>, + <link href="text/scalc/01/func_forecastetspiadd.xhp">FORECAST.ETS.PI.ADD</link>, + <link href="text/scalc/01/func_forecastetspimult.xhp">FORECAST.ETS.PI.MULT</link>, + <link href="text/scalc/01/func_forecastetsseason.xhp">FORECAST.ETS.SEASONALITY</link>, + <link href="text/scalc/01/04060185.xhp#forecast">FORECAST</link>, + <link href="text/scalc/01/04060185.xhp#forecastlinear">FORECAST.LINEAR</link> + </paragraph> +</section> +</body> + +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/func_forecastetspiadd.xhp b/helpcontent2/source/text/scalc/01/func_forecastetspiadd.xhp new file mode 100644 index 000000000..4c3b6f0ab --- /dev/null +++ b/helpcontent2/source/text/scalc/01/func_forecastetspiadd.xhp @@ -0,0 +1,69 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + --> + +<meta> + <topic id="textscalc01func_forecastpiaddxml"> + <title id="tit" xml-lang="en-US">FORECAST.ETS.PI.ADD</title> + <filename>/text/scalc/01/func_forecastetspiadd.xhp</filename> + </topic> +</meta> + +<body> + +<section id="forecastetspiadd"> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_FORECAST_ETS_PIA" id="bm_id0603201617144585" localize="false"/> +<bookmark xml-lang="en-US" branch="index" id="bm_id976559765597655"> +<bookmark_value>FORECAST.ETS.PI.ADD function</bookmark_value> +</bookmark> +<h1 id="hd_id0603201617134175"><link href="text/scalc/01/func_forecastetspiadd.xhp">FORECAST.ETS.PI.ADD function</link></h1> + +<paragraph id="par_id0603201617141750" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_FORECAST_ETS_PIA">Calculates the prediction interval(s) for additive forecast based on the historical data using ETS or EDS algorithms.</ahelp> EDS is used when argument <emph>period_length</emph> is 0, otherwise ETS is used.</paragraph> +<embed href="text/scalc/01/exponsmooth_embd.xhp#intro"/> +<paragraph id="par_id0603201610005998" role="paragraph" xml-lang="en-US">FORECAST.ETS.PI.ADD calculates with the model</paragraph> +<embed href="text/scalc/01/exponsmooth_embd.xhp#etsadd"/> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id0603201610010044" role="code" xml-lang="en-US">FORECAST.ETS.PI.ADD(target, values, timeline, [confidence_level], [period_length], [data_completion], [aggregation])</paragraph> +<embed href="text/scalc/01/exponsmooth_embd.xhp#target"/> +<embed href="text/scalc/01/exponsmooth_embd.xhp#values"/> +<embed href="text/scalc/01/exponsmooth_embd.xhp#timeline"/> +<embed href="text/scalc/01/exponsmooth_embd.xhp#confidence"/> +<embed href="text/scalc/01/exponsmooth_embd.xhp#numsampperiod"/> +<embed href="text/scalc/01/exponsmooth_embd.xhp#datacompletion"/> +<embed href="text/scalc/01/exponsmooth_embd.xhp#aggregation"/> +<paragraph id="par_id0403201618595126" role="paragraph" xml-lang="en-US">For example, with a 90% Confidence level, a 90% prediction interval will be computed (90% of future points are to fall within this radius from forecast). </paragraph> +<note id="par_id0403201618595143">Note on prediction intervals: there is no exact mathematical way to calculate this for forecasts, there are various approximations. Prediction intervals tend to be increasingly 'over-optimistic' when increasing distance of the forecast-X from the observation data set.</note> +<paragraph id="par_id0403201618595150" role="paragraph" xml-lang="en-US">For ETS, Calc uses an approximation based on 1000 calculations with random variations within the standard deviation of the observation data set (the historical values).</paragraph> + +<embed href="text/scalc/01/exponsmooth_embd.xhp#exampledata"/> + <paragraph id="hd_id04032016185123" role="code" xml-lang="en-US">=FORECAST.ETS.PI.ADD(DATE(2014;1;1);Values;Timeline;0.9;1;TRUE();1)</paragraph> + <paragraph id="hd_id04032016112394554" role="paragraph" xml-lang="en-US">Returns 18.8061295551355, the prediction interval for additive forecast for January 2014 based on <emph>Values</emph> and <emph>Timeline</emph> named ranges above, 90% (=0.9) confidence level, with one sample per period, no missing data, and AVERAGE as aggregation.</paragraph> + <paragraph id="hd_id04032123185123" role="code" xml-lang="en-US">=FORECAST.ETS.PI.ADD(DATE(2014;1;1);Values;Timeline;0.8;4;TRUE();7)</paragraph> + <paragraph id="hd_id040312316112394554" role="paragraph" xml-lang="en-US">Returns 23.4416821953741, the prediction interval for additive forecast for January 2014 based on <emph>Values</emph> and <emph>Timeline</emph> named ranges above, with confidence level of 0.8, period length of 4, no missing data, and SUM as aggregation.</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectiontechinfo"/> +<embed href="text/scalc/00/avail_release.xhp#5.2"/> + <embed href="text/scalc/01/common_func.xhp#notODFF"/> + <paragraph role="paragraph" id="par_id341640873986703" localize="false"><literal>COM.MICROSOFT.FORECAST.ETS.COFINT</literal></paragraph> +</section> +<section id="relatedtopics"> +<paragraph id="par_id0603201619261276" role="paragraph" xml-lang="en-US">See also: + <link href="text/scalc/01/func_forecastetsadd.xhp">FORECAST.ETS.ADD</link>, + <link href="text/scalc/01/func_forecastetsmult.xhp">FORECAST.ETS.MULT</link>, + <link href="text/scalc/01/func_forecastetsstatadd.xhp">FORECAST.ETS.STAT.ADD</link>, + <link href="text/scalc/01/func_forecastetsstatmult.xhp">FORECAST.ETS.STAT.MULT</link>, + <link href="text/scalc/01/func_forecastetspimult.xhp">FORECAST.ETS.PI.MULT</link> + <link href="text/scalc/01/func_forecastetsseason.xhp">FORECAST.ETS.SEASONALITY</link>, + <link href="text/scalc/01/04060185.xhp#forecast">FORECAST</link>, + <link href="text/scalc/01/04060185.xhp#forecastlinear">FORECAST.LINEAR</link> + </paragraph> +</section> +</body> + +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/func_forecastetspimult.xhp b/helpcontent2/source/text/scalc/01/func_forecastetspimult.xhp new file mode 100644 index 000000000..b5d5c1eb9 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/func_forecastetspimult.xhp @@ -0,0 +1,69 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + --> + +<meta> + <topic id="textscalc01func_forecastetspimultxml"> + <title id="tit" xml-lang="en-US">FORECAST.ETS.PI.MULT</title> + <filename>/text/scalc/01/func_forecastetspimult.xhp</filename> + </topic> +</meta> + +<body> +<section id="forecastetspimult"> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_FORECAST_ETS_PIM" id="bm_id0603201617144585" localize="false"/> +<bookmark xml-lang="en-US" branch="index" id="bm_id976559765597655"> +<bookmark_value>FORECAST.ETS.PI.MULT function</bookmark_value> +</bookmark> + +<h1 id="hd_id0603201617134175"><link href="text/scalc/01/func_forecastetspimult.xhp">FORECAST.ETS.PI.MULT function</link></h1> + +<paragraph id="par_id0603201617141750" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_FORECAST_ETS_PIM">Calculates the prediction interval(s) for multiplicative forecast based on the historical data using ETS or EDS algorithms.</ahelp>. EDS is used when argument <emph>period_length</emph> is 0, otherwise ETS is used.</paragraph> +<embed href="text/scalc/01/exponsmooth_embd.xhp#intro"/> +<paragraph id="par_id0603201610005998" role="paragraph" xml-lang="en-US">FORECAST.ETS.PI.MULT calculates with the model</paragraph> +<embed href="text/scalc/01/exponsmooth_embd.xhp#etsmult"/> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id0603201610010044" role="code" xml-lang="en-US">FORECAST.ETS.PI.MULT(target, values, timeline, [confidence_level], [period_length], [data_completion], [aggregation])</paragraph> +<embed href="text/scalc/01/exponsmooth_embd.xhp#target"/> +<embed href="text/scalc/01/exponsmooth_embd.xhp#values"/> +<embed href="text/scalc/01/exponsmooth_embd.xhp#timeline"/> +<embed href="text/scalc/01/exponsmooth_embd.xhp#confidence"/> +<embed href="text/scalc/01/exponsmooth_embd.xhp#numsampperiod"/> +<embed href="text/scalc/01/exponsmooth_embd.xhp#datacompletion"/> +<embed href="text/scalc/01/exponsmooth_embd.xhp#aggregation"/> +<paragraph id="par_id0403201618595126" role="paragraph" xml-lang="en-US">For example, with a 90% Confidence level, a 90% prediction interval will be computed (90% of future points are to fall within this radius from forecast). </paragraph> +<note id="par_id0403201618595143">Note on prediction intervals: there is no exact mathematical way to calculate this for forecasts, there are various approximations. Prediction intervals tend to be increasingly 'over-optimistic' when increasing distance of the forecast-X from the observation data set.</note> +<paragraph id="par_id0403201618595150" role="paragraph" xml-lang="en-US">For ETS, Calc uses an approximation based on 1000 calculations with random variations within the standard deviation of the observation data set (the historical values).</paragraph> + +<embed href="text/scalc/01/exponsmooth_embd.xhp#exampledata"/> + <paragraph id="hd_id04032016185123" role="code" xml-lang="en-US">=FORECAST.ETS.PI.MULT(DATE(2014;1;1);Values;Timeline;0.9;1;TRUE();1)</paragraph> + <paragraph id="hd_id04032016112394554" role="paragraph" xml-lang="en-US">Returns 20.1040952101013, the prediction interval for multiplicative forecast for January 2014 based on <emph>Values</emph> and <emph>Timeline</emph> named ranges above, confidence level of 90% (=0.9) with one sample per period, no missing data, and AVERAGE as aggregation.</paragraph> + <paragraph id="hd_id04032123185123" role="code" xml-lang="en-US">=FORECAST.ETS.PI.MULT(DATE(2014;1;1);Values;Timeline;0.8;4;TRUE();7)</paragraph> + <paragraph id="hd_id040312316112394554" role="paragraph" xml-lang="en-US">Returns 27.5285874381574, the prediction interval for multiplicative forecast for January 2014 based on <emph>Values</emph> and <emph>Timeline</emph> named ranges above, with confidence level of 0.8, period length of 4, no missing data, and SUM as aggregation.</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectiontechinfo"/> + <embed href="text/scalc/00/avail_release.xhp#5.2"/> + <embed href="text/scalc/01/common_func.xhp#notODFF"/> + <paragraph role="paragraph" id="par_id311640873986703" localize="false"><literal>ORG.LIBREOFFICE.FORECAST.ETS.PI.MULT</literal></paragraph> +</section> +<section id="relatedtopics"> +<paragraph id="par_id0603201619261276" role="paragraph" xml-lang="en-US">See also: + <link href="text/scalc/01/func_forecastetsadd.xhp">FORECAST.ETS.ADD</link>, + <link href="text/scalc/01/func_forecastetsmult.xhp">FORECAST.ETS.MULT</link>, + <link href="text/scalc/01/func_forecastetsstatadd.xhp">FORECAST.ETS.STAT.ADD</link>, + <link href="text/scalc/01/func_forecastetsstatmult.xhp">FORECAST.ETS.STAT.MULT</link>, + <link href="text/scalc/01/func_forecastetspiadd.xhp">FORECAST.ETS.PI.ADD</link>, + <link href="text/scalc/01/func_forecastetsseason.xhp">FORECAST.ETS.SEASONALITY</link>, + <link href="text/scalc/01/04060185.xhp#forecast">FORECAST</link>, + <link href="text/scalc/01/04060185.xhp#forecastlinear">FORECAST.LINEAR</link> + </paragraph> +</section> +</body> + +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/func_forecastetsseason.xhp b/helpcontent2/source/text/scalc/01/func_forecastetsseason.xhp new file mode 100644 index 000000000..6fead6db6 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/func_forecastetsseason.xhp @@ -0,0 +1,61 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * +--> + +<meta> + <topic id="textscalc01func_forecastetsseasonxml"> + <title id="tit" xml-lang="en-US">FORECAST.ETS.SEASONALITY</title> + <filename>/text/scalc/01/func_forecastetsseason.xhp</filename> + </topic> +</meta> + +<body> + +<section id="forecastetsseasonality"> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_FORECAST_ETS_SEA" id="bm_id0603201617512578" localize="false"/> +<bookmark xml-lang="en-US" branch="index" id="bm_id976559765597655"> +<bookmark_value>FORECAST.ETS.SEASONALITY function</bookmark_value> +</bookmark> + +<h1 id="hd_id0603201617435371"><link href="text/scalc/01/func_forecastetsseason.xhp">FORECAST.ETS.SEASONALITY Function</link></h1> + +<paragraph id="par_id0603201617510446" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_FORECAST_ETS_SEA">Returns the number of samples in period as calculated by Calc in case of FORECAST.ETS functions when argument <emph>period_length</emph> equals 1. </ahelp></paragraph> +<embed href="text/scalc/01/exponsmooth_embd.xhp#intro"/> +<paragraph id="par_id0403201618595132" role="paragraph" xml-lang="en-US">The same result is returned with FORECAST.ETS.STAT functions when argument <emph>stat_type</emph> equals 9 (and <emph>period_length</emph> equals 1).</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id0603201618013796" role="code" xml-lang="en-US">FORECAST.ETS.SEASONALITY (values, timeline, [data_completion], [aggregation])</paragraph> +<embed href="text/scalc/01/exponsmooth_embd.xhp#values"/> +<embed href="text/scalc/01/exponsmooth_embd.xhp#timeline"/> +<embed href="text/scalc/01/exponsmooth_embd.xhp#datacompletion"/> +<embed href="text/scalc/01/exponsmooth_embd.xhp#aggregation"/> +<embed href="text/scalc/01/exponsmooth_embd.xhp#exampledata"/> + <paragraph id="hd_id04032016185123" role="code" xml-lang="en-US">=FORECAST.ETS.SEASONALITY(Values;Timeline;TRUE();1)</paragraph> + <paragraph id="hd_id04032016112394554" role="paragraph" xml-lang="en-US">Returns 6, the number of samples in period based on <emph>Values</emph> and <emph>Timeline</emph> named ranges above, no missing data, and AVERAGE as aggregation.</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectiontechinfo"/> +<embed href="text/scalc/00/avail_release.xhp#5.2"/> + <embed href="text/scalc/01/common_func.xhp#notODFF"/> + <paragraph role="paragraph" id="par_id341640873986703" localize="false"><literal>COM.MICROSOFT.FORECAST.ETS.SEASONALITY</literal></paragraph> +</section> + +<section id="relatedtopics"> +<paragraph id="par_id0603201619261276" role="paragraph" xml-lang="en-US">See also: + <link href="text/scalc/01/func_forecastetsadd.xhp">FORECAST.ETS.ADD</link>, + <link href="text/scalc/01/func_forecastetsmult.xhp">FORECAST.ETS.MULT</link>, + <link href="text/scalc/01/func_forecastetsstatadd.xhp">FORECAST.ETS.STAT.ADD</link>, + <link href="text/scalc/01/func_forecastetsstatmult.xhp">FORECAST.ETS.STAT.MULT</link>, + <link href="text/scalc/01/func_forecastetspiadd.xhp">FORECAST.ETS.PI.ADD</link>, + <link href="text/scalc/01/func_forecastetspimult.xhp">FORECAST.ETS.PI.MULT</link>, + <link href="text/scalc/01/04060185.xhp#forecast">FORECAST</link>, + <link href="text/scalc/01/04060185.xhp#forecastlinear">FORECAST.LINEAR</link> + </paragraph> +</section> +</body> + +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/func_forecastetsstatadd.xhp b/helpcontent2/source/text/scalc/01/func_forecastetsstatadd.xhp new file mode 100644 index 000000000..0d7d62bb1 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/func_forecastetsstatadd.xhp @@ -0,0 +1,67 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * +--> + +<meta> + <topic id="textscalc01func_forecastetsstataddxml"> + <title id="tit" xml-lang="en-US">FORECAST.ETS.STAT.ADD</title> + <filename>/text/scalc/01/func_forecastetsstatadd.xhp</filename> + </topic> +</meta> + +<body> + +<section id="forecastetsstatadd"> + +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_FORECAST_ETS_STA" id="bm_id0603201615491416" localize="false"/> +<bookmark xml-lang="en-US" branch="index" id="bm_id976559765597655"> +<bookmark_value>FORECAST.ETS.STAT.ADD function</bookmark_value> +</bookmark> + +<h1 id="hd_id0603201615483251"><link href="text/scalc/01/func_forecastetsstatadd.xhp">FORECAST.ETS.STAT.ADD Function</link></h1> + +<paragraph id="par_id0603201615485387" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_FORECAST_ETS_STA">Returns statistical value(s) that are results of the ETS/EDS algorithms.</ahelp></paragraph> +<embed href="text/scalc/01/exponsmooth_embd.xhp#intro"/> +<paragraph id="par_id0603201608440530" role="paragraph" xml-lang="en-US">FORECAST.ETS.STAT.ADD calculates with the model </paragraph> +<embed href="text/scalc/01/exponsmooth_embd.xhp#etsadd"/> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id0603201610005728" role="code" xml-lang="en-US">FORECAST.ETS.STAT.ADD (values, timeline, stat_type, [period_length], [data_completion], [aggregation])</paragraph> +<embed href="text/scalc/01/exponsmooth_embd.xhp#values"/> +<embed href="text/scalc/01/exponsmooth_embd.xhp#timeline"/> +<embed href="text/scalc/01/exponsmooth_embd.xhp#statistics"/> +<embed href="text/scalc/01/exponsmooth_embd.xhp#numsampperiod"/> +<embed href="text/scalc/01/exponsmooth_embd.xhp#datacompletion"/> +<embed href="text/scalc/01/exponsmooth_embd.xhp#aggregation"/> + +<embed href="text/scalc/01/exponsmooth_embd.xhp#exampledata"/> + <paragraph id="hd_id04032016185123" role="code" xml-lang="en-US">=FORECAST.ETS.STAT.ADD(Values;Timeline;3;1;TRUE();1)</paragraph> + <paragraph id="hd_id04032016112394554" role="paragraph" xml-lang="en-US">Returns 0.9990234375, the additive statistics based on <emph>Values</emph> and <emph>Timeline</emph> named ranges above, with beta smoothing, one sample per period, no missing data, and AVERAGE as aggregation.</paragraph> + <paragraph id="hd_id04032123185123" role="code" xml-lang="en-US">=FORECAST.ETS.STAT.ADD(Values;Timeline;2;1;TRUE();7)</paragraph> + <paragraph id="hd_id040312316112394554" role="paragraph" xml-lang="en-US">Returns 0.0615234375, the additive statistics based on <emph>Values</emph> and <emph>Timeline</emph> named ranges above, with gamma smoothing, no missing data, and SUM as aggregation.</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectiontechinfo"/> +<embed href="text/scalc/00/avail_release.xhp#5.2"/> + <embed href="text/scalc/01/common_func.xhp#notODFF"/> + <paragraph role="paragraph" id="par_id341640873986703" localize="false"><literal>COM.MICROSOFT.FORECAST.ETS.STAT</literal></paragraph> +</section> +<section id="relatedtopics"> +<paragraph id="par_id0603201619261276" role="paragraph" xml-lang="en-US">See also: + <link href="text/scalc/01/func_forecastetsadd.xhp">FORECAST.ETS.ADD </link>, + <link href="text/scalc/01/func_forecastetsmult.xhp">FORECAST.ETS.MULT </link>, + <link href="text/scalc/01/func_forecastetsstatmult.xhp">FORECAST.ETS.STAT.MULT </link>, + <link href="text/scalc/01/func_forecastetspiadd.xhp">FORECAST.ETS.PI.ADD </link>, + <link href="text/scalc/01/func_forecastetspimult.xhp">FORECAST.ETS.PI.MULT</link>, + <link href="text/scalc/01/func_forecastetsseason.xhp">FORECAST.ETS.SEASONALITY</link>, + <link href="text/scalc/01/04060185.xhp#forecast">FORECAST</link>, + <link href="text/scalc/01/04060185.xhp#forecastlinear">FORECAST.LINEAR</link> + </paragraph> +</section> +</body> + +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/func_forecastetsstatmult.xhp b/helpcontent2/source/text/scalc/01/func_forecastetsstatmult.xhp new file mode 100644 index 000000000..4c818cb67 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/func_forecastetsstatmult.xhp @@ -0,0 +1,66 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * +--> + +<meta> + <topic id="textscalc01func_forecastetsstatmultxml"> + <title id="tit" xml-lang="en-US">FORECAST.ETS.STAT.MULT</title> + <filename>/text/scalc/01/func_forecastetsstatmult.xhp</filename> + </topic> +</meta> + +<body> + +<section id="forecastetsstatmult"> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_FORECAST_ETS_STM" id="bm_id0603201615491416" localize="false"/> +<bookmark xml-lang="en-US" branch="index" id="bm_id976559765597655"> +<bookmark_value>FORECAST.ETS.STAT.MULT function</bookmark_value> +</bookmark> + +<h1 id="hd_id0603201615483251"><link href="text/scalc/01/func_forecastetsstatmult.xhp">FORECAST.ETS.STAT.MULT Function</link></h1> + +<paragraph id="par_id0603201615485387" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_FORECAST_ETS_STM">Returns statistical value(s) that are results of the ETS/EDS algorithms.</ahelp></paragraph> +<embed href="text/scalc/01/exponsmooth_embd.xhp#intro"/> +<paragraph id="par_id0603201608440530" role="paragraph" xml-lang="en-US">FORECAST.ETS.STAT.MULT calculates with the model </paragraph> +<embed href="text/scalc/01/exponsmooth_embd.xhp#etsmult"/> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id0603201610005728" role="code" xml-lang="en-US">FORECAST.ETS.STAT.MULT (values, timeline, stat_type, [period_length], [data_completion], [aggregation])</paragraph> +<embed href="text/scalc/01/exponsmooth_embd.xhp#values"/> +<embed href="text/scalc/01/exponsmooth_embd.xhp#timeline"/> +<embed href="text/scalc/01/exponsmooth_embd.xhp#statistics"/> +<embed href="text/scalc/01/exponsmooth_embd.xhp#numsampperiod"/> +<embed href="text/scalc/01/exponsmooth_embd.xhp#datacompletion"/> +<embed href="text/scalc/01/exponsmooth_embd.xhp#aggregation"/> + +<embed href="text/scalc/01/exponsmooth_embd.xhp#exampledata"/> + <paragraph id="hd_id04032016185123" role="code" xml-lang="en-US">=FORECAST.ETS.STAT.MULT(Values;Timeline;5;1;TRUE();1)</paragraph> + <paragraph id="hd_id04032016112394554" role="paragraph" xml-lang="en-US">Returns 0.084073452803966, the multiplicative statistics based on <emph>Values</emph> and <emph>Timeline</emph> named ranges above, with symmetric mean absolute percentage error (SMAPE), one sample per period, no missing data, and AVERAGE as aggregation.</paragraph> + <paragraph id="hd_id04032123185123" role="code" xml-lang="en-US">=FORECAST.ETS.STAT.MULT(Values;Timeline;7;1;TRUE();7)</paragraph> + <paragraph id="hd_id040312316112394554" role="paragraph" xml-lang="en-US">Returns 15.8372533480997, the multiplicative statistics based on <emph>Values</emph> and <emph>Timeline</emph> named ranges above, with root mean squared error, no missing data, and SUM as aggregation.</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectiontechinfo"/> + <embed href="text/scalc/00/avail_release.xhp#5.2"/> + <embed href="text/scalc/01/common_func.xhp#notODFF"/> + <paragraph role="paragraph" id="par_id311640873986703" localize="false"><literal>ORG.LIBREOFFICE.FORECAST.ETS.STAT.MULT</literal></paragraph> +</section> +<section id="relatedtopics"> +<paragraph id="par_id0603201619261276" role="paragraph" xml-lang="en-US">See also: + <link href="text/scalc/01/func_forecastetsadd.xhp">FORECAST.ETS.ADD</link>, + <link href="text/scalc/01/func_forecastetsmult.xhp">FORECAST.ETS.MULT</link>, + <link href="text/scalc/01/func_forecastetsstatadd.xhp">FORECAST.ETS.STAT.ADD</link>, + <link href="text/scalc/01/func_forecastetspiadd.xhp">FORECAST.ETS.PI.ADD</link>, + <link href="text/scalc/01/func_forecastetspimult.xhp">FORECAST.ETS.PI.MULT</link>, + <link href="text/scalc/01/func_forecastetsseason.xhp">FORECAST.ETS.SEASONALITY</link>, + <link href="text/scalc/01/04060185.xhp#forecast">FORECAST</link>, + <link href="text/scalc/01/04060185.xhp#forecastlinear">FORECAST.LINEAR</link> + </paragraph> +</section> +</body> + +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/func_fourier.xhp b/helpcontent2/source/text/scalc/01/func_fourier.xhp new file mode 100644 index 000000000..d34910924 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/func_fourier.xhp @@ -0,0 +1,51 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> + <!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + --> + + <meta> + <topic id="functfourier" indexer="include" status="PUBLISH"> + <title id="tit" xml-lang="en-US">FOURIER function</title> + <filename>/text/scalc/01/func_fourier.xhp</filename> + </topic> + </meta> + <body> + <section id="fourier01"> + <bookmark id="bm_id681556227727944" xml-lang="en-US" branch="hid/SC_HID_FUNC_FOURIER" localize="false"/> + <bookmark xml-lang="en-US" branch="index" id="bm_id581556228060864"> +<bookmark_value>FOURIER function</bookmark_value> + </bookmark> + <h2 id="hd_id551556227727946"><variable id="fourierfunct"><link href="text/scalc/01/func_fourier.xhp" name="fourierfunction">FOURIER</link></variable></h2> + <paragraph id="par_id121556227727948" role="paragraph"><variable id="textjoinfunction"><ahelp hid=".">Computes the Discrete Fourier Transform [DFT] of an input array of complex numbers using a couple of Fast Fourier Transform (FFT) algorithms.</ahelp></variable> The function is an <link href="text/scalc/01/04060107.xhp" name="array formula">array formula</link>.</paragraph> + </section> + <embed href="text/scalc/01/ful_func.xhp#func_head_syntax"/> + + <paragraph role="code" id="par_id541556228253979">FOURIER(Array; GroupedByColumns [; Inverse [; Polar [; MinimumMagnitude]]])</paragraph> + <paragraph role="paragraph" id="par_id741556228390897"><emph>Array</emph> is a 2 x N or N x 2 range representing an array of complex number to be transformed, where N is the length of the array. The array represents the real and imaginary parts of the data.</paragraph> + + <paragraph role="paragraph" id="par_id621556228397269"><emph>GroupedByColumns</emph> is a logical (TRUE or FALSE, 1 or 0) argument. When TRUE the array is grouped by columns where the first column contains the real part of the complex number and the second columns contains the imaginary part of the complex number. When FALSE, the first row contains the real part of the complex number and the second row contains the imaginary part of the complex number. If there is only 1 column (row), the input sequence is treated as purely real.</paragraph> + + <paragraph role="paragraph" id="par_id631556228516997"><emph>Inverse</emph> is an optional logical (TRUE or FALSE, 1 or 0) argument. When TRUE, calculates the inverse Discrete Fourier Transform. The default value is FALSE.</paragraph> + + <paragraph role="paragraph" id="par_id811561732287508"><emph>Polar</emph>: is an optional logical (TRUE or FALSE, 1 or 0) argument. Indicates whether the final output is in polar coordinates (magnitude, phase). This argument is optional and the default value is FALSE.</paragraph> + + <paragraph role="paragraph" id="par_id661561732521977"><emph>MinimumMagnitude</emph>: used only if Polar=TRUE. All frequency components with magnitude less than <emph>MinimumMagnitude</emph> will be suppressed with a zero magnitude-phase entry. This is very useful when looking at the magnitude-phase spectrum of a signal because there is always some very tiny amount of rounding error when doing FFT algorithms and results in incorrect non-zero phase for non-existent frequencies. By providing a suitable value to this parameter, these non-existent frequency components can be suppressed. By default the value of <emph>MinimumMagnitude</emph> is 0.0, and no suppression is done by default.</paragraph> + <embed href="text/scalc/01/ful_func.xhp#func_head_example"/> + <embed href="text/scalc/01/stat_data.xhp#fourierdata"/> + <embed href="text/scalc/06/calcsamplefiles.xhp#func_fourier"/> + <embed href="text/scalc/01/common_func.xhp#sectiontechinfo"/> + <embed href="text/scalc/00/avail_release.xhp#6.3"/> + <embed href="text/scalc/01/common_func.xhp#notODFF"/> + <paragraph role="paragraph" id="par_id311640873986703" localize="false"><literal>ORG.LIBREOFFICE.FOURIER</literal></paragraph> + <section id="relatedtopics"> + <embed href="text/scalc/01/statistics_fourier.xhp#fourieranalysysh1"/> + <embed href="text/scalc/01/04060107.xhp#arrayfunctit"/> + </section> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/func_hour.xhp b/helpcontent2/source/text/scalc/01/func_hour.xhp new file mode 100644 index 000000000..9936d2914 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/func_hour.xhp @@ -0,0 +1,46 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . + --> +<helpdocument version="1.0"> +<meta> +<topic id="textscalc01func_hourxml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">HOUR </title> +<filename>/text/scalc/01/func_hour.xhp</filename> +</topic> +</meta> +<body> +<bookmark xml-lang="en-US" branch="index" id="bm_id3154725"><bookmark_value>HOUR function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_STUNDE" id="bm_id3152469" localize="false"/><h2 id="hd_id3154725"><variable id="hour"><link href="text/scalc/01/func_hour.xhp">HOUR</link> +</variable></h2> +<paragraph role="paragraph" id="par_id3149747" xml-lang="en-US"><ahelp hid="HID_FUNC_STUNDE">Returns the hour for a given time value.</ahelp> The hour is returned as an integer between 0 and 23.</paragraph> +<embed href="text/scalc/01/ODFF.xhp#odff"/> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph role="code" id="par_id3150637" xml-lang="en-US">HOUR(Number)</paragraph> +<paragraph role="paragraph" id="par_id3147547" xml-lang="en-US"> +<emph>Number</emph>, as a time value, is a decimal, for which the hour is to be returned.</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph role="paragraph" id="par_id3159215" xml-lang="en-US"> +<item type="input">=HOUR(NOW())</item> returns the current hour</paragraph> +<paragraph role="paragraph" id="par_id3145152" xml-lang="en-US"> +<item type="input">=HOUR(C4)</item> returns 17 if the contents of C4 = <item type="input">17:20:00</item>.</paragraph> +<section id="relatedtopics"> + <embed href="text/scalc/01/04060102.xhp#datetimefunctions"/> +</section> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/func_ifs.xhp b/helpcontent2/source/text/scalc/01/func_ifs.xhp new file mode 100644 index 000000000..26cd70093 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/func_ifs.xhp @@ -0,0 +1,51 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> + <!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + --> + + <meta> + <topic id="ifs01" indexer="include" status="PUBLISH"> + <title id="tit" xml-lang="en-US">IFS function</title> + <filename>/text/scalc/01/func_ifs.xhp</filename> + </topic> + </meta> + <body> + <section id="ifsfunction01"> + <bookmark id="bm_id721556234923653" xml-lang="en-US" branch="hid/SC_HID_FUNC_IFS_MS" localize="false"/> + <bookmark xml-lang="en-US" branch="index" id="bm_id901556242230198"> + <bookmark_value>IFS function</bookmark_value> + </bookmark> + <h2 id="hd_id271556234923654"><variable id="ifsfunct"><link href="text/scalc/01/func_ifs.xhp" name="function ifs">IFS</link></variable></h2> + <paragraph id="par_id171556234923655" role="paragraph" xml-lang="en-US"><variable id="variable name"><ahelp hid=".">IFS is a multiple IF-function.</ahelp></variable></paragraph> + </section> + <embed href="text/scalc/01/ful_func.xhp#func_head_syntax"/> + + <paragraph role="code" id="par_id271556235333493">IFS(expression1; result1[; expression2; result2][; ... ; [expression127; result127]])</paragraph> + <paragraph role="paragraph" id="par_id31556235655212"><emph>expression1, expression2, ...</emph> are any boolean values or expressions that can be TRUE or FALSE</paragraph> + <paragraph role="paragraph" id="par_id441556235649549"><emph>result1, result2, ... </emph> are the values that are returned if the logical test is TRUE</paragraph> + <paragraph role="paragraph" id="par_id641556235704257">IFS( expression1, result1, expression2, result2, expression3, result3 ) is executed as</paragraph> + <paragraph role="paragraph" id="par_id551556235712759">IF expression1 is TRUE</paragraph> + <paragraph role="paragraph" id="par_id1001556235718948">THEN result1</paragraph> + <paragraph role="paragraph" id="par_id571556235725969">ELSE IF expression2 is TRUE</paragraph> + <paragraph role="paragraph" id="par_id581556235731982">THEN result2</paragraph> + <paragraph role="paragraph" id="par_id961556235738258">ELSE IF expression3 is TRUE</paragraph> + <paragraph role="paragraph" id="par_id951556235743954">THEN result3</paragraph> + <paragraph role="paragraph" id="par_id671556235758504">To get a default result should no expression be TRUE, add a last expression that is always TRUE, like TRUE or 1=1 followed by the default result.</paragraph> + <paragraph role="paragraph" id="par_id541556235771022">If there is a result missing for an expression or is no expression is TRUE, a #N/A error is returned.</paragraph> + <paragraph role="paragraph" id="par_id181556235788473">If expression is neither TRUE or FALSE, a #VALUE error is returned.</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectiontechinfo"/> + <embed href="text/scalc/00/avail_release.xhp#5.2"/> + <embed href="text/scalc/01/common_func.xhp#notODFF"/> + <paragraph role="paragraph" id="par_id341640873986703" localize="false"><literal>COM.MICROSOFT.IFS</literal></paragraph> + <section id="relatedtopics"> + <embed href="text/scalc/01/func_switch.xhp#switchfunct"/> + <paragraph role="paragraph" id="par_id781556244709752"><link href="text/scalc/01/04060105.xhp#Section4" name="if">IF</link></paragraph> + </section> + </body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/func_imcos.xhp b/helpcontent2/source/text/scalc/01/func_imcos.xhp new file mode 100644 index 000000000..c2a4e7fdb --- /dev/null +++ b/helpcontent2/source/text/scalc/01/func_imcos.xhp @@ -0,0 +1,72 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. +--> +<meta> + <topic id="textscalc01func_imcosxml"> + <title id="tit" xml-lang="en-US">IMCOS function</title> + <filename>/text/scalc/01/func_imcos.xhp</filename> + </topic> +</meta> +<body> + <section id="func_imcos_function"> + <bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_IMCOS" id="bm_id22208483221520" localize="false"/> + <bookmark xml-lang="en-US" branch="index" id="bm_id262410558824"> + <bookmark_value>IMCOS function</bookmark_value> + <bookmark_value>cosine;complex number</bookmark_value> + </bookmark> + <h2 id="hd_id90361032228870"> + <variable id="imcos_head"> + <link href="text/scalc/01/func_imcos.xhp">IMCOS</link> + </variable> function + </h2> + <paragraph id="par_id1066273182723" role="paragraph" xml-lang="en-US"> + <ahelp hid="."> + <variable id="imcos_des">Returns the cosine of a complex number.</variable> The cosine of a complex number can be expressed by: + </ahelp> + </paragraph> + </section> + <paragraph id="par_id12176138532237" role="paragraph" xml-lang="en-US" localize="false"> + <image src="media/helpimg/sc_func_imcos.svg" id="img_id211575078735993" width="452.06109px" height="31.5px"><alt xml-lang="en-US" id="alt_id401575078735994">IMCOS equation</alt></image> + </paragraph> + <embed href="text/scalc/01/ful_func.xhp#func_im_des"/> + <embed href="text/scalc/01/ODFF.xhp#odff"/> + <embed href="text/scalc/01/ful_func.xhp#func_head_syntax"/> + <paragraph id="par_id164021484116762" role="code" xml-lang="en-US"> + IMCOS(Complex_number) + </paragraph> + <paragraph id="par_id2890729435632" role="paragraph" xml-lang="en-US"> + Complex_number is a complex number whose cosine is to be calculated. + </paragraph> + <note localize="false" id="par_id11756847629133"> + <embedvar href="text/scalc/01/ful_func.xhp#func_im_comp_numb"/><br/> + <embedvar href="text/scalc/01/ful_func.xhp#func_im_real_numb"/> + </note> + <warning localize="false" id="par_id2823797012200"> + <embedvar href="text/scalc/01/ful_func.xhp#func_im_return_text"/><br/> + <embedvar href="text/scalc/01/ful_func.xhp#func_im_ignor_zero"/> + </warning> + <embed href="text/scalc/01/ful_func.xhp#func_head_example"/> + <paragraph id="par_id4581301219753" role="paragraph" xml-lang="en-US"> + <item type="input">=IMCOS("4-3i")</item><br/> + returns -6.58066304055116-7.58155274274654i. + </paragraph> + <paragraph id="par_id25412646522614" role="paragraph" xml-lang="en-US"> + <item type="input">=IMCOS(2)</item><br/> + returns -0.416146836547142 as a string. <embedvar href="text/scalc/01/ful_func.xhp#func_imag_zero"/> + </paragraph> + <embed href="text/scalc/06/calcsamplefiles.xhp#imtrigon"/> + <section id="relatedtopics"> + <paragraph id="par_id208171544029884" role="paragraph" localize="false" xml-lang="en-US"> + <embedvar href="text/scalc/01/func_imcosh.xhp#imcosh_head"/>, + <embedvar href="text/scalc/01/func_imsin.xhp#imsin_head"/>, + <embedvar href="text/scalc/01/func_imsinh.xhp#imsinh_head"/> + </paragraph> + </section> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/func_imcosh.xhp b/helpcontent2/source/text/scalc/01/func_imcosh.xhp new file mode 100644 index 000000000..718b490db --- /dev/null +++ b/helpcontent2/source/text/scalc/01/func_imcosh.xhp @@ -0,0 +1,73 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. +--> +<meta> + <topic id="textscalc01func_imcoshxml"> + <title id="tit" xml-lang="en-US">IMCOSH function</title> + <filename>/text/scalc/01/func_imcosh.xhp</filename> + </topic> +</meta> +<body> + <section id="func_imcosh_function"> + <bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_IMCOSH" id="bm_id123221232212322" localize="false"/> + <bookmark xml-lang="en-US" branch="index" id="bm_id123771237712377"> + <bookmark_value>IMCOSH function</bookmark_value> + <bookmark_value>hyperbolic cosine;complex number</bookmark_value> + </bookmark> + <h2 id="hd_id124691246912469"> + <variable id="imcosh_head"> + <link href="text/scalc/01/func_imcosh.xhp">IMCOSH</link> + </variable> function + </h2> + <paragraph id="par_id125881258812588" role="paragraph" xml-lang="en-US"> + <ahelp hid="."> + <variable id="imcosh_des">Returns the hyperbolic cosine of a complex number.</variable> The hyperbolic cosine of a complex number can be expressed by: + </ahelp> + </paragraph> + </section> + <paragraph id="par_id24939266285933" role="paragraph" xml-lang="en-US"> + <image src="media/helpimg/sc_func_imcosh.svg" id="img_id211575078735993" width="464.56109px" height="31.5px"><alt xml-lang="en-US" id="alt_id401575078735994">IMCOSH equation</alt></image> + </paragraph> + <embed href="text/scalc/01/ful_func.xhp#func_im_des"/> + <embed href="text/scalc/01/ODFF.xhp#odff"/> + <embed href="text/scalc/00/avail_release.xhp#3.6"/> + <embed href="text/scalc/01/ful_func.xhp#func_head_syntax"/> + <paragraph id="par_id16051131322110" role="code" xml-lang="en-US"> + IMCOSH(Complex_number) + </paragraph> + <paragraph id="par_id766137661376613" role="paragraph" xml-lang="en-US"> + Complex_number is a complex number whose hyperbolic cosine is to be calculated. + </paragraph> + <note localize="false" id="par_id193292656220842"> + <embedvar href="text/scalc/01/ful_func.xhp#func_im_comp_numb"/><br/> + <embedvar href="text/scalc/01/ful_func.xhp#func_im_real_numb"/> + </note> + <warning localize="false" id="par_id24300832426190"> + <embedvar href="text/scalc/01/ful_func.xhp#func_im_return_text"/><br/> + <embedvar href="text/scalc/01/ful_func.xhp#func_im_ignor_zero"/> + </warning> + <embed href="text/scalc/01/ful_func.xhp#func_head_example"/> + <paragraph id="par_id55891471962" role="paragraph" xml-lang="en-US"> + <item type="input">=IMCOSH("4-3i")</item><br/> + returns -27.0349456030742-3.85115333481178i. + </paragraph> + <paragraph id="par_id152561887112896" role="paragraph" xml-lang="en-US"> + <item type="input">=IMCOSH(2)</item><br/> + returns 3.76219569108363 as a string. <embedvar href="text/scalc/01/ful_func.xhp#func_imag_zero"/> + </paragraph> + <embed href="text/scalc/06/calcsamplefiles.xhp#imtrigon"/> + <section id="relatedtopics"> + <paragraph id="par_id127621276212762" role="paragraph" localize="false" xml-lang="en-US"> + <embedvar href="text/scalc/01/func_imcos.xhp#imcos_head"/>, + <embedvar href="text/scalc/01/func_imsin.xhp#imsin_head"/>, + <embedvar href="text/scalc/01/func_imsinh.xhp#imsinh_head"/> + </paragraph> + </section> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/func_imcot.xhp b/helpcontent2/source/text/scalc/01/func_imcot.xhp new file mode 100644 index 000000000..715540017 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/func_imcot.xhp @@ -0,0 +1,71 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. +--> +<meta> + <topic id="textscalc01func_imcotxml"> + <title id="tit" xml-lang="en-US">IMCOT function</title> + <filename>/text/scalc/01/func_imcot.xhp</filename> + </topic> +</meta> +<body> + <section id="func_imcot_function"> + <bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_IMCOT" id="bm_id762277622776227" localize="false"/> + <bookmark xml-lang="en-US" branch="index" id="bm_id762757627576275"> + <bookmark_value>IMCOT function</bookmark_value> + <bookmark_value>cotangent;complex number</bookmark_value> + </bookmark> + <h2 id="hd_id763567635676356"> + <variable id="imcot_head"> + <link href="text/scalc/01/func_imcot.xhp">IMCOT</link> + </variable> function + </h2> + <paragraph id="par_id764617646176461" role="paragraph" xml-lang="en-US"> + <ahelp hid="."> + <variable id="imcot_des">Returns the cotangent of a complex number.</variable> The cotangent of a complex number can be expressed by: + </ahelp> + </paragraph> + </section> + <paragraph id="par_id311713256011430" role="paragraph" xml-lang="en-US"> + <image src="media/helpimg/scalc/IMCOT_equation.svg" id="img_id211575078735993" width="341.869px" height="59.5625px"><alt xml-lang="en-US" id="alt_id401575078735994">IMCOT equation</alt></image> + </paragraph> + <embed href="text/scalc/01/ful_func.xhp#func_im_des"/> + <embed href="text/scalc/01/ODFF.xhp#odff"/> + <embed href="text/scalc/00/avail_release.xhp#3.6"/> + <embed href="text/scalc/01/ful_func.xhp#func_head_syntax"/> + <paragraph id="par_id16051131322110" role="code" xml-lang="en-US"> + IMCOT(Complex_number) + </paragraph> + <paragraph id="par_id766137661376613" role="paragraph" xml-lang="en-US"> + Complex_number is a complex number whose cotangent is to be calculated. + </paragraph> + <note localize="false" id="par_id94162948227556"> + <embedvar href="text/scalc/01/ful_func.xhp#func_im_comp_numb"/><br/> + <embedvar href="text/scalc/01/ful_func.xhp#func_im_real_numb"/> + </note> + <warning localize="false" id="par_id10013307115559"> + <embedvar href="text/scalc/01/ful_func.xhp#func_im_return_text"/><br/> + <embedvar href="text/scalc/01/ful_func.xhp#func_im_ignor_zero"/> + </warning> + <embed href="text/scalc/01/ful_func.xhp#func_head_example"/> + <paragraph id="par_id21183436423819" role="paragraph" xml-lang="en-US"> + <item type="input">=IMCOT("4-3i")</item><br/> + returns 0.00490118239430447+0.999266927805902i. + </paragraph> + <paragraph id="par_id18472284929530" role="paragraph" xml-lang="en-US"> + <item type="input">=IMCOT(2)</item><br/> + returns -0.457657554360286 as a string. <embedvar href="text/scalc/01/ful_func.xhp#func_imag_zero"/> + </paragraph> + <embed href="text/scalc/06/calcsamplefiles.xhp#imtrigon"/> + <section id="relatedtopics"> + <paragraph id="par_id766137661376613" role="paragraph" localize="false" xml-lang="en-US"> + <embedvar href="text/scalc/01/func_imtan.xhp#imtan_head"/> + </paragraph> + </section> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/func_imcsc.xhp b/helpcontent2/source/text/scalc/01/func_imcsc.xhp new file mode 100644 index 000000000..ac1504080 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/func_imcsc.xhp @@ -0,0 +1,73 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. +--> +<meta> + <topic id="textscalc01func_imcscxml"> + <title id="tit" xml-lang="en-US">IMCSC function</title> + <filename>/text/scalc/01/func_imcsc.xhp</filename> + </topic> +</meta> +<body> + <section id="func_imcsc_function"> + <bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_IMCSC" id="bm_id930879308793087" localize="false"/> + <bookmark xml-lang="en-US" branch="index" id="bm_id931179311793117"> + <bookmark_value>IMCSC function</bookmark_value> + <bookmark_value>cosecant;complex number</bookmark_value> + </bookmark> + <h2 id="hd_id931679316793167"> + <variable id="imcsc_head"> + <link href="text/scalc/01/func_imcsc.xhp">IMCSC</link> + </variable> function + </h2> + <paragraph id="par_id932329323293232" role="paragraph" xml-lang="en-US"> + <ahelp hid="."> + <variable id="imcsc_des">Returns the cosecant of a complex number. </variable> The cosecant of a complex number can be expressed by: + </ahelp> + </paragraph> + </section> + <paragraph id="par_id13510198901485" role="paragraph" xml-lang="en-US"> + <image src="media/helpimg/scalc/IMCSC_equation.svg" id="img_id211575078735993" width="491.844px" height="59.5625px"><alt xml-lang="en-US" id="alt_id401575078735994">IMCSC equation</alt></image> + </paragraph> + <embed href="text/scalc/01/ful_func.xhp#func_im_des"/> + <embed href="text/scalc/01/ODFF.xhp#odff"/> + <embed href="text/scalc/00/avail_release.xhp#3.6"/> + <embed href="text/scalc/01/ful_func.xhp#func_head_syntax"/> + <paragraph id="par_id30461169611909" role="code" xml-lang="en-US"> + IMCSC(Complex_number) + </paragraph> + <paragraph id="par_id1899971619670" role="paragraph" xml-lang="en-US"> + Complex_number is a complex number whose cosecant needs to be calculated. + </paragraph> + <note localize="false" id="par_id147911951112700"> + <embedvar href="text/scalc/01/ful_func.xhp#func_im_comp_numb"/><br/> + <embedvar href="text/scalc/01/ful_func.xhp#func_im_real_numb"/> + </note> + <warning localize="false" id="par_id109292803120804"> + <embedvar href="text/scalc/01/ful_func.xhp#func_im_return_text"/><br/> + <embedvar href="text/scalc/01/ful_func.xhp#func_im_ignor_zero"/> + </warning> + <embed href="text/scalc/01/ful_func.xhp#func_head_example"/> + <paragraph id="par_id25692477525537" role="paragraph" xml-lang="en-US"> + <item type="input">=IMCSC("4-3i")</item><br/> + returns -0.0754898329158637-0.0648774713706355i. + </paragraph> + <paragraph id="par_id32572967420710" role="paragraph" xml-lang="en-US"> + <item type="input">=IMCSC(2)</item><br/> + returns 1.09975017029462 as a string. <embedvar href="text/scalc/01/ful_func.xhp#func_imag_zero"/> + </paragraph> + <embed href="text/scalc/06/calcsamplefiles.xhp#imtrigon"/> + <section id="relatedtopics"> + <paragraph id="par_id933269332693326" role="paragraph" localize="false" xml-lang="en-US"> + <embedvar href="text/scalc/01/func_imcsch.xhp#imcsch_head"/>, + <embedvar href="text/scalc/01/func_imsec.xhp#imsec_head"/>, + <embedvar href="text/scalc/01/func_imsech.xhp#imsech_head"/> + </paragraph> + </section> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/func_imcsch.xhp b/helpcontent2/source/text/scalc/01/func_imcsch.xhp new file mode 100644 index 000000000..cd854aae4 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/func_imcsch.xhp @@ -0,0 +1,73 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. +--> +<meta> + <topic id="textscalc01func_imcschxml"> + <title id="tit" xml-lang="en-US">IMCSCH function</title> + <filename>/text/scalc/01/func_imcsch.xhp</filename> + </topic> +</meta> +<body> + <section id="func_imcsch_function"> + <bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_IMCSCH" id="bm_id975859758597585" localize="false"/> + <bookmark xml-lang="en-US" branch="index" id="bm_id976559765597655"> + <bookmark_value>IMCSCH function</bookmark_value> + <bookmark_value>hyperbolic cosecant;complex number</bookmark_value> + </bookmark> + <h2 id="hd_id977779777797777"> + <variable id="imcsch_head"> + <link href="text/scalc/01/func_imcsch.xhp">IMCSCH</link> + </variable> function + </h2> + <paragraph id="par_id979369793697936" role="paragraph" xml-lang="en-US"> + <ahelp hid="."> + <variable id="imcsch_des">Returns the hyperbolic cosecant of a complex number.</variable> The hyperbolic cosecant of a complex number can be expressed by: + </ahelp> + </paragraph> + </section> + <paragraph id="par_id195151657917534" role="paragraph" xml-lang="en-US"> + <image src="media/helpimg/scalc/IMCSCH_equation.svg" id="img_id211575078735993" width="504.344px" height="59.5625px"><alt xml-lang="en-US" id="alt_id401575078735994">IMCSCH equation</alt></image> + </paragraph> + <embed href="text/scalc/01/ful_func.xhp#func_im_des"/> + <embed href="text/scalc/01/ODFF.xhp#odff"/> + <embed href="text/scalc/00/avail_release.xhp#3.6"/> + <embed href="text/scalc/01/ful_func.xhp#func_head_syntax"/> + <paragraph id="par_id30461169611909" role="code" xml-lang="en-US"> + IMCSCH(Complex_number) + </paragraph> + <paragraph id="par_id1899971619670" role="paragraph" xml-lang="en-US"> + Complex_number is a complex number whose hyperbolic cosecant needs to be calculated. + </paragraph> + <note localize="false" id="par_id2596524410490"> + <embedvar href="text/scalc/01/ful_func.xhp#func_im_comp_numb"/><br/> + <embedvar href="text/scalc/01/ful_func.xhp#func_im_real_numb"/> + </note> + <warning localize="false" id="par_id22040168142858"> + <embedvar href="text/scalc/01/ful_func.xhp#func_im_return_text"/><br/> + <embedvar href="text/scalc/01/ful_func.xhp#func_im_ignor_zero"/> + </warning> + <embed href="text/scalc/01/ful_func.xhp#func_head_example"/> + <paragraph id="par_id16814232201137" role="paragraph" xml-lang="en-US"> + <item type="input">=IMCSCH("4-3i")</item><br/> + returns -0.036275889628626+0.0051744731840194i. + </paragraph> + <paragraph id="par_id2395211576789" role="paragraph" xml-lang="en-US"> + <item type="input">=IMCSCH(2)</item><br/> + returns 0.275720564771783 as a string. <embedvar href="text/scalc/01/ful_func.xhp#func_imag_zero"/> + </paragraph> + <embed href="text/scalc/06/calcsamplefiles.xhp#imtrigon"/> + <section id="relatedtopics"> + <paragraph id="par_id981669816698166" role="paragraph" localize="false" xml-lang="en-US"> + <embedvar href="text/scalc/01/func_imcsc.xhp#imcsc_head"/>, + <embedvar href="text/scalc/01/func_imsec.xhp#imsec_head"/>, + <embedvar href="text/scalc/01/func_imsech.xhp#imsech_head"/> + </paragraph> + </section> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/func_imsec.xhp b/helpcontent2/source/text/scalc/01/func_imsec.xhp new file mode 100644 index 000000000..ccf6b8f2b --- /dev/null +++ b/helpcontent2/source/text/scalc/01/func_imsec.xhp @@ -0,0 +1,73 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. +--> +<meta> + <topic id="textscalc01func_imsecxml"> + <title id="tit" xml-lang="en-US">IMSEC function</title> + <filename>/text/scalc/01/func_imsec.xhp</filename> + </topic> +</meta> +<body> + <section id="imsec_function"> + <bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_IMSEC" id="bm_id2198429192250" localize="false"/> + <bookmark xml-lang="en-US" branch="index" id="bm_id101862404332680"> + <bookmark_value>IMSEC function</bookmark_value> + <bookmark_value>secant;complex number</bookmark_value> + </bookmark> + <h2 id="hd_id29384186273495"> + <variable id="imsec_head"> + <link href="text/scalc/01/func_imsec.xhp">IMSEC</link> + </variable> function + </h2> + <paragraph id="par_id23292284928998" role="paragraph" xml-lang="en-US"> + <ahelp hid="."> + <variable id="imsec_des">Returns the secant of a complex number. </variable> The secant of a complex number can be expressed by: + </ahelp> + </paragraph> + </section> + <paragraph id="par_id17543461310594" role="code" xml-lang="en-US"> + <image src="media/helpimg/scalc/IMSEC_equation.svg" id="img_id211575078735993" width="491.194px" height="59.5625px"><alt xml-lang="en-US" id="alt_id401575078735994">IMSEC equation</alt></image> + </paragraph> + <embed href="text/scalc/01/ful_func.xhp#func_im_des"/> + <embed href="text/scalc/01/ODFF.xhp#odff"/> + <embed href="text/scalc/00/avail_release.xhp#3.6"/> + <embed href="text/scalc/01/ful_func.xhp#func_head_syntax"/> + <paragraph id="par_id66061624115094" role="code" xml-lang="en-US"> + IMSEC(Complex_number) + </paragraph> + <paragraph id="par_id3186739645701" role="paragraph" xml-lang="en-US"> + Complex_number is a complex number whose secant needs to be calculated. + </paragraph> + <note localize="false" id="par_id155152794716613"> + <embedvar href="text/scalc/01/ful_func.xhp#func_im_comp_numb"/><br/> + <embedvar href="text/scalc/01/ful_func.xhp#func_im_real_numb"/> + </note> + <warning localize="false" id="par_id18462725520384"> + <embedvar href="text/scalc/01/ful_func.xhp#func_im_return_text"/><br/> + <embedvar href="text/scalc/01/ful_func.xhp#func_im_ignor_zero"/> + </warning> + <embed href="text/scalc/01/ful_func.xhp#func_head_example"/> + <paragraph id="par_id16814232201137" role="paragraph" xml-lang="en-US"> + <item type="input">=IMSEC("4-3i")</item><br/> + returns -0.0652940278579471+0.0752249603027732i. + </paragraph> + <paragraph id="par_id2395211576789" role="paragraph" xml-lang="en-US"> + <item type="input">=IMSEC(2)</item><br/> + returns -2.40299796172238 as a string. <embedvar href="text/scalc/01/ful_func.xhp#func_imag_zero"/> + </paragraph> + <embed href="text/scalc/06/calcsamplefiles.xhp#imtrigon"/> + <section id="relatedtopics"> + <paragraph id="par_id57381738213791" role="paragraph" localize="false" xml-lang="en-US"> + <embedvar href="text/scalc/01/func_imcsc.xhp#imcsc_head"/>, + <embedvar href="text/scalc/01/func_imcsch.xhp#imcsch_head"/>, + <embedvar href="text/scalc/01/func_imsech.xhp#imsech_head"/> + </paragraph> + </section> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/func_imsech.xhp b/helpcontent2/source/text/scalc/01/func_imsech.xhp new file mode 100644 index 000000000..fc5155fd2 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/func_imsech.xhp @@ -0,0 +1,73 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. +--> +<meta> + <topic id="textscalc01func_imsechxml"> + <title id="tit" xml-lang="en-US">IMSECH function</title> + <filename>/text/scalc/01/func_imsech.xhp</filename> + </topic> +</meta> +<body> + <section id="imsech_function"> + <bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_IMSECH" id="bm_id26161120602354" localize="false"/> + <bookmark xml-lang="en-US" branch="index" id="bm_id220201324724579"> + <bookmark_value>IMSECH function</bookmark_value> + <bookmark_value>hyperbolic secant;complex number</bookmark_value> + </bookmark> + <h2 id="hd_id258933143113817"> + <variable id="imsech_head"> + <link href="text/scalc/01/func_imsech.xhp">IMSECH</link> + </variable> function + </h2> + <paragraph id="par_id116441182314950" role="paragraph" xml-lang="en-US"> + <ahelp hid="."> + <variable id="imsech_des">Returns the hyperbolic secant of a complex number. </variable> The hyperbolic secant of a complex number can be expressed by: + </ahelp> + </paragraph> + </section> + <paragraph id="par_id74572850718840" role="paragraph" xml-lang="en-US"> + <image src="media/helpimg/scalc/IMSECH_equation.svg" id="img_id211575078735993" width="503.694px" height="59.5625px"><alt xml-lang="en-US" id="alt_id401575078735994">IMSECH equation</alt></image> + </paragraph> + <embed href="text/scalc/01/ful_func.xhp#func_im_des"/> + <embed href="text/scalc/01/ODFF.xhp#odff"/> + <embed href="text/scalc/00/avail_release.xhp#3.6"/> + <embed href="text/scalc/01/ful_func.xhp#func_head_syntax"/> + <paragraph id="par_id17253876723855" role="code" xml-lang="en-US"> + IMSECH(Complex_number) + </paragraph> + <paragraph id="par_id31259109804356" role="paragraph" xml-lang="en-US"> + Complex_number is a complex number whose hyperbolic secant needs to be calculated. + </paragraph> + <note localize="false" id="par_id127061438920586"> + <embedvar href="text/scalc/01/ful_func.xhp#func_im_comp_numb"/><br/> + <embedvar href="text/scalc/01/ful_func.xhp#func_im_real_numb"/> + </note> + <warning localize="false" id="par_id29294203464584"> + <embedvar href="text/scalc/01/ful_func.xhp#func_im_return_text"/><br/> + <embedvar href="text/scalc/01/ful_func.xhp#func_im_ignor_zero"/> + </warning> + <embed href="text/scalc/01/ful_func.xhp#func_head_example"/> + <paragraph id="par_id1906826088444" role="paragraph" xml-lang="en-US"> + <item type="input">=IMSECH("4-3i")</item><br/> + returns -0.0362534969158689+0.00516434460775318i. + </paragraph> + <paragraph id="par_id247492030016627" role="paragraph" xml-lang="en-US"> + <item type="input">=IMSECH(2)</item><br/> + returns 0.26580222883408 as a string. <embedvar href="text/scalc/01/ful_func.xhp#func_imag_zero"/> + </paragraph> + <embed href="text/scalc/06/calcsamplefiles.xhp#imtrigon"/> + <section id="relatedtopics"> + <paragraph id="par_id26960257451996" role="paragraph" localize="false" xml-lang="en-US"> + <embedvar href="text/scalc/01/func_imcsc.xhp#imcsc_head"/>, + <embedvar href="text/scalc/01/func_imcsch.xhp#imcsch_head"/>, + <embedvar href="text/scalc/01/func_imsec.xhp#imsec_head"/> + </paragraph> + </section> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/func_imsin.xhp b/helpcontent2/source/text/scalc/01/func_imsin.xhp new file mode 100644 index 000000000..3fb20db2f --- /dev/null +++ b/helpcontent2/source/text/scalc/01/func_imsin.xhp @@ -0,0 +1,72 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. +--> +<meta> + <topic id="textscalc01func_imsinxml"> + <title id="tit" xml-lang="en-US">IMSIN function</title> + <filename>/text/scalc/01/func_imsin.xhp</filename> + </topic> +</meta> +<body> + <section id="imsin_function"> + <bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_IMSIN" id="bm_id146733115823392" localize="false"/> + <bookmark xml-lang="en-US" branch="index" id="bm_id79322063230162"> + <bookmark_value>IMSIN function</bookmark_value> + <bookmark_value>sine;complex number</bookmark_value> + </bookmark> + <h2 id="hd_id3192388765304"> + <variable id="imsin_head"> + <link href="text/scalc/01/func_imsin.xhp">IMSIN</link> + </variable> function + </h2> + <paragraph id="par_id1955633330277" role="paragraph" xml-lang="en-US"> + <ahelp hid="."> + <variable id="imsin_des">Returns the sine of a complex number. </variable> The sine of a complex number can be expressed by: + </ahelp> + </paragraph> + </section> + <paragraph id="par_id3189460120934" role="code" xml-lang="en-US"> + <image src="media/helpimg/sc_func_imsin.svg" id="img_id211575078735993" width="447.2611px" height="31.5px"><alt xml-lang="en-US" id="alt_id401575078735994">IMSIN equation</alt></image> + </paragraph> + <embed href="text/scalc/01/ful_func.xhp#func_im_des"/> + <embed href="text/scalc/01/ODFF.xhp#odff"/> + <embed href="text/scalc/01/ful_func.xhp#func_head_syntax"/> + <paragraph id="par_id284611113926520" role="code" xml-lang="en-US"> + IMSIN(Complex_number) + </paragraph> + <paragraph id="par_id31206835928272" role="paragraph" xml-lang="en-US"> + Complex_number is a complex number whose sine needs to be calculated. + </paragraph> + <note localize="false" id="par_id100182106819457"> + <embedvar href="text/scalc/01/ful_func.xhp#func_im_comp_numb"/><br/> + <embedvar href="text/scalc/01/ful_func.xhp#func_im_real_numb"/> + </note> + <warning localize="false" id="par_id7175173509788"> + <embedvar href="text/scalc/01/ful_func.xhp#func_im_return_text"/><br/> + <embedvar href="text/scalc/01/ful_func.xhp#func_im_ignor_zero"/> + </warning> + <embed href="text/scalc/01/ful_func.xhp#func_head_example"/> + <paragraph id="par_id5063188419467" role="paragraph" xml-lang="en-US"> + <item type="input">=IMSIN("4-3i")</item><br/> + returns -7.61923172032141+6.548120040911i. + </paragraph> + <paragraph id="par_id1527387141125" role="paragraph" xml-lang="en-US"> + <item type="input">=IMSIN(2)</item><br/> + returns 0.909297426825682 as a string. <embedvar href="text/scalc/01/ful_func.xhp#func_imag_zero"/> + </paragraph> + <embed href="text/scalc/06/calcsamplefiles.xhp#imtrigon"/> + <section id="relatedtopics"> + <paragraph id="par_id2773214341302" role="paragraph" localize="false" xml-lang="en-US"> + <embedvar href="text/scalc/01/func_imsinh.xhp#imsinh_head"/>, + <embedvar href="text/scalc/01/func_imcos.xhp#imcos_head"/>, + <embedvar href="text/scalc/01/func_imcosh.xhp#imcosh_head"/> + </paragraph> + </section> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/func_imsinh.xhp b/helpcontent2/source/text/scalc/01/func_imsinh.xhp new file mode 100644 index 000000000..058c31927 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/func_imsinh.xhp @@ -0,0 +1,73 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. +--> +<meta> + <topic id="textscalc01func_imsinhxml"> + <title id="tit" xml-lang="en-US">IMSINH function</title> + <filename>/text/scalc/01/func_imsinh.xhp</filename> + </topic> +</meta> +<body> + <section id="imsech_function"> + <bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_IMSINH" id="bm_id146733115823392" localize="false"/> + <bookmark xml-lang="en-US" branch="index" id="bm_id79322063230162"> + <bookmark_value>IMSINH function</bookmark_value> + <bookmark_value>hyperbolic sine;complex number</bookmark_value> + </bookmark> + <h2 id="hd_id3192388765304"> + <variable id="imsinh_head"> + <link href="text/scalc/01/func_imsinh.xhp">IMSINH</link> + </variable> function + </h2> + <paragraph id="par_id1955633330277" role="paragraph" xml-lang="en-US"> + <ahelp hid="."> + <variable id="imsinh_des">Returns the hyperbolic sine of a complex number.</variable> The hyperbolic sine of a complex number can be expressed by: + </ahelp> + </paragraph> + </section> + <paragraph id="par_id3189460120934" role="code" xml-lang="en-US"> + <image src="media/helpimg/sc_func_imsinh.svg" id="img_id211575078735993" width="459.7611px" height="31.5px"><alt xml-lang="en-US" id="alt_id401575078735994">IMSINH equation</alt></image> + </paragraph> + <embed href="text/scalc/01/ful_func.xhp#func_im_des"/> + <embed href="text/scalc/01/ODFF.xhp#odff"/> + <embed href="text/scalc/00/avail_release.xhp#3.6"/> + <embed href="text/scalc/01/ful_func.xhp#func_head_syntax"/> + <paragraph id="par_id284611113926520" role="code" xml-lang="en-US"> + IMSINH(Complex_number) + </paragraph> + <paragraph id="par_id31206835928272" role="paragraph" xml-lang="en-US"> + Complex_number is a complex number whose hyperbolic sine needs to be calculated. + </paragraph> + <note localize="false" id="par_id100182106819457"> + <embedvar href="text/scalc/01/ful_func.xhp#func_im_comp_numb"/><br/> + <embedvar href="text/scalc/01/ful_func.xhp#func_im_real_numb"/> + </note> + <warning localize="false" id="par_id7175173509788"> + <embedvar href="text/scalc/01/ful_func.xhp#func_im_return_text"/><br/> + <embedvar href="text/scalc/01/ful_func.xhp#func_im_ignor_zero"/> + </warning> + <embed href="text/scalc/01/ful_func.xhp#func_head_example"/> + <paragraph id="par_id5063188419467" role="paragraph" xml-lang="en-US"> + <item type="input">=IMSINH("4-3i")</item><br/> + returns -27.0168132580039-3.85373803791938i. + </paragraph> + <paragraph id="par_id1527387141125" role="paragraph" xml-lang="en-US"> + <item type="input">=IMSINH(2)</item><br/> + returns 3.62686040784702 as a string. <embedvar href="text/scalc/01/ful_func.xhp#func_imag_zero"/> + </paragraph> + <embed href="text/scalc/06/calcsamplefiles.xhp#imtrigon"/> + <section id="relatedtopics"> + <paragraph id="par_id2773214341302" localize="false" role="paragraph" xml-lang="en-US"> + <embedvar href="text/scalc/01/func_imsin.xhp#imsin_head"/>, + <embedvar href="text/scalc/01/func_imcos.xhp#imcos_head"/>, + <embedvar href="text/scalc/01/func_imcosh.xhp#imcosh_head"/> + </paragraph> + </section> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/func_imtan.xhp b/helpcontent2/source/text/scalc/01/func_imtan.xhp new file mode 100644 index 000000000..edabfe86c --- /dev/null +++ b/helpcontent2/source/text/scalc/01/func_imtan.xhp @@ -0,0 +1,71 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. +--> +<meta> + <topic id="textscalc01func_imtanxml"> + <title id="tit" xml-lang="en-US">IMTAN function</title> + <filename>/text/scalc/01/func_imtan.xhp</filename> + </topic> +</meta> +<body> + <section id="imtan_function"> + <bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_IMTAN" id="bm_id814415710920" localize="false"/> + <bookmark xml-lang="en-US" branch="index" id="bm_id4210250889873"> + <bookmark_value>IMTAN function</bookmark_value> + <bookmark_value>tangent;complex number</bookmark_value> + </bookmark> + <h2 id="hd_id9522389621160"> + <variable id="imtan_head"> + <link href="text/scalc/01/func_imtan.xhp">IMTAN</link> + </variable> function + </h2> + <paragraph id="par_id5700137827273" role="paragraph" xml-lang="en-US"> + <ahelp hid="."> + <variable id="imtan_des">Returns the tangent of a complex number.</variable> The tangent of a complex number can be expressed by: + </ahelp> + </paragraph> + </section> + <paragraph id="par_id25021317131239" role="paragraph" xml-lang="en-US"> + <image src="media/helpimg/scalc/IMTAN_equation.svg" id="img_id211575078735993" width="353.294px" height="59.5625px"><alt xml-lang="en-US" id="alt_id401575078735994">IMTAN equation</alt></image> + </paragraph> + <embed href="text/scalc/01/ful_func.xhp#func_im_des"/> + <embed href="text/scalc/01/ODFF.xhp#odff"/> + <embed href="text/scalc/00/avail_release.xhp#3.6"/> + <embed href="text/scalc/01/ful_func.xhp#func_head_syntax"/> + <paragraph id="par_id23219159944377" role="code" xml-lang="en-US"> + IMTAN(Complex_number) + </paragraph> + <paragraph id="par_id10242899132094" role="paragraph" xml-lang="en-US"> + Complex_number is a complex number whose tangent is to be calculated. + </paragraph> + <note localize="false" id="par_id21830101306312"> + <embedvar href="text/scalc/01/ful_func.xhp#func_im_comp_numb"/><br/> + <embedvar href="text/scalc/01/ful_func.xhp#func_im_real_numb"/> + </note> + <warning localize="false" id="par_id307202808512424"> + <embedvar href="text/scalc/01/ful_func.xhp#func_im_return_text"/><br/> + <embedvar href="text/scalc/01/ful_func.xhp#func_im_ignor_zero"/> + </warning> + <embed href="text/scalc/01/ful_func.xhp#func_head_example"/> + <paragraph id="par_id5063188419467" role="paragraph" xml-lang="en-US"> + <item type="input">=IMTAN("4-3i")</item><br/> + returns 0.00490825806749606-1.00070953606723i. + </paragraph> + <paragraph id="par_id1527387141125" role="paragraph" xml-lang="en-US"> + <item type="input">=IMTAN(2)</item><br/> + returns -2.18503986326152 as a string. <embedvar href="text/scalc/01/ful_func.xhp#func_imag_zero"/> + </paragraph> + <embed href="text/scalc/06/calcsamplefiles.xhp#imtrigon"/> + <section id="relatedtopics"> + <paragraph id="par_id2479417868613" role="paragraph" localize="false" xml-lang="en-US"> + <embedvar href="text/scalc/01/func_imcot.xhp#imcot_head"/> + </paragraph> + </section> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/func_isoweeknum.xhp b/helpcontent2/source/text/scalc/01/func_isoweeknum.xhp new file mode 100644 index 000000000..96f58c866 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/func_isoweeknum.xhp @@ -0,0 +1,48 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . + --> +<helpdocument version="1.0"> +<meta> +<topic id="textscalc01func_isoweeknumxml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">ISOWEEKNUM</title> +<filename>/text/scalc/01/func_isoweeknum.xhp</filename> +</topic> +</meta> +<body> +<bookmark xml-lang="en-US" branch="index" id="bm_id3159161"><bookmark_value>ISOWEEKNUM function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_ISOWEEKNUM" id="bm_id3158403" localize="false"/><h2 id="hd_id3159161"><variable id="isoweeknum"><link href="text/scalc/01/func_isoweeknum.xhp">ISOWEEKNUM</link> +</variable></h2> +<paragraph role="paragraph" id="par_id3149770" xml-lang="en-US"><ahelp hid="HID_FUNC_ISOWEEKNUM">ISOWEEKNUM calculates the week number of the year for the internal date value.</ahelp></paragraph> +<note id="par_idN105E4">The International Standard ISO 8601 has decreed that Monday shall be the first day of the week. A week that lies partly in one year and partly in another is assigned a number in the year in which most of its days lie. That means that week number 1 of any year is the week that contains the January 4th.</note> +<embed href="text/scalc/00/avail_release.xhp#5.1"/> +<embed href="text/scalc/01/ODFF.xhp#odff"/> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph role="code" id="par_id3147236" xml-lang="en-US">ISOWEEKNUM(Number)</paragraph> +<paragraph role="paragraph" id="par_id3147511" xml-lang="en-US"> +<emph>Number</emph> is the internal date number.</paragraph> +<embed href="text/scalc/01/04060102.xhp#datenumberinfo"/> +<embed href="text/scalc/01/04060102.xhp#datenumberwarn"/> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph role="paragraph" id="par_id3149792" xml-lang="en-US"><item type="input">=ISOWEEKNUM(DATE(1995;1;1))</item> returns 52. Week 1 starts on Monday, 1995-01-02.</paragraph> +<paragraph role="paragraph" id="par_id3149794" xml-lang="en-US"><item type="input">=ISOWEEKNUM(DATE(1999;1;1))</item> returns 53. Week 1 starts on Monday, 1999-01-04.</paragraph> +<section id="relatedtopics"> + <embed href="text/scalc/01/04060102.xhp#datetimefunctions"/> +</section> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/func_jis.xhp b/helpcontent2/source/text/scalc/01/func_jis.xhp new file mode 100644 index 000000000..ef94de403 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/func_jis.xhp @@ -0,0 +1,41 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> +<!-- +* This file is part of the LibreOffice project. +* +* This Source Code Form is subject to the terms of the Mozilla Public +* License, v. 2.0. If a copy of the MPL was not distributed with this +* file, You can obtain one at http://mozilla.org/MPL/2.0/. +* +--> + +<meta> + <topic id="calcfuncjis" indexer="include" status="PUBLISH"> + <title id="tit" xml-lang="en-US">JIS Function</title> + <filename>/text/scalc/01/func_jis.xhp</filename> + </topic> +</meta> +<body> + <section id="func_jis"> + <bookmark id="bm_id61542230672099" xml-lang="en-US" branch="hid/SC_HID_FUNC_JIS" localize="false"/> + <bookmark xml-lang="en-US" branch="index" id="bm_id831542233029549"> + <bookmark_value>JIS function</bookmark_value> + </bookmark> + <h1 id="hd_id881628776094597"><variable id="Jis_h1"><link href="text/scalc/01/func_jis.xhp" name="function JIS">JIS</link></variable></h1> + <paragraph id="par_id541542230672101" role="paragraph"><variable id="func_jis_desc"><ahelp hid=".">Converts single-byte (half-width) ASCII or katakana characters to double-byte (full-width) characters.</ahelp></variable></paragraph> + </section> + <note id="par_id151634221012221">See <link href="https://wiki.documentfoundation.org/Calc/Features/JIS_and_ASC_functions" name="wiki.documentfoundation.org Calc/Features/JIS and ASC functions">https://wiki.documentfoundation.org/Calc/Features/JIS_and_ASC_functions</link> for a conversion table.</note> + <embed href="text/scalc/01/ful_func.xhp#func_head_syntax"/> + <paragraph role="paragraph" id="par_id701542231253817"><input>JIS(Text)</input></paragraph> + <paragraph role="paragraph" id="par_id621542232197446"><emph>Text</emph>: the text string that contains characters to be converted.</paragraph> + <note id="par_id481637763523789">Applying the JIS function to a string composed of double-byte characters will return the input string without any modifications.</note> + <embed href="text/scalc/01/ful_func.xhp#func_head_example"/> + <paragraph role="paragraph" id="par_id451628776707264"><input>=JIS("LibreOffice")</input> returns the string "LibreOffice". Note that the returned string uses double-byte characters.</paragraph> + <paragraph role="paragraph" id="par_id101628778036375"><input>=JIS("ライト")</input> returns the string "ライト", which is composed of double-byte characters.</paragraph> + + <section id="relatedtopics"> + <embed href="text/scalc/01/func_asc.xhp#Asc_h1"/> + <embed href="text/scalc/01/04060110.xhp#head_text"/> + </section> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/func_maxifs.xhp b/helpcontent2/source/text/scalc/01/func_maxifs.xhp new file mode 100644 index 000000000..ec778f57d --- /dev/null +++ b/helpcontent2/source/text/scalc/01/func_maxifs.xhp @@ -0,0 +1,78 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * +--> + +<meta> + <topic id="textscalc01func_sumifsxml"> + <title id="tit" xml-lang="en-US">MAXIFS function</title> + <filename>/text/scalc/01/func_maxifs.xhp</filename> + </topic> +</meta> + +<body> +<section id="maxifs_function"> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_MAXIFS" id="bm_id657666576665766" localize="false"/> +<bookmark xml-lang="en-US" branch="index" id="bm_id658066580665806"> + <bookmark_value>MAXIFS function</bookmark_value> + <bookmark_value>maximum;satisfying conditions</bookmark_value> +</bookmark> +<h1 id="hd_id658866588665886"><variable id="maxifs_head"><link href="text/scalc/01/func_maxifs.xhp">MAXIFS</link></variable> function</h1> +<paragraph id="par_id659756597565975" role="paragraph" xml-lang="en-US"><ahelp hid="."><variable id="maxifs_des">Returns the maximum of the values of cells in a range that meets multiple criteria in multiple ranges.</variable></ahelp></paragraph> +</section> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id11655988824213" role="code" xml-lang="en-US">MAXIFS(<embedvar href="text/scalc/01/ex_data_stat_func.xhp#args" markup="ignore"/>)</paragraph> + +<paragraph id="par_id59901690530236" role="paragraph" xml-lang="en-US"><emph>Func_Range</emph> – required argument. A range of cells, a name of a named range or a label of a column or a row containing values for calculating the maximum.</paragraph> + +<embed href="text/scalc/01/ex_data_stat_func.xhp#par00"/> +<embed href="text/shared/00/00000001.xhp#regex"/> +<embed href="text/scalc/01/ex_data_stat_func.xhp#warning01"/> +<embed href="text/scalc/01/ex_data_stat_func.xhp#note01"/> +<embed href="text/scalc/01/ex_data_stat_func.xhp#par01"/> +<embed href="text/scalc/01/ODFF.xhp#odff"/> +<embed href="text/scalc/01/ex_data_stat_func.xhp#ex_func_average"/> + +<h4 id="hd_id193452436229521">Simple usage</h4> +<paragraph id="par_id94321051525036" role="paragraph" xml-lang="en-US"><item type="input">=MAXIFS(B2:B6;B2:B6;"<35")</item></paragraph> +<paragraph id="par_id28647227259438" role="paragraph" xml-lang="en-US">Calculates the maximum of values of the range B2:B6 that are greater than or equal to 20. Returns 35. The fifth row does not meet the criterion.</paragraph> +<paragraph id="par_id36952767622741" role="paragraph" xml-lang="en-US"><item type="input">=MAXIFS(C2:C6;B2:B6;">=20";C2:C6;"<90")</item></paragraph> +<paragraph id="par_id189772445525114" role="paragraph" xml-lang="en-US">Calculates the maximum of values of the range C2:C6 that are lower than 90 and correspond to cells of the B2:B6 range with values greater than or equal to 20. Returns 85, because the fourth and fifth rows do not meet at least one criterion.</paragraph> +<h4 id="hd_id30455222431067">Using regular expressions and nested functions</h4> +<paragraph id="par_id307691022525348" role="paragraph" xml-lang="en-US"><item type="input">=MAXIFS(C2:C6;B2:B6;">"&MIN(B2:B6);B2:B6;"<"&MAX(B2:B6))</item></paragraph> +<paragraph id="par_id27619246864839" role="paragraph" xml-lang="en-US">Calculates the maximum of values of the range C2:C6 that correspond to all values of the range B2:B6 except its minimum and maximum. Returns 190, because only the fourth row meet the criteria.</paragraph> +<paragraph id="par_id220502883332563" role="paragraph" xml-lang="en-US"><item type="input">=MAXIFS(C2:C6;A2:A6;"pen.*";B2:B6;"<="&MAX(B2:B6))</item></paragraph> +<paragraph id="par_id15342189586295" role="paragraph" xml-lang="en-US">Calculates the maximum of values of the range C2:C6 that correspond to all cells of the A2:A6 range starting with "pen" and to all cells of the B2:B6 range except its maximum. Returns 85, because only the third row meets all criteria.</paragraph> +<h4 id="hd_id8168283329426">Reference to a cell as a criterion</h4> +<paragraph id="par_id50762995519951" role="paragraph" xml-lang="en-US">If you need to change a criterion easily, you may want to specify it in a separate cell and use a reference to this cell in the condition of the MAXIFS function. For example, the above function can be rewritten as follows:</paragraph> +<paragraph id="par_id135761606425300" role="paragraph" xml-lang="en-US"><item type="input">=MAXIFS(C2:C6;A2:A6;E2&".*";B2:B6;"<"&MAX(B2:B6))</item></paragraph> +<paragraph id="par_id30574750215839" role="paragraph" xml-lang="en-US">If E2 = "pen", the function returns 65, because the reference to the cell is substituted with its content.</paragraph> +<embed href="text/scalc/06/calcsamplefiles.xhp#func_ifs"/> +<embed href="text/scalc/01/common_func.xhp#sectiontechinfo"/> +<embed href="text/scalc/00/avail_release.xhp#5.2"/> +<embed href="text/scalc/01/common_func.xhp#notODFF"/> +<paragraph role="paragraph" id="par_id341640873986703" localize="false"><literal>COM.MICROSOFT.MAXIFS</literal></paragraph> +<section id="relatedtopics"> +<paragraph id="par_id11921178730928" role="paragraph" xml-lang="en-US" localize="false"> +<embedvar href="text/scalc/01/04060184.xhp#max_head"/>, +<embedvar href="text/scalc/01/04060184.xhp#maxa_head"/>, +<embedvar href="text/scalc/01/04060184.xhp#min_head"/>, +<embedvar href="text/scalc/01/04060184.xhp#mina_head"/>, +</paragraph> +<paragraph id="par_id11931178730928" role="paragraph" xml-lang="en-US" localize="false"> +<embedvar href="text/scalc/01/func_countifs.xhp#countifs_head"/>, +<embedvar href="text/scalc/01/func_minifs.xhp#minifs_head"/>, +<embedvar href="text/scalc/01/func_maxifs.xhp#maxifs_head"/>, +<embedvar href="text/scalc/01/func_averageifs.xhp#averageifs_head"/>, +<embedvar href="text/scalc/01/func_sumifs.xhp#sumifs_head"/> +</paragraph> +<paragraph id="par_id15970172625152" role="paragraph" localize="false" xml-lang="en-US"><embedvar href="text/shared/01/02100001.xhp#02100001"/></paragraph> +</section> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/func_minifs.xhp b/helpcontent2/source/text/scalc/01/func_minifs.xhp new file mode 100644 index 000000000..c5ddde101 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/func_minifs.xhp @@ -0,0 +1,79 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * +--> + +<meta> + <topic id="textscalc01func_minifsxml"> + <title id="tit" xml-lang="en-US">MINIFS function</title> + <filename>/text/scalc/01/func_minifs.xhp</filename> + </topic> +</meta> + +<body> +<section id="minifs_function"> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_MINIFS" id="bm_id657666576665766" localize="false"/> +<bookmark xml-lang="en-US" branch="index" id="bm_id658066580665806"> + <bookmark_value>MINIFS function</bookmark_value> + <bookmark_value>minimum;satisfying conditions</bookmark_value> +</bookmark> +<h1 id="hd_id658866588665886"><variable id="minifs_head"><link href="text/scalc/01/func_minifs.xhp">MINIFS</link></variable> function</h1> +<paragraph id="par_id659756597565975" role="paragraph" xml-lang="en-US"><ahelp hid="."><variable id="minifs_des">Returns the minimum of the values of cells in a range that meets multiple criteria in multiple ranges.</variable></ahelp></paragraph> +</section> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id11655988824213" role="code" xml-lang="en-US">MINIFS(<embedvar href="text/scalc/01/ex_data_stat_func.xhp#args" markup="ignore"/>)</paragraph> + +<paragraph id="par_id59901690530236" role="paragraph" xml-lang="en-US"><emph>Func_Range</emph> – required argument. A range of cells, a name of a named range or a label of a column or a row containing values for calculating the minimum.</paragraph> + +<embed href="text/scalc/01/ex_data_stat_func.xhp#par00"/> +<embed href="text/shared/00/00000001.xhp#regex"/> +<embed href="text/scalc/01/ex_data_stat_func.xhp#warning01"/> +<embed href="text/scalc/01/ex_data_stat_func.xhp#note01"/> +<embed href="text/scalc/01/ex_data_stat_func.xhp#par01"/> +<embed href="text/scalc/01/ODFF.xhp#odff"/> +<embed href="text/scalc/01/ex_data_stat_func.xhp#ex_func_average"/> + +<h4 id="hd_id193452436229521">Simple usage</h4> +<paragraph id="par_id94321051525036" role="paragraph" xml-lang="en-US"><item type="input">=MINIFS(B2:B6;B2:B6;"<35")</item></paragraph> +<paragraph id="par_id28647227259438" role="paragraph" xml-lang="en-US">Calculates the minimum of values of the range B2:B6 that are lower than or equal to 20. Returns 17.</paragraph> +<paragraph id="par_id36952767622741" role="paragraph" xml-lang="en-US"><item type="input">=MINIFS(C2:C6;B2:B6;">=20";C2:C6;">90")</item></paragraph> +<paragraph id="par_id189772445525114" role="paragraph" xml-lang="en-US">Calculates the minimum of values of the range C2:C6 that are lower than 90 and correspond to cells of the B2:B6 range with values greater than or equal to 20. Returns 190.</paragraph> +<h4 id="hd_id30455222431067">Using regular expressions and nested functions</h4> +<paragraph id="par_id307691022525348" role="paragraph" xml-lang="en-US"><item type="input">=MINIFS(C2:C6;B2:B6;">"&MIN(B2:B6);B2:B6;"<"&MAX(B2:B6))</item></paragraph> +<paragraph id="par_id27619246864839" role="paragraph" xml-lang="en-US">Calculates the minimum of values of the range C2:C6 that correspond to all values of the range B2:B6 except its minimum and maximum. Returns 65.</paragraph> +<paragraph id="par_id220502883332563" role="paragraph" xml-lang="en-US"><item type="input">=MINIFS(C2:C6;A2:A6;".*book";B2:B6;">"&MIN(B2:B6))</item></paragraph> +<paragraph id="par_id15342189586295" role="paragraph" xml-lang="en-US">Calculates the minimum of values of the range C2:C6 that correspond to all cells of the A2:A6 range ending with "book" and to all cells of the B2:B6 range except its minimum. Returns 190.</paragraph> +<h4 id="hd_id8168283329426">Reference to a cell as a criterion</h4> +<paragraph id="par_id50762995519951" role="paragraph" xml-lang="en-US">If you need to change a criterion easily, you may want to specify it in a separate cell and use a reference to this cell in the condition of the MINIFS function. For example, the above function can be rewritten as follows:</paragraph> +<paragraph id="par_id135761606425300" role="paragraph" xml-lang="en-US"><item type="input">=MINIFS(C2:C6;A2:A6;".*"&E2;B2:B6;"<"&MAX(B2:B6))</item></paragraph> +<paragraph id="par_id30574750215839" role="paragraph" xml-lang="en-US">If E2 = "book", the function returns 180, because the reference to the cell is substituted with its content.</paragraph> +<embed href="text/scalc/06/calcsamplefiles.xhp#func_ifs"/> +<embed href="text/scalc/01/common_func.xhp#sectiontechinfo"/> +<embed href="text/scalc/00/avail_release.xhp#5.2"/> +<embed href="text/scalc/01/common_func.xhp#notODFF"/> +<paragraph role="paragraph" id="par_id341640873986703" localize="false"><literal>COM.MICROSOFT.MINIFS</literal></paragraph> +<section id="relatedtopics"> +<paragraph id="par_id11921178730928" role="paragraph" xml-lang="en-US" localize="false"> +<embedvar href="text/scalc/01/04060184.xhp#max_head"/>, +<embedvar href="text/scalc/01/04060184.xhp#maxa_head"/>, +<embedvar href="text/scalc/01/04060184.xhp#min_head"/>, +<embedvar href="text/scalc/01/04060184.xhp#mina_head"/>, +</paragraph> +<paragraph id="par_id11931178730928" role="paragraph" xml-lang="en-US" localize="false"> +<embedvar href="text/scalc/01/func_countifs.xhp#countifs_head"/>, +<embedvar href="text/scalc/01/func_minifs.xhp#minifs_head"/>, +<embedvar href="text/scalc/01/func_maxifs.xhp#maxifs_head"/>, +<embedvar href="text/scalc/01/func_averageifs.xhp#averageifs_head"/>, +<embedvar href="text/scalc/01/func_sumifs.xhp#sumifs_head"/> +</paragraph> + +<paragraph id="par_id15970172625152" role="paragraph" localize="false" xml-lang="en-US"><embedvar href="text/shared/01/02100001.xhp#02100001"/></paragraph> +</section> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/func_minute.xhp b/helpcontent2/source/text/scalc/01/func_minute.xhp new file mode 100644 index 000000000..1bea6607f --- /dev/null +++ b/helpcontent2/source/text/scalc/01/func_minute.xhp @@ -0,0 +1,48 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . + --> +<helpdocument version="1.0"> +<meta> +<topic id="textscalc01func_minutexml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">MINUTE</title> +<filename>/text/scalc/01/func_minute.xhp</filename> +</topic> +</meta> +<body> +<bookmark xml-lang="en-US" branch="index" id="bm_id3149803"><bookmark_value>MINUTE function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_MINUTE" id="bm_id3148616" localize="false"/><h2 id="hd_id3149803"><variable id="minute"><link href="text/scalc/01/func_minute.xhp">MINUTE</link> +</variable></h2> +<paragraph role="paragraph" id="par_id3148988" xml-lang="en-US"><ahelp hid="HID_FUNC_MINUTE">Calculates the minute for an internal time value.</ahelp> The minute is returned as a number between 0 and 59.</paragraph> +<embed href="text/scalc/01/ODFF.xhp#odff"/> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph role="code" id="par_id3148660" xml-lang="en-US">MINUTE(Number)</paragraph> +<paragraph role="paragraph" id="par_id3154611" xml-lang="en-US"> +<emph>Number</emph>, as a time value, is a decimal number where the number of the minute is to be returned.</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph role="paragraph" id="par_id3148463" xml-lang="en-US"> +<item type="input">=MINUTE(8.999)</item> returns 58</paragraph> +<paragraph role="paragraph" id="par_id3149419" xml-lang="en-US"> +<item type="input">=MINUTE(8.9999)</item> returns 59</paragraph> +<paragraph role="paragraph" id="par_id3144755" xml-lang="en-US"> +<item type="input">=MINUTE(NOW())</item> returns the current minute value.</paragraph> +<section id="relatedtopics"> + <embed href="text/scalc/01/04060102.xhp#datetimefunctions"/> +</section> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/func_month.xhp b/helpcontent2/source/text/scalc/01/func_month.xhp new file mode 100644 index 000000000..9ae8ce5f5 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/func_month.xhp @@ -0,0 +1,46 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . + --> +<helpdocument version="1.0"> +<meta> +<topic id="textscalc01func_monthxml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">MONTH </title> +<filename>/text/scalc/01/func_month.xhp</filename> +</topic> +</meta> +<body> +<bookmark xml-lang="en-US" branch="index" id="bm_id3149936"><bookmark_value>MONTH function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_MONAT" id="bm_id3150628" localize="false"/><h2 id="hd_id3149936"><variable id="month"><link href="text/scalc/01/func_month.xhp">MONTH</link> +</variable></h2> +<paragraph role="paragraph" id="par_id3153538" xml-lang="en-US"><ahelp hid="HID_FUNC_MONAT">Returns the month for the given date value.</ahelp> The month is returned as an integer between 1 and 12.</paragraph> +<embed href="text/scalc/01/ODFF.xhp#odff"/> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph role="code" id="par_id3145602" xml-lang="en-US">MONTH(Number)</paragraph> +<paragraph role="paragraph" id="par_id3149485" xml-lang="en-US"> + <emph>Number</emph> is the internal date number.</paragraph> +<embed href="text/scalc/01/04060102.xhp#datenumberinfo"/> +<embed href="text/scalc/01/04060102.xhp#datenumberwarn"/> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph role="paragraph" id="par_id3149244" xml-lang="en-US"><item type="input">=MONTH(NOW())</item> returns the current month.</paragraph> +<paragraph role="paragraph" id="par_id3154790" xml-lang="en-US"><item type="input">=MONTH(C4)</item> returns 7 if you enter 2000-07-07 to cell C4 (that date value might get formatted differently after you press Enter).</paragraph> +<section id="relatedtopics"> + <embed href="text/scalc/01/04060102.xhp#datetimefunctions"/> +</section> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/func_networkdays.intl.xhp b/helpcontent2/source/text/scalc/01/func_networkdays.intl.xhp new file mode 100644 index 000000000..4a5e6d7b6 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/func_networkdays.intl.xhp @@ -0,0 +1,61 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . +--> + +<meta> + <topic id="textscalc01func_networkdaysintlxml"> + <title id="tit" xml-lang="en-US">NETWORKDAYS.INTL</title> + <filename>/text/scalc/01/func_networkdays.intl.xhp</filename> + </topic> +</meta> + +<body> +<section id="networkdaysintl_function"> +<bookmark xml-lang="en-US" branch="index" id="bm_id231020162321219565"> + <bookmark_value>NETWORKDAYS.INTL function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_NETWORKDAYS_MS" id="bm_id231020162214032558" localize="false"/> +<h2 id="hd_id231020162211573602"><variable id="networkdaysintl"><link href="text/scalc/01/func_networkdays.intl.xhp">NETWORKDAYS.INTL</link></variable></h2> +<paragraph id="par_id231020162213393086" role="paragraph" xml-lang="en-US"><ahelp hid=".">Returns the number of workdays between a start date and an end date. There are options to define weekend days and holidays. The optional weekend parameter (or a string) can be used to define the weekend days (or the non-working days in each week). Also, optionally, the user can define a holiday list. The weekend days and user-defined holidays are not counted as working days.</ahelp></paragraph> +</section> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id231020162249539143" role="code" xml-lang="en-US">NETWORKDAYS.INTL(StartDate; EndDate [; [ Weekend ] [; Holidays ] ])</paragraph> +<paragraph id="par_id231020162249533010" role="paragraph" xml-lang="en-US"><emph>StartDate</emph> is the date from when the calculation is carried out. If the start date is a workday, the day is included in the calculation.</paragraph> +<paragraph id="par_id231020162249536398" role="paragraph" xml-lang="en-US"><emph>EndDate</emph> is the date up until when the calculation is carried out. If the end date is a workday, the day is included in the calculation.</paragraph> +<embed href="text/scalc/01/common_func_workdaysintl.xhp#embed_workdays_intl"/> +<embed href="text/scalc/01/04060102.xhp#datenumberinfo"/> +<embed href="text/scalc/01/04060102.xhp#datenumberwarn"/> +<embed href="text/scalc/01/common_func.xhp#datenumbersequencenote"/> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id231020162249554032" role="paragraph" xml-lang="en-US">How many workdays fall between December 15, 2016 and January 14, 2017? Let the start date be located in C3 and the end date in D3. Cells F3 to J3 contain five (5) holidays for Christmas and New Year in date format: December 24, 2016; December 25, 2016; December 26, 2016; December 31, 2016; and January 1, 2017.</paragraph> +<paragraph id="par_id231020162249551234" role="paragraph" xml-lang="en-US"><item type="input">=NETWORKDAYS.INTL(C3;D3;;F3:J3)</item> returns 21 workdays with default for weekend days.</paragraph> +<paragraph id="par_id231020162249553109" role="paragraph" xml-lang="en-US"><item type="input">=NETWORKDAYS.INTL(C3;D3;11;F3:J3)</item> returns 24 workdays with Sunday only weekends.</paragraph> +<paragraph id="par_id231020162249557786" role="paragraph" xml-lang="en-US">Alternatively, use the weekend string “0000001” to define Sunday as the non-working day of every week.</paragraph> +<paragraph id="par_id231020162249553409" role="paragraph" xml-lang="en-US"><item type="input">=NETWORKDAYS.INTL(C3;D3;“0000001”;F3:J3)</item> returns 24 workdays with Sunday only weekend.</paragraph> +<paragraph id="par_id231020162249556946" role="paragraph" xml-lang="en-US">The function can be used without the two optional parameters – weekday and holidays – by leaving them out:</paragraph> +<paragraph id="par_id23102016224955931" role="paragraph" xml-lang="en-US"><item type="input">=NETWORKDAYS.INTL(C3;D3)</item> gives 22 working days.</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectiontechinfo"/> +<embed href="text/scalc/00/avail_release.xhp#4.3"/> +<embed href="text/scalc/01/common_func.xhp#notODFF"/> +<paragraph role="paragraph" id="par_id341640873986703" localize="false"><literal>COM.MICROSOFT.NETWORKDAYS.INTL</literal></paragraph> +<section id="relatedtopics"> + <embed href="text/scalc/01/04060102.xhp#datetimefunctions"/> +</section> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/func_networkdays.xhp b/helpcontent2/source/text/scalc/01/func_networkdays.xhp new file mode 100644 index 000000000..dc5681d14 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/func_networkdays.xhp @@ -0,0 +1,59 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . +--> + +<meta> + <topic id="textscalc01func_networkdaysxml" indexer="include" status="PUBLISH"> + <title id="tit" xml-lang="en-US">NETWORKDAYS</title> + <filename>/text/scalc/01/func_networkdays.xhp</filename> + </topic> +</meta> + +<body> + +<bookmark xml-lang="en-US" branch="index" id="bm_id3151254"> + <bookmark_value>NETWORKDAYS function</bookmark_value> + <bookmark_value>NETWORKDAYS_EXCEL2003 function</bookmark_value> +</bookmark> + +<bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_NETWORKDAYS" id="bm_id3153696" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_NETWORKDAYS_MS" id="bm_id3152396" localize="false"/> +<h2 id="hd_id3151254"><variable id="networkdays"><link href="text/scalc/01/func_networkdays.xhp">NETWORKDAYS</link></variable></h2> +<paragraph id="par_id3153788" role="paragraph" xml-lang="en-US"><ahelp hid="HID_AAI_FUNC_NETWORKDAYS">Returns the number of workdays between a <emph>start date</emph> and an <emph>end date</emph>. Holidays can be deducted.</ahelp></paragraph> +<embed href="text/scalc/01/04060102.xhp#ADD_note"/> +<embed href="text/scalc/01/ODFF.xhp#odff"/> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3145775" role="code" xml-lang="en-US">NETWORKDAYS(StartDate; EndDate [; [ Holidays ] [; Workdays ] ])</paragraph> +<paragraph id="par_id3153885" role="paragraph" xml-lang="en-US"><emph>StartDate</emph> is the date from when the calculation is carried out. If the start date is a workday, the day is included in the calculation.</paragraph> +<paragraph id="par_id3151110" role="paragraph" xml-lang="en-US"><emph>EndDate</emph> is the date up until when the calculation is carried out. If the end date is a workday, the day is included in the calculation.</paragraph> +<paragraph id="par_id3154115" role="paragraph" xml-lang="en-US"><emph>Holidays</emph> is an optional list of holidays. These are non-working days. Enter a cell range in which the holidays are listed individually.</paragraph> +<paragraph id="par_id160920161749585013" role="paragraph" xml-lang="en-US"><emph>Workdays</emph> is an optional list of number values defining standard work week. This list starts by Sunday, workdays are indicated by zero and non-working days by non-zero value.</paragraph> +<embed href="text/scalc/01/04060102.xhp#datenumberinfo"/> +<embed href="text/scalc/01/04060102.xhp#datenumberwarn"/> +<embed href="text/scalc/01/common_func.xhp#datenumbersequencenote"/> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3154661" role="paragraph" xml-lang="en-US">How many workdays fall between 2001-12-15 and 2002-01-15? The start date is located in C3 and the end date in D3. Cells F3 to J3 contain the following Christmas and New Year holidays: "2001-12-24", "2001-12-25", "2001-12-26", "2001-12-31", "2002-01-01".</paragraph> +<paragraph id="par_id3147328" role="paragraph" xml-lang="en-US"><item type="input">=NETWORKDAYS(C3;D3;F3:J3)</item> returns 17 workdays.</paragraph> +<paragraph id="par_id160920161751233621" role="paragraph" xml-lang="en-US">How many workdays fall between September 12nd and 25th in 2016 if only Mondays, Tuesdays and Wednesdays are considered as workdays?</paragraph> +<paragraph id="par_id160920161751235483" role="paragraph" xml-lang="en-US"><item type="input">=NETWORKDAYS(DATE(2016;9;12); DATE(2016;9;25); ; {1;0;0;0;1;1;1})</item> returns 6 workdays.</paragraph> +<section id="relatedtopics"> + <embed href="text/scalc/01/04060102.xhp#datetimefunctions"/> +</section> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/func_now.xhp b/helpcontent2/source/text/scalc/01/func_now.xhp new file mode 100644 index 000000000..45227d288 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/func_now.xhp @@ -0,0 +1,44 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . + --> +<helpdocument version="1.0"> +<meta> +<topic id="textscalc01func_nowxml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">NOW</title> +<filename>/text/scalc/01/func_now.xhp</filename> +</topic> +</meta> +<body> +<bookmark xml-lang="en-US" branch="index" id="bm_id3150521"><bookmark_value>NOW function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_JETZT" id="bm_id3150532" localize="false"/><h2 id="hd_id3150521"><variable id="now"><link href="text/scalc/01/func_now.xhp">NOW</link> +</variable></h2> +<paragraph role="paragraph" id="par_id3148829" xml-lang="en-US"><ahelp hid="HID_FUNC_JETZT">Returns the computer system date and time.</ahelp> The value is updated when you recalculate the document or each time a cell value is modified.</paragraph> +<embed href="text/scalc/01/ful_func.xhp#func_volatile"/> +<embed href="text/scalc/01/ODFF.xhp#odff"/> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph role="code" id="par_id3154897" xml-lang="en-US">NOW()</paragraph> +<paragraph role="paragraph" id="par_id4598529" xml-lang="en-US">NOW is a function without arguments.</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph role="paragraph" id="par_id3150774" xml-lang="en-US"> +<item type="input">=NOW()-A1</item> returns the difference between the date in A1 and now. Format the result as a number.</paragraph> +<section id="relatedtopics"> + <embed href="text/scalc/01/04060102.xhp#datetimefunctions"/> +</section> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/func_numbervalue.xhp b/helpcontent2/source/text/scalc/01/func_numbervalue.xhp new file mode 100644 index 000000000..b0c8f385e --- /dev/null +++ b/helpcontent2/source/text/scalc/01/func_numbervalue.xhp @@ -0,0 +1,60 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> +<!-- +* This file is part of the LibreOffice project. +* +* This Source Code Form is subject to the terms of the Mozilla Public +* License, v. 2.0. If a copy of the MPL was not distributed with this +* file, You can obtain one at http://mozilla.org/MPL/2.0/. +* +* This file incorporates work covered by the following license notice: +* +* Licensed to the Apache Software Foundation (ASF) under one or more +* contributor license agreements. See the NOTICE file distributed +* with this work for additional information regarding copyright +* ownership. The ASF licenses this file to you under the Apache +* License, Version 2.0 (the "License"); you may not use this file +* except in compliance with the License. You may obtain a copy of +* the License at http://www.apache.org/licenses/LICENSE-2.0 . +--> + +<meta> + <topic id="textscalc01func_numbervaluexml" indexer="include" status="PUBLISH"> + <title xml-lang="en-US" id="tit">NUMBERVALUE </title> + <filename>/text/scalc/01/func_numbervalue.xhp</filename> + </topic> +</meta> +<body> + <bookmark xml-lang="en-US" branch="index" id="bm_id3145621"> + <bookmark_value>NUMBERVALUE function</bookmark_value> + </bookmark> + <bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_NUMBERVALUE" id="bm_id3163820" localize="false"/> + <h1 id="hd_id3145621"><variable id="numbervalue_h1"><link href="text/scalc/01/func_numbervalue.xhp">NUMBERVALUE</link></variable></h1> + <paragraph xml-lang="en-US" id="par_id3145087" role="paragraph"> + <ahelp hid="HID_FUNC_NUMBERVALUE">Converts the string representation of a number into a locale-independent numeric value.</ahelp> + </paragraph> + <embed href="text/scalc/00/avail_release.xhp#4.1"/> + <paragraph xml-lang="en-US" id="par_id3149281" role="paragraph">The input text may be in a locale-dependent or other bespoke format.</paragraph> + <paragraph role="paragraph" id="par_id381625600941159">The output number is formatted as a valid floating point value and shown using the current cell's number format.</paragraph> + <tip id="par_id351625601754290">Refer to the <link href="text/shared/01/05020300.xhp" name="num_format_link">Numbers / Format</link> help page to learn how to change the format of numbers in a cell.</tip> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph role="code" id="par_id721625602228575">NUMBERVALUE(Text[; Decimal Separator[; Group Separator]])</paragraph> + <paragraph xml-lang="en-US" id="par_id3154819" role="paragraph"><emph>Text</emph> is a string that contains the number to be converted.</paragraph> + <paragraph xml-lang="en-US" id="par_id3154820" role="paragraph"><emph>Decimal Separator</emph> is a single character that specifies the decimal separator in <emph>Text</emph>. It can be omitted if <emph>Text</emph> does not include any decimal or group separators.</paragraph> + <paragraph xml-lang="en-US" id="par_id3154821" role="paragraph"><emph>Group Separator</emph> is a string that specifies the character(s) used as the group separator in <emph>Text</emph>. It can be omitted if <emph>Text</emph> does not include any group separators. The <emph>Decimal Separator</emph> character should not be used in <emph>Group Separator</emph>.</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexamples"/> + <paragraph xml-lang="en-US" id="par_id3155841" role="paragraph"> + <input>=NUMBERVALUE("1.234.567,89"; ","; ".")</input> returns 1234567.89 (considering en-US locale). The function removes the two group separators and changes the decimal separator from a comma to a full stop.</paragraph> + <paragraph role="paragraph" id="par_id721625603302860"> + <input>=NUMBERVALUE("123·4"; "·")</input> returns 123.4 (considering en-US locale). The function changes the decimal separator from a "·" to a full stop. No group separator is used in the supplied number and so the <emph>Group Separator</emph> argument is omitted.</paragraph> + <paragraph role="paragraph" id="par_id491625603415715"> + <input>=NUMBERVALUE("123e12")</input> returns 1.23E+14 (considering en-US locale). No decimal or group separators are used in the supplied number and so the <emph>Decimal Separator</emph> and <emph>Group Separator</emph> arguments are omitted.</paragraph> + <paragraph role="paragraph" id="par_id801625603497421"> + <input>=NUMBERVALUE("1#!234#!567"; "."; "#!")</input> returns 1234567 (considering en-US locale). Note that in this case the group separator is specified as a two-character string.</paragraph> + <tip id="par_id451626100385699">Refer to the <link href="https://wiki.documentfoundation.org/Documentation/Calc_Functions/NUMBERVALUE" name="NUMBERVALUE_Wiki">NUMBERVALUE</link> wiki page for more details about this function.</tip> + + <section id="relatedtopics"> + <embed href="text/scalc/01/func_value.xhp#Value_h1"/> + </section> + </body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/func_opt_barrier.xhp b/helpcontent2/source/text/scalc/01/func_opt_barrier.xhp new file mode 100644 index 000000000..3c9b23401 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/func_opt_barrier.xhp @@ -0,0 +1,58 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> + <!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + --> + + <meta> + <topic id="funcoptbarrier" indexer="include" status="PUBLISH"> + <title id="tit" xml-lang="en-US">Function OPT_BARRIER</title> + <filename>/text/scalc/01/func_opt_barrier.xhp</filename> + </topic> + </meta> + <body> + <section id="optbarrier"> + <bookmark xml-lang="en-US" branch="index" id="bm_id511575065323638"> + <bookmark_value>OPT_BARRIER function</bookmark_value> + </bookmark> + <bookmark id="bm_id941575063871993" xml-lang="en-US" branch="hid/SC_HID_PAI_FUNC_OPT_BARRIER" localize="false"/> + <h2 id="hd_id241575063871994"><variable id="optbrarrierh1"><link href="text/scalc/01/func_opt_barrier.xhp" name="OPT_BARRIER">OPT_BARRIER</link></variable></h2> + <paragraph id="par_id121575063871995" role="paragraph" xml-lang="en-US"><variable id="variable name"><ahelp hid=".">Returns the pricing for a barrier option, calculated using the Black-Scholes option pricing model.</ahelp></variable></paragraph> + </section> + <embed href="text/scalc/01/func_opt_touch.xhp#opttip"/> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph role="code" id="par_id371575067051846">OPT_BARRIER(Spot; Volatility; Rate; Foreign Rate; Maturity; Strike; LowerBarrier; UpperBarrier; Rebate; PutCall; InOut; BarrierMonitoring [; Greek])</paragraph> + <paragraph role="paragraph" id="par_id641575073609823" localize="false"><embedvar href="text/scalc/01/func_opt_touch.xhp#optspot" markup="keep"/></paragraph> + <paragraph role="paragraph" id="par_id731575073617425" localize="false"><embedvar href="text/scalc/01/func_opt_touch.xhp#optvolat" markup="keep"/></paragraph> + <paragraph role="paragraph" id="par_id341575073621215" localize="false"><embedvar href="text/scalc/01/func_opt_touch.xhp#optrate" markup="keep"/></paragraph> + <paragraph role="paragraph" id="par_id391575073625097" localize="false"><embedvar href="text/scalc/01/func_opt_touch.xhp#optfrate" markup="keep"/></paragraph> + <paragraph role="paragraph" id="par_id541575073629073" localize="false"><embedvar href="text/scalc/01/func_opt_touch.xhp#optmaturity" markup="keep"/></paragraph> + <paragraph role="paragraph" id="par_id681575073426941"><emph>Strike</emph> is the strike price of the option and should be non-negative.</paragraph> + <paragraph role="paragraph" id="par_id321575073632473" localize="false"><embedvar href="text/scalc/01/func_opt_touch.xhp#optlowbar" markup="keep"/></paragraph> + <paragraph role="paragraph" id="par_id541575073636017" localize="false"><embedvar href="text/scalc/01/func_opt_touch.xhp#optupbar" markup="keep"/></paragraph> + <paragraph role="paragraph" id="par_id671575073495724"><emph>Rebate</emph> is the amount of money to be paid at maturity if the barrier is hit.</paragraph> + <paragraph role="paragraph" id="par_id691575073511191"><variable id="optputcall"><emph>Put or Call</emph> is a string that defines whether the option is a put (“p”) or a call (“c”).</variable></paragraph> + <paragraph role="paragraph" id="par_id11575073641257" localize="false"><embedvar href="text/scalc/01/func_opt_touch.xhp#optinout" markup="keep"/></paragraph> + <paragraph role="paragraph" id="par_id211575073645423" localize="false"><embedvar href="text/scalc/01/func_opt_touch.xhp#optbarmon" markup="keep"/></paragraph> + <embed href="text/scalc/01/func_opt_touch.xhp#optgreek"/> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph role="paragraph" id="par_id651575073773761"><input>=OPT_BARRIER(30;0.2;0.06;0;1;40;25;0;0;"c";"o";"c")</input> returns the value 0.4243.</paragraph> + <paragraph role="paragraph" id="par_id401575073777593"><input>=OPT_BARRIER(50;0.4;0.05;0;0.5;65;0;80;0;"p";"o";"c";"e")</input> returns the value 10.1585.</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectiontechinfo"/> + <embed href="text/scalc/00/avail_release.xhp#4.0"/> + <embed href="text/scalc/01/common_func.xhp#notODFF"/> + <paragraph role="paragraph" id="par_id341640873986703" localize="false"><literal>COM.SUN.STAR.SHEET.ADDIN.PRICINGFUNCTIONS.GETOPTBARRIER</literal></paragraph> + <section id="relatedtopics"> + <embed href="text/scalc/01/func_opt_barrier.xhp#optbrarrierh1"/> + <embed href="text/scalc/01/func_opt_touch.xhp#opttouchh1"/> + <embed href="text/scalc/01/func_opt_prob_inmoney.xhp#optprobinmoneyh1"/> + <embed href="text/scalc/01/func_opt_prob_hit.xhp#optprobhith1"/> + <embed href="text/scalc/01/func_opt_touch.xhp#relatedfinancial"/> + </section> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/func_opt_prob_hit.xhp b/helpcontent2/source/text/scalc/01/func_opt_prob_hit.xhp new file mode 100644 index 000000000..3737e6c7c --- /dev/null +++ b/helpcontent2/source/text/scalc/01/func_opt_prob_hit.xhp @@ -0,0 +1,56 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> + <!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + --> + + <meta> + <topic id="functoptprobhit" indexer="include" status="PUBLISH"> + <title id="tit" xml-lang="en-US">Function OPT_PROB_HIT</title> + <filename>/text/scalc/01/func_opt_prob_hit.xhp</filename> + </topic> + </meta> + <body> + <section id="optprobhit"> + <bookmark xml-lang="en-US" branch="index" id="bm_id961575074485125"> + <bookmark_value>OPT_PROB_HIT function</bookmark_value> + </bookmark> + <bookmark id="bm_id391575063908362" xml-lang="en-US" branch="hid/SC_HID_PAI_FUNC_OPT_PROB_HIT" localize="false"/> + <h2 id="hd_id71575063908363"><variable id="optprobhith1"><link href="text/scalc/01/func_opt_prob_hit.xhp" name="OPT_PROB_HIT">OPT_PROB_HIT</link></variable></h2> + <paragraph id="par_id591575063908364" role="paragraph" xml-lang="en-US"><variable id="variable name"><ahelp hid=".">Returns the probability that an asset hits a predetermined barrier price, assuming that the stock price can be modeled as a process S that follows the stochastic differential equation</ahelp></variable>, as follows.</paragraph> + <paragraph role="paragraph" id="par_id21575078735992" xml-lang="en-US"> + <image src="media/helpimg/sc_func_opt01.svg" id="img_id211575078735993" width="197.38334px" height="51.2125px"><alt xml-lang="en-US" id="alt_id401575078735994">OPT_PROB_HIT equation</alt></image> + </paragraph> + <paragraph role="paragraph" id="par_id821575074114118"><literal>µ</literal> is the asset’s percentage drift, <literal>vol</literal> is the percentage volatility of the stock, and <literal>dW</literal> is a random sample drawn from a normal distribution with a zero mean. <literal>W</literal> is a Wiener process or Brownian motion.</paragraph> + </section> + <embed href="text/scalc/01/func_opt_touch.xhp#opttip"/> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph role="code" id="par_id211575074192954">OPT_PROB_HIT(Spot; Volatility; Drift; Maturity; LowerBarrier; UpperBarrier)</paragraph> + <paragraph role="paragraph" id="par_id641575073609823" localize="false"><embedvar href="text/scalc/01/func_opt_touch.xhp#optspot" markup="keep"/></paragraph> + <paragraph role="paragraph" id="par_id731575073617425" localize="false"><embedvar href="text/scalc/01/func_opt_touch.xhp#optvolat" markup="keep"/></paragraph> + <paragraph role="paragraph" id="par_id901575074339820"><variable id="optdrift"><emph>Drift</emph> is the annual stock price percentage drift rate (µ in the above formula). The value is expressed as a decimal (for example, enter 15% as 0.15).</variable></paragraph> + <paragraph role="paragraph" id="par_id541575073629073" localize="false"><embedvar href="text/scalc/01/func_opt_touch.xhp#optmaturity" markup="keep"/></paragraph> + <paragraph role="paragraph" id="par_id681575073426941"><variable id="optstrike"><emph>Strike</emph> is the strike price of the option and should be non-negative.</variable></paragraph> + <paragraph role="paragraph" id="par_id321575073632473" localize="false"><embedvar href="text/scalc/01/func_opt_touch.xhp#optlowbar" markup="keep"/></paragraph> + <paragraph role="paragraph" id="par_id541575073636017" localize="false"><embedvar href="text/scalc/01/func_opt_touch.xhp#optupbar" markup="keep"/></paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph role="paragraph" id="par_id971575074431070"><input>=OPT_PROB_HIT(30;0.2;0.3;1;0;40)</input> returns the value 0.6119.</paragraph> + <paragraph role="paragraph" id="par_id171575074434932"><input>=OPT_PROB_HIT(70;0.3;0.1;0.5;60;0)</input> returns the value 0.4239.</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectiontechinfo"/> + <embed href="text/scalc/00/avail_release.xhp#4.0"/> + <embed href="text/scalc/01/common_func.xhp#notODFF"/> + <paragraph role="paragraph" id="par_id341640873986703" localize="false"><literal>COM.SUN.STAR.SHEET.ADDIN.PRICINGFUNCTIONS.GETOPTPROBHIT</literal></paragraph> + <section id="relatedtopics"> + <embed href="text/scalc/01/func_opt_barrier.xhp#optbrarrierh1"/> + <embed href="text/scalc/01/func_opt_touch.xhp#opttouchh1"/> + <embed href="text/scalc/01/func_opt_prob_inmoney.xhp#optprobinmoneyh1"/> + <embed href="text/scalc/01/func_opt_prob_hit.xhp#optprobhith1"/> + <embed href="text/scalc/01/func_opt_touch.xhp#relatedfinancial"/> + </section> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/func_opt_prob_inmoney.xhp b/helpcontent2/source/text/scalc/01/func_opt_prob_inmoney.xhp new file mode 100644 index 000000000..c5a6cab98 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/func_opt_prob_inmoney.xhp @@ -0,0 +1,65 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> + <!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + --> + + <meta> + <topic id="funcoptprobinmoney" indexer="include" status="PUBLISH"> + <title id="tit" xml-lang="en-US">Function OPT_PROB_INMONEY</title> + <filename>/text/scalc/01/func_opt_prob_inmoney.xhp</filename> + </topic> + </meta> + <body> + <section id="optprobinmoney"> + <bookmark xml-lang="en-US" branch="index" id="bm_id961575065633373"> + <bookmark_value>OPT_PROB_INMONEY function</bookmark_value> + </bookmark> + <bookmark id="bm_id971575063929082" xml-lang="en-US" branch="hid/SC_HID_PAI_FUNC_OPT_PROB_INMONEY" localize="false"/> + <h2 id="hd_id941575063929082"><variable id="optprobinmoneyh1"><link href="text/scalc/01/func_opt_prob_inmoney.xhp" name="OPT_PROB_INMONEY">OPT_PROB_INMONEY</link></variable></h2> + <paragraph id="par_id941575063929083" role="paragraph" xml-lang="en-US"><variable id="variable name"><ahelp hid=".">Returns the probability that an asset will end up between two barrier levels at maturity, assuming that the stock price can be modeled as a process S that follows the stochastic differential equation</ahelp></variable>, as follows.</paragraph> + <paragraph role="paragraph" id="par_id21575078735992" xml-lang="en-US"> + <image src="media/helpimg/sc_func_opt01.svg" id="img_id211575078735993" width="197.38334px" height="51.2125px"><alt xml-lang="en-US" id="alt_id401575078735994">OPT_PROB_INMONEY equation</alt></image> + </paragraph> + <paragraph role="paragraph" id="par_id941575074893788"><literal>µ</literal> is the asset’s percentage drift, <literal>vol</literal> is the percentage volatility of the stock, and <literal>dW</literal> is a random sample drawn from a normal distribution with a zero mean. <literal>W</literal> is a Wiener process or Brownian motion.</paragraph> + <paragraph role="paragraph" id="par_id241575075282150">If the optional <emph>Strike</emph> and <emph>PutCall</emph> arguments are included, then</paragraph> + <list type="unordered"> + <listitem> + <paragraph id="par_id931575075314553" role="listitem">For a call option, the function returns the probability that the asset will end up between <emph>Strike</emph> and <emph>UpperBarrier</emph>.</paragraph> + </listitem> + <listitem> + <paragraph id="par_id531575075321659" role="listitem">For a put option, the function returns the probability that the asset will end up between <emph>LowerBarrier</emph> and <emph>Strike</emph>.</paragraph> + </listitem> + </list> + <paragraph role="paragraph" id="par_id191575075304900">The function ignores the possibility of knock-out before maturity.</paragraph> + </section> + <embed href="text/scalc/01/func_opt_touch.xhp#opttip"/> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph role="code" id="par_id761575075027094">OPT_PROB_INMONEY(Spot; Volatility; Drift; Maturity; LowerBarrier; UpperBarrier [; Strike [; PutCall]])</paragraph> + <paragraph role="paragraph" id="par_id641575073609823" localize="false"><embedvar href="text/scalc/01/func_opt_touch.xhp#optspot" markup="keep"/></paragraph> + <paragraph role="paragraph" id="par_id731575073617425" localize="false"><embedvar href="text/scalc/01/func_opt_touch.xhp#optvolat" markup="keep"/></paragraph> + <paragraph role="paragraph" id="par_id281575079343439" localize="false"><embedvar href="text/scalc/01/func_opt_prob_hit.xhp#optdrift" markup="keep"/></paragraph> + <paragraph role="paragraph" id="par_id541575073629073" localize="false"><embedvar href="text/scalc/01/func_opt_touch.xhp#optmaturity" markup="keep"/></paragraph> + <paragraph role="paragraph" id="par_id851575079506442" localize="false"><embedvar href="text/scalc/01/func_opt_prob_hit.xhp#optstrike" markup="keep"/></paragraph> + <paragraph role="paragraph" id="par_id861575082252126" localize="false"><embedvar href="text/scalc/01/func_opt_barrier.xhp#optputcall" markup="keep"/></paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph role="paragraph" id="par_id601575074993334"><input>=OPT_PROB_INMONEY(30;0.2;0.1;1;0;50)</input> returns the value 0.9844.</paragraph> + <paragraph role="paragraph" id="par_id261575074997216"><input>=OPT_PROB_INMONEY(70;0.3;0.15;1;60;0;80;"p")</input> returns the value 0.3440.</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectiontechinfo"/> + <embed href="text/scalc/00/avail_release.xhp#4.0"/> + <embed href="text/scalc/01/common_func.xhp#notODFF"/> + <paragraph role="paragraph" id="par_id341640873986703" localize="false"><literal>COM.SUN.STAR.SHEET.ADDIN.PRICINGFUNCTIONS.GETOPTPROBINMONEY</literal></paragraph> + <section id="relatedtopics"> + <embed href="text/scalc/01/func_opt_barrier.xhp#optbrarrierh1"/> + <embed href="text/scalc/01/func_opt_touch.xhp#opttouchh1"/> + <embed href="text/scalc/01/func_opt_prob_inmoney.xhp#optprobinmoneyh1"/> + <embed href="text/scalc/01/func_opt_prob_hit.xhp#optprobhith1"/> + <embed href="text/scalc/01/func_opt_touch.xhp#relatedfinancial"/> + </section> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/func_opt_touch.xhp b/helpcontent2/source/text/scalc/01/func_opt_touch.xhp new file mode 100644 index 000000000..9abb0c37b --- /dev/null +++ b/helpcontent2/source/text/scalc/01/func_opt_touch.xhp @@ -0,0 +1,92 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> + <!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + --> + + <meta> + <topic id="functionopttouch" indexer="include" status="PUBLISH"> + <title id="tit" xml-lang="en-US">OPT_TOUCH</title> + <filename>/text/scalc/01/func_opt_touch.xhp</filename> + </topic> + </meta> + <body> + <section id="opttouch"> + <bookmark xml-lang="en-US" branch="index" id="bm_id951575065400504"> + <bookmark_value>OPT_TOUCH function</bookmark_value> + </bookmark> + <bookmark id="bm_id971575062825963" xml-lang="en-US" branch="hid/SC_HID_PAI_FUNC_OPT_TOUCH" localize="false"/> + <h2 id="hd_id41575062825964"><variable id="opttouchh1"><link href="text/scalc/01/func_opt_touch.xhp" name="function_opt_touch">OPT_TOUCH</link></variable></h2> + <paragraph id="par_id531575062825965" role="paragraph" xml-lang="en-US"><ahelp hid=".">Returns the pricing of a touch / no-touch option, calculated using the Black-Scholes option pricing model.</ahelp></paragraph> + </section> + <section id="opttip"> + <tip id="par_id371575066515276">For relevant background information, visit the <link href="https://en.wikipedia.org/wiki/Option_(finance)" name="optionfinance">Options (finance)</link> and <link href="https://en.wikipedia.org/wiki/Black–Scholes_model" name="blackscholes">Black-Scholes</link> model Wikipedia pages.</tip> + </section> + <paragraph role="paragraph" id="par_id571575080642652">Further information about touch / no-touch options may be found on many financial websites.</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph role="code" id="par_id151575063296819">OPT_TOUCH(Spot; Volatility; Rate; ForeignRate; Maturity; LowerBarrier; UpperBarrier; ForeignDomestic; InOut; BarrierMonitoring [; Greek])</paragraph> + + <paragraph role="paragraph" id="par_id321575066304659"><variable id="optspot"><emph>Spot</emph> is the price / value of the underlying asset and should be greater than 0.0.</variable></paragraph> + <paragraph role="paragraph" id="par_id31575066315078"><variable id="optvolat"><emph>Volatility</emph> is the annual percentage volatility of the underlying asset expressed as a decimal (for example, enter 30% as 0.3). The value should be greater than 0.0.</variable></paragraph> + <paragraph role="paragraph" id="par_id681575066324254"><variable id="optrate"><emph>Rate</emph> is the continuously compounded interest rate. This is a percentage expressed as a decimal (for example, enter 40% as 0.4).</variable></paragraph> + <paragraph role="paragraph" id="par_id71575066333773"><variable id="optfrate"><emph>ForeignRate</emph> is the continuously compounded foreign interest rate. This is a percentage expressed as a decimal (for example, enter 50% as 0.5).</variable></paragraph> + <paragraph role="paragraph" id="par_id21575066338734"><variable id="optmaturity"><emph>Maturity</emph> is the time to maturity of the option, in years, and should be non-negative.</variable></paragraph> + <paragraph role="paragraph" id="par_id671575066343182"><variable id="optlowbar"><emph>LowerBarrier</emph> is the predetermined lower barrier price; set to zero for no lower barrier.</variable></paragraph> + <paragraph role="paragraph" id="par_id301575066347357"><variable id="optupbar"><emph>UpperBarrier</emph> is the predetermined upper barrier price; set to zero for no upper barrier.</variable></paragraph> + <paragraph role="paragraph" id="par_id561575066355924"><variable id="optdomestic"><emph>ForeignDomestic</emph> is a string that defines whether the option pays domestic (“d”) or foreign (“f”) currency.</variable></paragraph> + <paragraph role="paragraph" id="par_id251575066360596"><variable id="optinout"><emph>InOut</emph> is a string that defines whether the option is knock-in (“i”) or knock-out (“o”).</variable></paragraph> + <paragraph role="paragraph" id="par_id861575066366861"><variable id="optbarmon"><emph>BarrierMonitoring</emph> is a string that defines whether the barrier is monitored continuously (“c”) or only at the end / maturity (“e”).</variable></paragraph> + <section id="optgreek"> + <paragraph role="paragraph" id="par_id721575066374340"><emph>Greek</emph> (optional) is a string argument. If omitted or set to “value”, “v”, “price”, or “p”, then the function simply returns the option price. If another valid string is entered, the function returns price sensitivities (Greeks) to one of the input parameters. The valid options in this case are as follows.</paragraph> + <list type="unordered"> + <listitem> + <paragraph id="par_id951575063536153" role="listitem">“delta” or “d”.</paragraph> + </listitem> + <listitem> + <paragraph id="par_id361575063554232" role="listitem">“gamma” or “g”.</paragraph> + </listitem> + <listitem> + <paragraph id="par_id961575063563017" role="listitem">“theta” or “t”.</paragraph> + </listitem> + <listitem> + <paragraph id="par_id971575063570632" role="listitem">“vega” or “e”.</paragraph> + </listitem> + <listitem> + <paragraph id="par_id631575063580705" role="listitem">“volga” or “o”.</paragraph> + </listitem> + <listitem> + <paragraph id="par_id981575063594505" role="listitem">“vanna” or “a”.</paragraph> + </listitem> + <listitem> + <paragraph id="par_id191575063598656" role="listitem">“rho” or “r”.</paragraph> + </listitem> + <listitem> + <paragraph id="par_id751575063602288" role="listitem">“rhof” or “f”.</paragraph> + </listitem> + </list> + </section> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph role="paragraph" id="par_id181575063666675"><input>=OPT_TOUCH(50;0.25;0.05;0;1;0;55;"d";"i";"c")</input> returns the value 0.6876.</paragraph> + <paragraph role="paragraph" id="par_id811575063677250"><input>=OPT_TOUCH(80;0.2;0.05;0;0.5;60;0;"f";"o";"c";"r")</input> returns the value 15.5516.</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectiontechinfo"/> + <embed href="text/scalc/00/avail_release.xhp#4.0"/> + <embed href="text/scalc/01/common_func.xhp#notODFF"/> + <paragraph role="paragraph" id="par_id341640873986703" localize="false"><literal>COM.SUN.STAR.SHEET.ADDIN.PRICINGFUNCTIONS.GETOPTTOUCH</literal></paragraph> + <section id="relatedtopics"> + <embed href="text/scalc/01/func_opt_barrier.xhp#optbrarrierh1"/> + <embed href="text/scalc/01/func_opt_touch.xhp#opttouchh1"/> + <embed href="text/scalc/01/func_opt_prob_inmoney.xhp#optprobinmoneyh1"/> + <embed href="text/scalc/01/func_opt_prob_hit.xhp#optprobhith1"/> + <section id="relatedfinancial"> + <paragraph role="paragraph" id="par_id121575125779535"><link href="text/scalc/01/04060103.xhp">Financial Functions Part One</link></paragraph> + <paragraph role="paragraph" id="par_id251575125873714"><link href="text/scalc/01/04060119.xhp">Financial Functions Part Two</link></paragraph> + <paragraph role="paragraph" id="par_id191575125878595"><link href="text/scalc/01/04060118.xhp">Financial Functions Part Three</link></paragraph> + </section> + </section> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/func_rawsubtract.xhp b/helpcontent2/source/text/scalc/01/func_rawsubtract.xhp new file mode 100644 index 000000000..6d59f956f --- /dev/null +++ b/helpcontent2/source/text/scalc/01/func_rawsubtract.xhp @@ -0,0 +1,43 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * +--> +<meta> + <topic id="textscalc01func_rawsubtractxml"> + <title id="tit" xml-lang="en-US">RAWSUBTRACT function</title> + <filename>/text/scalc/01/func_rawsubtract.xhp</filename> + </topic> +</meta> +<body> +<section id="rawsubtract_function"> + <bookmark xml-lang="en-US" branch="hid/SC_OPCODE_RAWSUBTRACT" id="bm_2016112109239" localize="false"/> + <bookmark xml-lang="en-US" branch="index" id="bm_2016112109230"> + <bookmark_value>rawsubtract;subtraction</bookmark_value> + <bookmark_value>RAWSUBTRACT function</bookmark_value> + </bookmark> + <section id="func_rawsubtract"> + <h1 id="hd_2016112109231"><variable id="rawsubtracth1"><link href="text/scalc/01/func_rawsubtract.xhp">RAWSUBTRACT</link></variable></h1> + <paragraph id="par_2016112109232" role="paragraph" xml-lang="en-US"><ahelp hid=".">Subtracts a set of numbers and gives the result without eliminating small roundoff errors.</ahelp></paragraph> + </section> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph id="par_2016112109233" role="code" xml-lang="en-US">RAWSUBTRACT(Minuend; Subtrahend 1[; Subtrahend 2][; … ;[ Subtrahend 254]])</paragraph> + <paragraph id="par_2016112109234" role="paragraph" xml-lang="en-US"><emph>Minuend</emph> is a number or a reference to a cell containing a number.</paragraph> + <paragraph id="par_id241585352178687" role="paragraph" xml-lang="en-US"><emph>Subtrahend 1[; Subtrahend 2][; ... ;[ Subtrahend 254]]</emph> are numbers or references to cells containing numbers.</paragraph> + <paragraph id="par_2016112109235" role="paragraph" xml-lang="en-US">The function should be called with at least two parameters.</paragraph> + <paragraph role="paragraph" id="par_id271624030692893">RAWSUBTRACT() processes arguments from left to right. For example, RAWSUBTRACT(1;2;3;4) calculates 1-2-3-4 or ((1-2)-3)-4 in "natural" order.</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph id="par_2016112109236" role="paragraph" xml-lang="en-US"><input>=RAWSUBTRACT(0.987654321098765, 0.9876543210987)</input> returns 6.53921361504217E-14</paragraph> + <paragraph id="par_2016112109237" role="paragraph" xml-lang="en-US"><input>=RAWSUBTRACT(0.987654321098765)</input> returns Err:511 (Missing variable) because RAWSUBTRACT requires a minimum of two numbers. </paragraph> + <embed href="text/scalc/01/common_func.xhp#sectiontechinfo"/> + <embed href="text/scalc/00/avail_release.xhp#5.2"/> + <embed href="text/scalc/01/common_func.xhp#notODFF"/> + <paragraph role="paragraph" id="par_id311640873986703" localize="false"><literal>ORG.LIBREOFFICE.RAWSUBTRACT</literal></paragraph> +</section> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/func_regex.xhp b/helpcontent2/source/text/scalc/01/func_regex.xhp new file mode 100644 index 000000000..82119a3df --- /dev/null +++ b/helpcontent2/source/text/scalc/01/func_regex.xhp @@ -0,0 +1,51 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> + <!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + --> + + <meta> + <topic id="calcfuncregex" indexer="include" status="PUBLISH"> + <title id="tit" xml-lang="en-US">REGEX Function</title> + <filename>/text/scalc/01/func_regex.xhp</filename> + </topic> + </meta> + <body> + <section id="func_regex"> + <bookmark id="bm_id61542230672099" xml-lang="en-US" branch="hid/SC_HID_FUNC_REGEX" localize="false"/> + <bookmark xml-lang="en-US" branch="index" id="bm_id831542233029549"> + <bookmark_value>REGEX function</bookmark_value> + <bookmark_value>regular expressions;extracting in spreadsheets</bookmark_value> + <bookmark_value>regular expressions;REGEX function</bookmark_value> + </bookmark> + <h1 id="hd_id961542230672100"><link href="text/scalc/01/func_regex.xhp" name="function REGEX">REGEX</link></h1> + <paragraph id="par_id541542230672101" role="paragraph" xml-lang="en-US"><variable id="func_regex_desc"><ahelp hid=".">Matches and extracts or optionally replaces text using regular expressions.</ahelp></variable></paragraph> + </section> + <embed href="text/scalc/01/ful_func.xhp#func_head_syntax"/> + <paragraph role="code" id="par_id701542231253817" xml-lang="en-US">REGEX( Text ; Expression [ ; [ Replacement ] [ ; Flags|Occurrence ] ] )</paragraph> + <paragraph role="paragraph" id="par_id621542232197446" xml-lang="en-US"><emph>Text</emph>: A text or reference to a cell where the regular expression is to be applied.</paragraph> + <paragraph role="paragraph" id="par_id211542232209275" xml-lang="en-US"><emph>Expression</emph>: A text representing the regular expression, using <link href="https://unicode-org.github.io/icu/userguide/strings/regexp.html#regular-expression-metacharacters" name="ICU REGEXP">ICU regular expressions</link>. If there is no match and <emph>Replacement</emph> is not given, #N/A is returned.</paragraph> + <paragraph role="paragraph" id="par_id581542232755604" xml-lang="en-US"><emph>Replacement</emph>: Optional. The replacement text and references to capture groups. If there is no match, <emph>Text</emph> is returned unmodified.</paragraph> + <paragraph role="paragraph" id="par_id421542232246840" xml-lang="en-US"><emph>Flags</emph>: Optional. "g" replaces all matches of <emph>Expression</emph> in <emph>Text</emph>, not extracted. If there is no match, <emph>Text</emph> is returned unmodified.</paragraph> + <paragraph role="paragraph" id="par_id421542232246841" xml-lang="en-US"><emph>Occurrence</emph>: Optional. Number to indicate which match of <emph>Expression</emph> in <emph>Text</emph> is to be extracted or replaced. If there is no match and <emph>Replacement</emph> is not given, #N/A is returned. If there is no match and <emph>Replacement</emph> is given, <emph>Text</emph> is returned unmodified. If <emph>Occurrence</emph> is 0, <emph>Text</emph> is returned unmodified.</paragraph> + <embed href="text/scalc/01/ful_func.xhp#func_head_example"/> + <paragraph role="paragraph" id="par_id371542291684176" xml-lang="en-US"><item type="input">=REGEX("123456ABCDEF";"[:digit:]";"Z")</item> returns "Z23456ABCDEF", where the first match of a digit is replaced by "Z".</paragraph> + <paragraph role="paragraph" id="par_id891542291697194" xml-lang="en-US"><item type="input">=REGEX("123456ABCDEF";"[:digit:]";"Z";"g")</item> returns "ZZZZZZABCDEF", where all digits were replaced by "Z".</paragraph> + <paragraph role="paragraph" id="par_id21542291705695" xml-lang="en-US"><item type="input">=REGEX("123456ABCDEF";"[126]";"";"g")</item> returns "345ABCDEF", where any occurrence of "1", "2" or "6" is replaced by the empty string, thus deleted. </paragraph> + <paragraph role="paragraph" id="par_id371542291684177" xml-lang="en-US"><item type="input">=REGEX("axbxcxd";".x";;2)</item> returns "bx", the second match of ".x".</paragraph> + <paragraph role="paragraph" id="par_id371542291684178" xml-lang="en-US"><item type="input">=REGEX("axbxcxd";"(.)x";"$1y";2)</item> returns "axbycxd", the second match of "(.)x" (i.e. "bx") replaced with the captured group of one character (i.e. "b") followed by "y".</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectiontechinfo"/> + <embed href="text/scalc/00/avail_release.xhp#6.2"/> + <embed href="text/scalc/01/common_func.xhp#notODFF"/> + <paragraph role="paragraph" id="par_id311640873986703" localize="false"><literal>ORG.LIBREOFFICE.REGEX</literal></paragraph> + <section id="relatedtopics"> + <paragraph role="paragraph" id="par_id711542233602553" xml-lang="en-US"><link href="text/shared/01/02100001.xhp" name="regex lists">List of regular expressions</link></paragraph> + <paragraph role="paragraph" id="par_id431542233650614" xml-lang="en-US"><link href="https://unicode-org.github.io/icu/userguide/strings/regexp.html" name="ICU REGEXP">ICU regular expressions</link></paragraph> + </section> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/func_replaceb.xhp b/helpcontent2/source/text/scalc/01/func_replaceb.xhp new file mode 100644 index 000000000..a2e85b72c --- /dev/null +++ b/helpcontent2/source/text/scalc/01/func_replaceb.xhp @@ -0,0 +1,50 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> + <!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + --> + + <meta> + <topic id="functionreplaceb" indexer="include" status="PUBLISH"> + <title id="tit" xml-lang="en-US">REPLACEB Function</title> + <filename>/text/scalc/01/func_replaceb.xhp</filename> + </topic> + </meta> + <body> + <section id="replacebh1"> + <bookmark id="bm_id461573508637964" xml-lang="en-US" branch="hid/SC_HID_FUNC_REPLACEB" localize="false"/> + <bookmark xml-lang="en-US" branch="index" id="bm_id141573508995071"> + <bookmark_value>REPLACEB Function</bookmark_value> + <bookmark_value>replace text;REPLACEB Function</bookmark_value> + </bookmark> + <h1 id="hd_id771573508637966"><variable id="replaceb"><link href="text/scalc/01/func_replaceb.xhp" name="replaceb">REPLACEB</link></variable></h1> + <paragraph id="par_id831573508637970" role="paragraph" xml-lang="en-US"><variable id="variable name"><ahelp hid=".">Returns text where an old text is replaced with a new text, using byte positions.</ahelp></variable></paragraph> + </section> + <embed href="text/scalc/00/avail_release.xhp#6.0"/> + <embed href="text/scalc/01/ful_func.xhp#func_head_syntax"/> + <paragraph role="code" id="par_id701542231253817" xml-lang="en-US">REPLACEB( Text ; Position ; Length ; NewText )</paragraph> + <paragraph role="paragraph" id="par_id331573510857418"><emph>Text</emph>: A text expression or reference to a cell containing a text expression in which the bytes are to be replaced.</paragraph> + <paragraph role="paragraph" id="par_id431573510862075"><emph>Position</emph>: the byte position from which text is to be replaced. </paragraph> + <paragraph role="paragraph" id="par_id481573510866260"><emph>Length</emph>: the number of bytes to be replaced.</paragraph> + <paragraph role="paragraph" id="par_id911573510871412"><emph>NewText</emph>: the text to be inserted.</paragraph> + <embed href="text/scalc/01/ful_func.xhp#func_head_example"/> + + <paragraph role="paragraph" id="par_id431573515742206"><input>=REPLACEB("ᄩᄔᄕᄜᄝᄞᄠᄢᄣᄫᄬᄭᄮᄯᄲᄶ";4;1;"ab")</input> returns "ᄩ abᄕᄜᄝᄞᄠᄢᄣᄫᄬᄭᄮᄯᄲᄶ" .</paragraph> + + <tip id="par_id721626381053212">Refer to the <link href="https://wiki.documentfoundation.org/Documentation/Calc_Functions/REPLACEB" name="REPLACEB_Wiki">REPLACEB</link> wiki page for more details about this function.</tip> + + <section id="relatedtopics"> + <paragraph role="paragraph" localize="false" id="par_id171573510071709"><embedvar href="text/scalc/01/func_findb.xhp#findb" markup="ignore"/></paragraph> + <paragraph role="paragraph" localize="false" id="par_id831573510098350"><embedvar href="text/scalc/01/func_searchb.xhp#searchb" markup="ignore"/></paragraph> + <paragraph role="paragraph" localize="false" id="par_id251573510740369"><embedvar href="text/scalc/01/04060110.xhp#lenbvar" markup="ignore"/></paragraph> + <paragraph role="paragraph" localize="false" id="par_id121573511036023"><embedvar href="text/scalc/01/04060110.xhp#leftbvar" markup="ignore"/></paragraph> + <paragraph role="paragraph" localize="false" id="par_id591573511169353"><embedvar href="text/scalc/01/04060110.xhp#rightbvar" markup="ignore"/></paragraph> + <paragraph role="paragraph" localize="false" id="par_id381573511326662"><embedvar href="text/scalc/01/04060110.xhp#midbvar" markup="ignore"/></paragraph> + </section> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/func_roman.xhp b/helpcontent2/source/text/scalc/01/func_roman.xhp new file mode 100644 index 000000000..4600ab3fc --- /dev/null +++ b/helpcontent2/source/text/scalc/01/func_roman.xhp @@ -0,0 +1,46 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> +<!-- +* This file is part of the LibreOffice project. +* +* This Source Code Form is subject to the terms of the Mozilla Public +* License, v. 2.0. If a copy of the MPL was not distributed with this +* file, You can obtain one at http://mozilla.org/MPL/2.0/. +* +--> + +<meta> + <topic id="calcfuncroman" indexer="include" status="PUBLISH"> + <title id="tit" xml-lang="en-US">ROMAN Function</title> + <filename>/text/scalc/01/func_roman.xhp</filename> + </topic> +</meta> +<body> + <section id="func_roman"> + <bookmark id="bm_id61542230672099" xml-lang="en-US" branch="hid/SC_HID_FUNC_ROEMISCH" localize="false"/> + <bookmark xml-lang="en-US" branch="index" id="bm_id831542233029549"> + <bookmark_value>ROMAN function</bookmark_value> + <bookmark_value>text functions;convert to roman numbers</bookmark_value> + </bookmark> + <h1 id="hd_id881628776094597"><variable id="Roman_h1"><link href="text/scalc/01/func_roman.xhp" name="function ROMAN">ROMAN</link></variable></h1> + <paragraph id="par_id541542230672101" role="paragraph"><variable id="func_roman_desc"><ahelp hid=".">Converts a number into a Roman numeral. The value range must be between 0 and 3999. A simplification mode can be specified in the range from 0 to 4.</ahelp></variable></paragraph> + </section> + <embed href="text/scalc/01/ful_func.xhp#func_head_syntax"/> + <paragraph role="paragraph" id="par_id701542231253817"><input>ROMAN(Number [; Mode])</input></paragraph> + <paragraph role="paragraph" id="par_id621542232197446"><emph>Number</emph>: the number that is to be converted into a Roman numeral.</paragraph> + <paragraph role="paragraph" id="par_id621542232197337"><emph>Mode</emph>: optional value ranging between 0 to 4 that indicates the degree of simplification to be used in the conversion. The higher the value, the greater is the simplification of the Roman number.</paragraph> + <embed href="text/scalc/01/ful_func.xhp#func_head_example"/> + <paragraph role="paragraph" id="par_id451628776707264"><input>=ROMAN(999)</input> returns "CMXCIX" (uses simplification mode equal to zero, which is the default).</paragraph> + <paragraph role="paragraph" id="par_id101628778036375"><input>=ROMAN(999;0)</input> returns "CMXCIX".</paragraph> + <paragraph role="paragraph" id="par_id101628778036134"><input>=ROMAN(999;1)</input> returns "LMVLIV".</paragraph> + <paragraph role="paragraph" id="par_id101628778036278"><input>=ROMAN(999;2)</input> returns "XMIX".</paragraph> + <paragraph role="paragraph" id="par_id101628778036364"><input>=ROMAN(999;3)</input> returns "VMIV".</paragraph> + <paragraph role="paragraph" id="par_id101628778036008"><input>=ROMAN(999;4)</input> returns "IM".</paragraph> + <paragraph role="paragraph" id="par_id101628778036019"><input>=ROMAN(0)</input> returns "" (empty text).</paragraph> + + <section id="relatedtopics"> + <embed href="text/scalc/01/func_arabic.xhp#Arabic_h1"/> + <paragraph role="paragraph" id="par_id81634670394769" localize="false"><embedvar href="text/scalc/01/04060110.xhp#head_text"/></paragraph> + </section> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/func_rounddown.xhp b/helpcontent2/source/text/scalc/01/func_rounddown.xhp new file mode 100644 index 000000000..bfe551627 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/func_rounddown.xhp @@ -0,0 +1,52 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + --> + +<meta> + <topic id="rounddown_function" indexer="include" status="PUBLISH"> + <title id="tit" xml-lang="en-US">ROUNDDOWN function</title> + <filename>/text/scalc/01/func_rounddown.xhp</filename> + </topic> +</meta> + +<body> + <bookmark xml-lang="en-US" branch="index" id="bm_id3156384"> + <bookmark_value>ROUNDDOWN function</bookmark_value> + <bookmark_value>numbers;rounding down</bookmark_value> + </bookmark> + <bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_ABRUNDEN" id="bm_id3146003" localize="false"/> + <h1 id="hd_id601641846107898"><variable id="rounddown_h1"><link href="text/scalc/01/func_rounddown.xhp" name="rounddown_link">ROUNDDOWN function</link></variable></h1> + <section id="rounddown_desc"> + <paragraph role="paragraph" id="par_id841641927277474">Rounds down a number while keeping a specified number of decimal digits.</paragraph> + </section> + <paragraph role="paragraph" id="par_id701642530512560">This function is equivalent to the <link href="text/scalc/01/func_trunc.xhp" name="TRUNC_link">TRUNC function</link>.</paragraph> + <embed href="text/scalc/01/func_trunc.xhp#trunc_tip"/> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph role="paragraph" id="par_id341641927560587"> + <input>ROUNDDOWN(Number [; Count])</input> + </paragraph> + <section id="rounddown_parameters"> + <paragraph role="paragraph" id="par_id11641927688319"><emph>Number:</emph> The number to be rounded down.</paragraph> + <paragraph role="paragraph" id="par_id861641927715672"><emph>Count:</emph> Optional parameter that defines the number of decimal places to be kept. The default value is 0 (zero).</paragraph> + <paragraph role="paragraph" id="par_id911641928545976">Use negative values for <emph>Count</emph> to round the integer part of the original <emph>Number</emph>. For example, -1 will round down the first integer number before the decimal separator, -2 will round down the two integer numbers before the decimal separator, and so forth.</paragraph> + </section> + <note id="par_id181641929609906">In %PRODUCTNAME, the <emph>Count</emph> parameter is optional, whereas in Microsoft Excel this parameter is mandatory. When an ODS file contains a call to ROUNDDOWN without the <emph>Count</emph> parameter and the file is exported to XLS or XLSX formats, the missing argument will automatically be added with value zero to maintain compatibility.</note> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph role="paragraph" id="par_id901641928192870"><input>=ROUNDDOWN(21.89)</input> returns 21. Note that this example uses the default value for <emph>Count</emph> which is 0.</paragraph> + <paragraph role="paragraph" id="par_id901641928192110"><input>=ROUNDDOWN(103.37,1)</input> returns 103.3.</paragraph> + <paragraph role="paragraph" id="par_id171641928456743"><input>=ROUNDDOWN(0.664,2)</input> returns 0.66.</paragraph> + <paragraph role="paragraph" id="par_id641641928712287"><input>=ROUNDDOWN(214.2,-1)</input> returns 210. Note the negative value for <emph>Count</emph>, which causes the first integer value before the decimal separator to be rounded towards zero.</paragraph> + + <section id="relatedtopics"> + <embed href="text/scalc/01/func_trunc.xhp#trunc_h1"/> + <embed href="text/scalc/01/04060106.xhp#math_functions_h1"/> + </section> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/func_roundsig.xhp b/helpcontent2/source/text/scalc/01/func_roundsig.xhp new file mode 100644 index 000000000..6e96d0a58 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/func_roundsig.xhp @@ -0,0 +1,48 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> + <!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + --> + <meta> + <topic id="functionroundsig" indexer="include" status="PUBLISH"> + <title id="tit" xml-lang="en-US">ROUNDSIG Function</title> + <filename>/text/scalc/01/func_roundsig.xhp</filename> + </topic> + </meta> + <body> + <section id="roundsig"> + <bookmark id="bm_id391519154702177" xml-lang="en-US" branch="hid/SC_HID_FUNC_ROUNDSIG" localize="false"/> + <bookmark xml-lang="en-US" branch="index" id="bm_id151519154954070"> + <bookmark_value>ROUNDSIG Function</bookmark_value> + </bookmark> + <h1 id="hd_id351519154702177"><link href="text/scalc/01/func_roundsig.xhp" name="function roundsig">ROUNDSIG</link></h1> + <paragraph id="par_id921519154702177" role="paragraph" xml-lang="en-US"><variable id="roundsig"><ahelp hid="HID_FUNC_ROUNDSIG">Returns a number rounded to a specified number of significant decimal digits of its normalized floating point notation.</ahelp></variable></paragraph> + </section> + <embed href="text/scalc/01/ful_func.xhp#func_head_syntax"/> + <paragraph role="code" id="par_id291519155534115" xml-lang="en-US">ROUNDSIG( Value; Digits )</paragraph> + <paragraph role="paragraph" id="par_id51519155217204" xml-lang="en-US"><emph>Value</emph>: the number to be rounded.</paragraph> + <paragraph role="paragraph" id="par_id321519155209912" xml-lang="en-US"><emph>Digits</emph>: the number of decimal places to round.</paragraph> + + <warning id="par_id371519155264297"><emph>Digits</emph> must be an integer greater than 0.</warning> + + <embed href="text/scalc/01/ful_func.xhp#func_head_example"/> + + <paragraph role="paragraph" id="par_id691519155470333" xml-lang="en-US"><item type="input">=ROUNDSIG(123.456789; 5)</item> returns 123.46.</paragraph> + <paragraph role="paragraph" id="par_id821519155475673" xml-lang="en-US"><item type="input">=ROUNDSIG(0.000123456789; 5)</item> returns 0.00012346</paragraph> + <paragraph role="paragraph" id="par_id381519155481234" xml-lang="en-US"><item type="input">=ROUNDSIG(123456789012345; 2)</item> returns 1.2E14</paragraph> + <paragraph role="paragraph" id="par_id231519155486155" xml-lang="en-US"><item type="input">=ROUNDSIG(123456789; 4)</item> returns 123500000 or 123.5E6</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectiontechinfo"/> + <embed href="text/scalc/00/avail_release.xhp#5.4"/> + <embed href="text/scalc/01/common_func.xhp#notODFF"/> + <paragraph role="paragraph" id="par_id311640873986703" localize="false"><literal>ORG.LIBREOFFICE.ROUNDSIG</literal></paragraph> + <section id="relatedtopics"> + <paragraph role="paragraph" id="par_id51519156941987" xml-lang="en-US">See also <link href="text/scalc/01/04060106.xhp#Section21" name="ROUND function">ROUND</link>, <link href="text/scalc/01/04060106.xhp#Section7" name="MROUND function">MROUND</link>, <link href="text/scalc/01/04060106.xhp#Section19" name="ROUNDUP function">ROUNDUP</link>, <link href="text/scalc/01/04060106.xhp#Section20" name="ROUNDDOWN function">ROUNDDOWN</link>.</paragraph> + </section> + +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/func_searchb.xhp b/helpcontent2/source/text/scalc/01/func_searchb.xhp new file mode 100644 index 000000000..41262c571 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/func_searchb.xhp @@ -0,0 +1,46 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> + <!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + --> + + <meta> + <topic id="functionsearchb" indexer="include" status="PUBLISH"> + <title id="tit" xml-lang="en-US">SEARCHB Function</title> + <filename>/text/scalc/01/func_searchb.xhp</filename> + </topic> + </meta> + <body> + <section id="searchbh1"> + <bookmark id="bm_id461573508637964" xml-lang="en-US" branch="hid/SC_HID_FUNC_SEARCHB" localize="false"/> + <bookmark xml-lang="en-US" branch="index" id="bm_id141573508995071"> + <bookmark_value>SEARCHB Function</bookmark_value> + <bookmark_value>search text;SEARCHB Function</bookmark_value> + </bookmark> + <h1 id="hd_id771573508637966"><variable id="searchb"><link href="text/scalc/01/func_searchb.xhp" name="searchb">SEARCHB</link></variable></h1> + <paragraph id="par_id831573508637970" role="paragraph" xml-lang="en-US"><variable id="variable name"><ahelp hid=".">Returns the starting position of a given text, using byte positions (not case sensitive).</ahelp></variable></paragraph> + </section> + <embed href="text/scalc/00/avail_release.xhp#6.0"/> + <embed href="text/scalc/01/ful_func.xhp#func_head_syntax"/> + <paragraph role="code" id="par_id531573516878780">SEARCHB(Find Text; Text [; Position])</paragraph> + <paragraph role="paragraph" id="par_id241573517292388"><emph>Find Text</emph>: The text or text expression to be found.</paragraph> + <paragraph role="paragraph" id="par_id991573517299918"><emph>Text</emph>: the text in which the search is to be made.</paragraph> + <paragraph role="paragraph" id="par_id521573517305077"><emph>Position</emph>: The position in the text where the search starts.</paragraph> + + <embed href="text/scalc/01/ful_func.xhp#func_head_example"/> + <paragraph role="paragraph" id="par_id561573517310749"><input>=SEARCHB("ᄫᄬ";"ᄩᄔᄕᄜᄝᄞᄠgᄢᄣᄫᄬᄭᄮᄯᄲᄶ";17)</input> returns 20.</paragraph> + <section id="relatedtopics"> + <paragraph role="paragraph" localize="false" id="par_id171573510071709"><embedvar href="text/scalc/01/func_findb.xhp#findb" markup="ignore"/></paragraph> + <paragraph role="paragraph" localize="false" id="par_id961573510093188"><embedvar href="text/scalc/01/func_replaceb.xhp#replaceb" markup="ignore"/></paragraph> + <paragraph role="paragraph" localize="false" id="par_id251573510740369"><embedvar href="text/scalc/01/04060110.xhp#lenbvar" markup="ignore"/></paragraph> + <paragraph role="paragraph" localize="false" id="par_id121573511036023"><embedvar href="text/scalc/01/04060110.xhp#leftbvar" markup="ignore"/></paragraph> + <paragraph role="paragraph" localize="false" id="par_id591573511169353"><embedvar href="text/scalc/01/04060110.xhp#rightbvar" markup="ignore"/></paragraph> + <paragraph role="paragraph" localize="false" id="par_id381573511326662"><embedvar href="text/scalc/01/04060110.xhp#midbvar" markup="ignore"/></paragraph> + </section> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/func_second.xhp b/helpcontent2/source/text/scalc/01/func_second.xhp new file mode 100644 index 000000000..0baee1eed --- /dev/null +++ b/helpcontent2/source/text/scalc/01/func_second.xhp @@ -0,0 +1,46 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . + --> +<helpdocument version="1.0"> +<meta> +<topic id="textscalc01func_secondxml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">SECOND </title> +<filename>/text/scalc/01/func_second.xhp</filename> +</topic> +</meta> +<body> +<bookmark xml-lang="en-US" branch="index" id="bm_id3159390"><bookmark_value>SECOND function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_SEKUNDE" id="bm_id3155499" localize="false"/><h2 id="hd_id3159390"><variable id="second"><link href="text/scalc/01/func_second.xhp">SECOND</link> +</variable></h2> +<paragraph role="paragraph" id="par_id3148974" xml-lang="en-US"><ahelp hid="HID_FUNC_SEKUNDE">Returns the second for the given time value.</ahelp> The second is given as an integer between 0 and 59.</paragraph> +<embed href="text/scalc/01/ODFF.xhp#odff"/> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph role="code" id="par_id3148407" xml-lang="en-US">SECOND(Number)</paragraph> +<paragraph role="paragraph" id="par_id3155904" xml-lang="en-US"> +<emph>Number</emph>, as a time value, is a decimal, for which the second is to be returned.</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph role="paragraph" id="par_id3153350" xml-lang="en-US"> +<item type="input">=SECOND(NOW())</item> returns the current second</paragraph> +<paragraph role="paragraph" id="par_id3150831" xml-lang="en-US"> +<item type="input">=SECOND(C4)</item> returns 17 if contents of C4 = <item type="input">12:20:17</item>.</paragraph> +<section id="relatedtopics"> + <embed href="text/scalc/01/04060102.xhp#datetimefunctions"/> +</section> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/func_skewp.xhp b/helpcontent2/source/text/scalc/01/func_skewp.xhp new file mode 100644 index 000000000..5a9cf51ae --- /dev/null +++ b/helpcontent2/source/text/scalc/01/func_skewp.xhp @@ -0,0 +1,52 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . +--> + +<meta> + <topic id="textscalc01func_skewpxml"> + <title id="tit" xml-lang="en-US">SKEWP function</title> + <filename>/text/scalc/01/func_skewp.xhp</filename> + </topic> +</meta> +<body> +<section id="skewp_function"> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_SKEWP" id="bm_id1102201617042146" localize="false"/> +<bookmark xml-lang="en-US" branch="index" id="bm_id1102201617201921"> + <bookmark_value>skewness;population</bookmark_value> + <bookmark_value>SKEWP function</bookmark_value> +</bookmark> +<h2 id="hd_id456845684568"><variable id="skewp_head"><link href="text/scalc/01/func_skewp.xhp">SKEWP</link></variable></h2> +<paragraph id="par_id1102201617001848" role="paragraph" xml-lang="en-US"><ahelp hid=".">Calculates the skewness of a distribution using the population of a random variable.</ahelp></paragraph> +<embed href="text/scalc/00/avail_release.xhp#4.1"/> + +<embed href="text/scalc/01/ful_func.xhp#func_head_syntax"/> +<paragraph id="par_id27421466710275" role="code" xml-lang="en-US">SKEWP(<embedvar href="text/scalc/01/ful_func.xhp#number255_1" markup="keep"/>)</paragraph> +<embed href="text/scalc/01/ful_func.xhp#number255"/> +<paragraph id="par_id242131304315587" role="paragraph" xml-lang="en-US">The parameters should specify at least three values.</paragraph> +<embed href="text/scalc/01/ODFF.xhp#odff"/> +<embed href="text/scalc/01/common_func.xhp#datenumbersequencenote"/> +<embed href="text/scalc/01/ful_func.xhp#func_head_example"/> +<paragraph id="par_id1102201617001888" role="paragraph" xml-lang="en-US"><input>SKEWP(2;3;1;6;8;5)</input> returns 0.2329985562</paragraph> +<paragraph id="par_id1102201618185378" role="paragraph" xml-lang="en-US"><input>SKEWP(A1:A6)</input> returns 0.2329985562, when the range A1:A6 contains {2;3;1;6;8;5}</paragraph> +</section> +<section id="relatedtopics"> +<paragraph id="par_id14337286612130" role="paragraph" xml-lang="en-US"><link href="text/scalc/01/04060185.xhp#skew">SKEW</link></paragraph> +</section> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/func_sum.xhp b/helpcontent2/source/text/scalc/01/func_sum.xhp new file mode 100644 index 000000000..04003fb75 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/func_sum.xhp @@ -0,0 +1,48 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at https://mozilla.org/MPL/2.0/. + * +--> + +<meta> + <topic id="calcfuncsum" indexer="include" status="PUBLISH"> + <title id="tit" xml-lang="en-US">SUM Function</title> + <filename>/text/scalc/01/func_sum.xhp</filename> + </topic> +</meta> +<body> + <section id="func_sum"> + <bookmark id="bm_id691636401721449" xml-lang="en-US" branch="hid/SC_HID_FUNC_SUMME" localize="false"/> + <bookmark xml-lang="en-US" branch="index" id="id431636401649762"> + <bookmark_value>SUM function</bookmark_value> + <bookmark_value>adding;numbers in cell ranges</bookmark_value> + </bookmark> + <h1 id="hd_id121636398275790"><variable id="sum_head"><link href="text/scalc/01/func_sum.xhp" name="function SUM">SUM</link></variable></h1> + <paragraph id="par_id491636401806866" role="paragraph"><variable id="func_sum_desc"><ahelp hid=".">Adds a set of numbers.</ahelp></variable></paragraph> + </section> + + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph id="par_id3163656" role="code" xml-lang="en-US">SUM(<embedvar href="text/scalc/01/ful_func.xhp#number255_1" markup="keep"/>)</paragraph> + <embed href="text/scalc/01/ful_func.xhp#number255"/> + <embed href="text/scalc/01/common_func.xhp#datenumbersequencenote"/> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph id="par_id3163704" role="paragraph" xml-lang="en-US"><input>=SUM(2;3;4)</input> returns 9.</paragraph> + <paragraph id="par_id3151740" role="paragraph" xml-lang="en-US"><item type="input">=SUM(A1;A3;B5)</item> calculates the sum of the three cells.</paragraph> + <paragraph id="par_id931636109030406" role="paragraph" xml-lang="en-US"><item type="input">=SUM(A1:E10)</item> calculates the sum of all cells in the A1 to E10 cell range.</paragraph> + <paragraph id="par_id3151756" role="paragraph" xml-lang="en-US">A formula such as <input>=SUM((A1:A40>=C1)*(A1:A40<C2)*B1:B40)</input> may be entered as an <link href="text/scalc/01/04060107.html#hd_id3148474" name="ARRAY_FORMULA">array formula</link> by pressing the Shift<switchinline select="sys"><caseinline select="MAC">+Command</caseinline><defaultinline>+Ctrl</defaultinline></switchinline>+Enter keys instead of simply pressing the Enter key to finish entering the formula. The formula will then be shown in the Formula bar enclosed in braces and operates by multiplying corresponding elements of the arrays together and returning their sum.</paragraph> + <tip id="par_id661636108218550">Refer to the <link href="https://wiki.documentfoundation.org/Documentation/Calc_Functions/SUM" name="SUM_Wiki">SUM</link> wiki page for more details about this function.</tip> + + <section id="relatedtopics"> + <paragraph id="par_id381636401121931" role="paragraph" localize="false"> + <embedvar href="text/scalc/01/04060106.xhp#sumif_head"/>, + <embedvar href="text/scalc/01/func_sumifs.xhp#sumifs_head"/> + </paragraph> + </section> + +</body> +</helpdocument>
\ No newline at end of file diff --git a/helpcontent2/source/text/scalc/01/func_sumifs.xhp b/helpcontent2/source/text/scalc/01/func_sumifs.xhp new file mode 100644 index 000000000..924fa85b6 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/func_sumifs.xhp @@ -0,0 +1,73 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * +--> + +<meta> + <topic id="textscalc01func_sumifsxml"> + <title id="tit" xml-lang="en-US">SUMIFS function</title> + <filename>/text/scalc/01/func_sumifs.xhp</filename> + </topic> +</meta> + +<body> +<section id="sumifs_function"> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_SUMIFS" id="bm_id657666576665766" localize="false"/> +<bookmark xml-lang="en-US" branch="index" id="bm_id658066580665806"> + <bookmark_value>SUMIFS function</bookmark_value> + <bookmark_value>sum;satisfying conditions</bookmark_value> +</bookmark> +<h1 id="hd_id658866588665886"><variable id="sumifs_head"><link href="text/scalc/01/func_sumifs.xhp">SUMIFS</link></variable></h1> +<paragraph id="par_id659756597565975" role="paragraph" xml-lang="en-US"><ahelp hid="."><variable id="sumifs_des">Returns the sum of the values of cells in a range that meets multiple criteria in multiple ranges.</variable></ahelp></paragraph> +</section> +<embed href="text/scalc/00/avail_release.xhp#4.0"/> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id11655988824213" role="code" xml-lang="en-US">SUMIFS(<embedvar href="text/scalc/01/ex_data_stat_func.xhp#args" markup="ignore"/>)</paragraph> + +<paragraph id="par_id59901690530236" role="paragraph" xml-lang="en-US"><emph>Func_Range</emph> – required argument. It is a range of cells, a name of a named range or a label of a column or a row containing values for calculating the sum.</paragraph> + +<embed href="text/scalc/01/ex_data_stat_func.xhp#par00"/> +<embed href="text/shared/00/00000001.xhp#regex"/> +<embed href="text/scalc/01/ex_data_stat_func.xhp#warning01"/> +<embed href="text/scalc/01/ex_data_stat_func.xhp#note01"/> +<embed href="text/scalc/01/ex_data_stat_func.xhp#par01"/> +<embed href="text/scalc/01/ODFF.xhp#odff"/> +<embed href="text/scalc/01/ex_data_stat_func.xhp#ex_func_average"/> + +<h4 id="hd_id193452436229521">Simple usage</h4> +<paragraph id="par_id94321051525036" role="paragraph" xml-lang="en-US"><item type="input">=SUMIFS(B2:B6;B2:B6;">=20")</item></paragraph> +<paragraph id="par_id28647227259438" role="paragraph" xml-lang="en-US">Calculates the sum of values of the range B2:B6 that are greater than or equal to 20. Returns 75, because the fifth row does not meet the criterion.</paragraph> +<paragraph id="par_id36952767622741" role="paragraph" xml-lang="en-US"><item type="input">=SUMIFS(C2:C6;B2:B6;">=20";C2:C6;">70")</item></paragraph> +<paragraph id="par_id189772445525114" role="paragraph" xml-lang="en-US">Calculates the sum of values of the range C2:C6 that are greater than 70 and correspond to cells of the B2:B6 range with values greater than or equal to 20. Returns 275, because the second and the fifth rows do not meet at least one criterion.</paragraph> +<h4 id="hd_id30455222431067">Using regular expressions and nested functions</h4> +<paragraph id="par_id307691022525348" role="paragraph" xml-lang="en-US"><item type="input">=SUMIFS(C2:C6;B2:B6;">"&MIN(B2:B6);B2:B6;"<"&MAX(B2:B6))</item></paragraph> +<paragraph id="par_id27619246864839" role="paragraph" xml-lang="en-US">Calculates the sum of values of the range C2:C6 that correspond to all values of the range B2:B6 except its minimum and maximum. Returns 255, because the third and the fifth rows do not meet at least one criterion.</paragraph> +<paragraph id="par_id220502883332563" role="paragraph" xml-lang="en-US"><item type="input">=SUMIFS(C2:C6;A2:A6;"pen.*";B2:B6;"<"&MAX(B2:B6))</item></paragraph> +<paragraph id="par_id15342189586295" role="paragraph" xml-lang="en-US">Calculates the sum of values of the range C2:C6 that correspond to all cells of the A2:A6 range starting with "pen" and to all cells of the B2:B6 range except its maximum. Returns 65, because only second row meets all criteria.</paragraph> +<h4 id="hd_id8168283329426">Reference to a cell as a criterion</h4> +<paragraph id="par_id50762995519951" role="paragraph" xml-lang="en-US">If you need to change a criterion easily, you may want to specify it in a separate cell and use a reference to this cell in the condition of the SUMIFS function. For example, the above function can be rewritten as follows:</paragraph> +<paragraph id="par_id135761606425300" role="paragraph" xml-lang="en-US"><item type="input">=SUMIFS(C2:C6;A2:A6;E2&".*";B2:B6;"<"&MAX(B2:B6))</item></paragraph> +<paragraph id="par_id30574750215839" role="paragraph" xml-lang="en-US">If E2 = pen, the function returns 65, because the link to the cell is substituted with its content.</paragraph> +<embed href="text/scalc/06/calcsamplefiles.xhp#func_ifs"/> +<section id="relatedtopics"> +<paragraph id="par_id11921178730928" role="paragraph" xml-lang="en-US" localize="false"> +<embedvar href="text/scalc/01/04060106.xhp#sum_head"/>, +<embedvar href="text/scalc/01/04060106.xhp#sumif_head"/> +</paragraph> +<paragraph id="par_id11931178730928" role="paragraph" xml-lang="en-US" localize="false"> +<embedvar href="text/scalc/01/func_countifs.xhp#countifs_head"/>, +<embedvar href="text/scalc/01/func_minifs.xhp#minifs_head"/>, +<embedvar href="text/scalc/01/func_maxifs.xhp#maxifs_head"/>, +<embedvar href="text/scalc/01/func_averageifs.xhp#averageifs_head"/>, +<embedvar href="text/scalc/01/func_sumifs.xhp#sumifs_head"/> +</paragraph> +<paragraph id="par_id15970172625152" role="paragraph" localize="false" xml-lang="en-US"><embedvar href="text/shared/01/02100001.xhp#02100001"/></paragraph> + </section> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/func_switch.xhp b/helpcontent2/source/text/scalc/01/func_switch.xhp new file mode 100644 index 000000000..18a7e65b4 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/func_switch.xhp @@ -0,0 +1,47 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> + <!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + --> + + <meta> + <topic id="switchfunction" indexer="include" status="PUBLISH"> + <title id="tit" xml-lang="en-US">SWITCH function</title> + <filename>/text/scalc/01/func_switch.xhp</filename> + </topic> + </meta> + <body> + <section id="switch01"> + <bookmark id="bm_id111556242313790" xml-lang="en-US" branch="hid/SC_HID_FUNC_SWITCH_MS" localize="false"/> + <bookmark xml-lang="en-US" branch="index" id="bm_id571556244875552"> + <bookmark_value>SWITCH function</bookmark_value> + </bookmark> + <h2 id="hd_id21556242313791"><variable id="switchfunct"><link href="text/scalc/01/func_switch.xhp" name="switch">SWITCH</link></variable></h2> + <paragraph id="par_id361556242313793" role="paragraph" xml-lang="en-US"><variable id="functionswitch"><ahelp hid=".">SWITCH compares <emph>expression</emph> with <emph>value1</emph> to <emph>valuen</emph> and returns the result belonging to the first value that equals expression. If there is no match and default_result is given, that will be returned.</ahelp></variable></paragraph> + </section> + <embed href="text/scalc/01/ful_func.xhp#func_head_syntax"/> + + <paragraph role="code" id="par_id521556242803283">SWITCH(expression; value1; result1[; value2; result2][; ... ; [value127; result127][; default_result]])</paragraph> + <tip id="par_id111585520651521">If you choose not to specify a default result, 127 value / result pairs may be entered as parameters. If you choose to include a default result at the end of the list of parameters, then only 126 value / result pairs may be entered.</tip> + <paragraph role="paragraph" id="par_id341556242996378"><emph>expression</emph> is a text, numeric, logical or date input or reference to a cell.</paragraph> + <paragraph role="paragraph" id="par_id321556243790332"><emph>value1, value2, ...</emph> is any value or reference to a cell. Each value must have a result given.</paragraph> + <paragraph role="paragraph" id="par_id171556243796068"><emph>result1, result2, ...</emph> is any value or reference to a cell.</paragraph> + <paragraph role="paragraph" id="par_id331556245422283"><emph>default_result</emph>: any value or reference to a cell that is returned when there is no match.</paragraph> + <paragraph role="paragraph" id="par_id871556243022881">If no <emph>value</emph> equals <emph>expression</emph> and no default result is given, a #N/A error is returned.</paragraph> + <embed href="text/scalc/01/ful_func.xhp#func_head_example"/> + <paragraph role="paragraph" id="par_id851556243961783"><input>=SWITCH(MONTH(A3),1,"January",2,"February",3,"March","No match")</input> returns "January" when A3 contains a date in January, "February" when A3 contains a date in February , etc...</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectiontechinfo"/> + <embed href="text/scalc/00/avail_release.xhp#5.2"/> + <embed href="text/scalc/01/common_func.xhp#notODFF"/> + <paragraph role="paragraph" id="par_id341640873986703" localize="false"><literal>COM.MICROSOFT.SWITCH</literal></paragraph> + <section id="relatedtopics"> + <embed href="text/scalc/01/func_ifs.xhp#ifsfunct"/> + <paragraph role="paragraph" id="par_id781556244709752"><link href="text/scalc/01/04060105.xhp#Section4" name="if">IF</link></paragraph> + </section> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/func_textjoin.xhp b/helpcontent2/source/text/scalc/01/func_textjoin.xhp new file mode 100644 index 000000000..a4111c925 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/func_textjoin.xhp @@ -0,0 +1,48 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> + <!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + --> + + <meta> + <topic id="textjoinfunc" indexer="include" status="PUBLISH"> + <title id="tit" xml-lang="en-US">TEXTJOIN function</title> + <filename>/text/scalc/01/func_textjoin.xhp</filename> + </topic> + </meta> + <body> + <section id="textjoin01"> + <bookmark id="bm_id681556227727944" xml-lang="en-US" branch="hid/SC_HID_FUNC_TEXTJOIN_MS" localize="false"/> + <bookmark xml-lang="en-US" branch="index" id="bm_id581556228060864"> + <bookmark_value>TEXTJOIN function</bookmark_value> + </bookmark> + <h2 id="hd_id551556227727946"><variable id="textjoinfunct"><link href="text/scalc/01/func_textjoin.xhp" name="textjoinfunction">TEXTJOIN</link></variable></h2> + <paragraph id="par_id121556227727948" role="paragraph"><variable id="textjoinfunction"><ahelp hid=".">Concatenates one or more strings, and uses delimiters between them.</ahelp></variable></paragraph> + </section> + <embed href="text/scalc/01/ful_func.xhp#func_head_syntax"/> + <paragraph role="code" id="par_id541556228253979">TEXTJOIN( delimiter, skip_empty, String 1[; String 2][; … ;[String 253]] )</paragraph> + <paragraph role="paragraph" id="par_id741556228390897"><emph>delimiter</emph> is a text string and can be a range.</paragraph> + <paragraph role="paragraph" id="par_id621556228397269"><emph>skip_empty</emph> is a logical argument. When set to FALSE or 0, empty strings will be taken into account and this may lead to adjacent delimiters in the returned string. When set to any other value (e.g. TRUE or 1), empty strings will be ignored.</paragraph> + <paragraph role="paragraph" id="par_id631556228516997"><emph>String 1[; String 2][; … ;[String 253]]</emph> are strings, references to cells or to cell ranges of strings.</paragraph> + <paragraph role="paragraph" id="par_id1001556228523394">Ranges are traversed row by row (from top to bottom).</paragraph> + <paragraph role="paragraph" id="par_id81556228530082">If <emph>delimiter</emph> is a range, the range need not be of the same size as the number of strings to be joined.</paragraph> + <paragraph role="paragraph" id="par_id831556228543099">If there are more delimiters than strings to be joined, not all delimiters will be used.</paragraph> + <paragraph role="paragraph" id="par_id321556228557611">If there are less delimiters than strings to be joined, the delimiters will be used again from the start.</paragraph> + <embed href="text/scalc/01/ful_func.xhp#func_head_example"/> + <paragraph role="paragraph" id="par_id441556229012536"><input>=TEXTJOIN(" "; 1; "Here"; "comes"; "the"; "sun")</input> returns "Here comes the sun" with space character as delimiter and empty strings are ignored.</paragraph> + <paragraph role="paragraph" id="par_id441556239012536">if A1:B2 contains "Here", "comes", "the", "sun" respectively, <input>=TEXTJOIN("-";1;A1:B2)</input> returns "Here-comes-the-sun" with dash character as delimiter and empty strings are ignored.</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectiontechinfo"/> + <embed href="text/scalc/00/avail_release.xhp#5.2"/> + <embed href="text/scalc/01/common_func.xhp#notODFF"/> + <paragraph role="paragraph" id="par_id341640873986703" localize="false"><literal>COM.MICROSOFT.TEXTJOIN</literal></paragraph> + <section id="relatedtopics"> + <embed href="text/scalc/01/func_concat.xhp#concatfunct"/> + <paragraph role="paragraph" id="par_id781556244709752"><link href="text/scalc/01/04060110.xhp#concatenate" name="concatenate">CONCATENATE</link></paragraph> + </section> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/func_time.xhp b/helpcontent2/source/text/scalc/01/func_time.xhp new file mode 100644 index 000000000..1aac1737c --- /dev/null +++ b/helpcontent2/source/text/scalc/01/func_time.xhp @@ -0,0 +1,47 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . + --> +<helpdocument version="1.0"> +<meta> +<topic id="textscalc01func_timexml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">TIME </title> +<filename>/text/scalc/01/func_time.xhp</filename> +</topic> +</meta> +<body> +<bookmark xml-lang="en-US" branch="index" id="bm_id3154073"><bookmark_value>TIME function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_ZEIT" id="bm_id3150289" localize="false"/><h2 id="hd_id3154073"><variable id="time"><link href="text/scalc/01/func_time.xhp">TIME</link> +</variable></h2> +<paragraph role="paragraph" id="par_id3145762" xml-lang="en-US"><ahelp hid="HID_FUNC_ZEIT">TIME returns the current time value from values for hours, minutes and seconds.</ahelp> This function can be used to convert a time based on these three elements to a decimal time value.</paragraph> +<embed href="text/scalc/01/ODFF.xhp#odff"/> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph role="code" id="par_id3154584" xml-lang="en-US">TIME(Hour; Minute; Second)</paragraph> +<paragraph role="paragraph" id="par_id3152904" xml-lang="en-US">Use an integer to set the <emph>Hour</emph>.</paragraph> +<paragraph role="paragraph" id="par_id3151346" xml-lang="en-US">Use an integer to set the <emph>Minute</emph>.</paragraph> +<paragraph role="paragraph" id="par_id3151366" xml-lang="en-US">Use an integer to set the <emph>Second</emph>.</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph role="paragraph" id="par_id3156076" xml-lang="en-US"> +<item type="input">=TIME(0;0;0)</item> returns 00:00:00</paragraph> +<paragraph role="paragraph" id="par_id3156090" xml-lang="en-US"> +<item type="input">=TIME(4;20;4)</item> returns 04:20:04</paragraph> +<section id="relatedtopics"> + <embed href="text/scalc/01/04060102.xhp#datetimefunctions"/> +</section> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/func_timevalue.xhp b/helpcontent2/source/text/scalc/01/func_timevalue.xhp new file mode 100644 index 000000000..87bd8da08 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/func_timevalue.xhp @@ -0,0 +1,46 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> +<!--*********************************************************** +* This file is part of the LibreOffice project. +* +* This Source Code Form is subject to the terms of the Mozilla Public +* License, v. 2.0. If a copy of the MPL was not distributed with this +* file, You can obtain one at http://mozilla.org/MPL/2.0/. +* +* This file incorporates work covered by the following license notice: +* +* Licensed to the Apache Software Foundation (ASF) under one or more +* contributor license agreements. See the NOTICE file distributed +* with this work for additional information regarding copyright +* ownership. The ASF licenses this file to you under the Apache +* License, Version 2.0 (the "License"); you may not use this file +* except in compliance with the License. You may obtain a copy of +* the License at http://www.apache.org/licenses/LICENSE-2.0 . +****************************************************************--> +<meta> + <topic id="topic_0506201512165345" status="PUBLISH"> + <title xml-lang="en-US" id="tit">TIMEVALUE </title> + <filename>/text/scalc/01/func_timevalue.xhp</filename> + </topic> +</meta> +<body> + <bookmark xml-lang="en-US" branch="index" id="bm_id3146755"> + <bookmark_value>TIMEVALUE function</bookmark_value> + </bookmark> + <bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_ZEITWERT" id="bm_id3146767" localize="false"/> + <h1 id="hd_id3146755"><variable id="timevalue"><link href="text/scalc/01/func_timevalue.xhp">TIMEVALUE</link></variable></h1> + <paragraph id="par_id3148502" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_ZEITWERT">TIMEVALUE returns the internal time number from a text enclosed by quotes and which may show a possible time entry format.</ahelp></paragraph> + <embed href="text/scalc/01/ODFF.xhp#odff"/> + <paragraph id="par_id3150794" role="paragraph" xml-lang="en-US">The internal number indicated as a decimal is the result of the date system used under $[officename] to calculate date entries.</paragraph> + <paragraph id="par_id011920090347118" role="paragraph" xml-lang="en-US">If the text string also includes a year, month, or day, TIMEVALUE only returns the fractional part of the conversion.</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph id="par_id3150823" role="code" xml-lang="en-US">TIMEVALUE("Text")</paragraph> + <paragraph id="par_id3152556" role="paragraph" xml-lang="en-US"><emph>Text</emph> is a valid time expression and must be entered in quotation marks.</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph id="par_id3146829" role="paragraph" xml-lang="en-US"><item type="input">=TIMEVALUE("4PM")</item> returns 0.67. When formatting in time format HH:MM:SS, you then get 16:00:00.</paragraph> + <paragraph id="par_id3153632" role="paragraph" xml-lang="en-US"><item type="input">=TIMEVALUE("24:00")</item> returns 0. If you use the HH:MM:SS time format, the value is 00:00:00.</paragraph> + <section id="relatedtopics"> + <embed href="text/scalc/01/04060102.xhp#datetimefunctions"/> + </section> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/func_today.xhp b/helpcontent2/source/text/scalc/01/func_today.xhp new file mode 100644 index 000000000..e4214238d --- /dev/null +++ b/helpcontent2/source/text/scalc/01/func_today.xhp @@ -0,0 +1,44 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . + --> +<helpdocument version="1.0"> +<meta> +<topic id="textscalc01func_todayxml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">TODAY</title> +<filename>/text/scalc/01/func_today.xhp</filename> +</topic> +</meta> +<body> +<bookmark xml-lang="en-US" branch="index" id="bm_id3145659"><bookmark_value>TODAY function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_HEUTE" id="bm_id3147267" localize="false"/><h2 id="hd_id3145659"><variable id="today"><link href="text/scalc/01/func_today.xhp">TODAY</link> +</variable></h2> +<paragraph role="paragraph" id="par_id3153759" xml-lang="en-US"><ahelp hid="HID_FUNC_HEUTE">Returns the current computer system date.</ahelp> The value is updated when you reopen the document or modify the values of the document.</paragraph> +<embed href="text/scalc/01/ful_func.xhp#func_volatile"/> +<embed href="text/scalc/01/ODFF.xhp#odff"/> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph role="code" id="par_id3153154" xml-lang="en-US">TODAY()</paragraph> +<paragraph role="paragraph" id="par_id3154741" xml-lang="en-US"> TODAY is a function without arguments.</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph role="paragraph" id="par_id3156106" xml-lang="en-US"> +<item type="input">TODAY()</item> returns the current computer system date.</paragraph> +<section id="relatedtopics"> + <embed href="text/scalc/01/04060102.xhp#datetimefunctions"/> +</section> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/func_trunc.xhp b/helpcontent2/source/text/scalc/01/func_trunc.xhp new file mode 100644 index 000000000..22b58a278 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/func_trunc.xhp @@ -0,0 +1,54 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + --> + +<meta> + <topic id="trunc_function" indexer="include" status="PUBLISH"> + <title id="tit" xml-lang="en-US">TRUNC function</title> + <filename>/text/scalc/01/func_trunc.xhp</filename> + </topic> +</meta> + +<body> + <bookmark xml-lang="en-US" branch="index" id="bm_id3156384"> + <bookmark_value>TRUNC function</bookmark_value> + <bookmark_value>decimal places;cutting off</bookmark_value> + <bookmark_value>numbers;truncate</bookmark_value> + </bookmark> + <bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_KUERZEN" id="bm_id3157849" localize="false"/> + <h1 id="hd_id601641846107898"><variable id="trunc_h1"><link href="text/scalc/01/func_trunc.xhp" name="trunc_link">TRUNC function</link></variable></h1> + <section id="trunc_desc"> + <paragraph role="paragraph" id="par_id841641927277474">Truncates a number while keeping a specified number of decimal digits.</paragraph> + </section> + <paragraph role="paragraph" id="par_id701642530512560">This function is equivalent to the <link href="text/scalc/01/func_rounddown.xhp" name="ROUNDDOWN_link">ROUNDDOWN function</link>.</paragraph> + <section id="trunc_tip"> + <tip id="par_id321641927458888">The rounding method used by this function is known as <emph>rounding towards zero</emph>. The resulting number will always be smaller than or equal to the original number.</tip> + </section> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph role="paragraph" id="par_id341641927560587"> + <input>TRUNC(Number [; Count])</input> + </paragraph> + <section id="trunc_parameters"> + <paragraph role="paragraph" id="par_id11641927688319"><emph>Number:</emph> The number to be truncated.</paragraph> + <paragraph role="paragraph" id="par_id861641927715672"><emph>Count:</emph> Optional parameter that defines the number of decimal places to be kept. The default value is 0 (zero).</paragraph> + <paragraph role="paragraph" id="par_id911641928545976">Use negative values for <emph>Count</emph> to round the integer part of the original <emph>Number</emph>. For example, -1 will round down the first integer number before the decimal separator, -2 will round down the two integer numbers before the decimal separator, and so forth.</paragraph> + </section> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph role="paragraph" id="par_id901641928192870"><input>=TRUNC(21.89)</input> returns 21. Note that this example uses the default value for <emph>Count</emph> which is 0.</paragraph> + <paragraph role="paragraph" id="par_id901641928192110"><input>=TRUNC(103.37,1)</input> returns 103.3.</paragraph> + <paragraph role="paragraph" id="par_id171641928456743"><input>=TRUNC(0.664,2)</input> returns 0.66.</paragraph> + <paragraph role="paragraph" id="par_id641641928712287"><input>=TRUNC(214.2,-1)</input> returns 210. Note the negative value for <emph>Count</emph>, which causes the first integer value before the decimal separator to be rounded towards zero.</paragraph> + + <section id="relatedtopics"> + <embed href="text/scalc/01/func_rounddown.xhp#rounddown_h1"/> + <embed href="text/scalc/01/04060106.xhp#math_functions_h1"/> + </section> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/func_value.xhp b/helpcontent2/source/text/scalc/01/func_value.xhp new file mode 100644 index 000000000..2293c1a10 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/func_value.xhp @@ -0,0 +1,47 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> +<!-- +* This file is part of the LibreOffice project. +* +* This Source Code Form is subject to the terms of the Mozilla Public +* License, v. 2.0. If a copy of the MPL was not distributed with this +* file, You can obtain one at http://mozilla.org/MPL/2.0/. +* +--> + +<meta> + <topic id="calcfuncvalue" indexer="include" status="PUBLISH"> + <title id="tit" xml-lang="en-US">VALUE Function</title> + <filename>/text/scalc/01/func_value.xhp</filename> + </topic> +</meta> +<body> + <section id="func_value"> + <bookmark id="bm_id61542230672099" xml-lang="en-US" branch="hid/SC_HID_FUNC_VALUE" localize="false"/> + <bookmark xml-lang="en-US" branch="index" id="bm_id831542233029549"> + <bookmark_value>VALUE function</bookmark_value> + <bookmark_value>text functions;convert text to numeric value</bookmark_value> + </bookmark> + <h1 id="hd_id881628776094597"><variable id="Value_h1"><link href="text/scalc/01/func_value.xhp" name="function VALUE">VALUE</link></variable></h1> + <paragraph id="par_id541542230672101" role="paragraph" xml-lang="en-US"><variable id="func_value_desc"><ahelp hid=".">Converts the string representation of a number to numeric form. If the supplied string is a valid date, time, or date-time, the corresponding date-time serial number is returned.</ahelp></variable></paragraph> + </section> + <embed href="text/scalc/01/ful_func.xhp#func_head_syntax"/> + <paragraph role="paragraph" id="par_id701542231253817" xml-lang="en-US"><input>VALUE(Text)</input></paragraph> + <paragraph role="paragraph" id="par_id621542232197446" xml-lang="en-US"><emph>Text</emph>: A string (in quotation marks), a number, or a reference to a cell containing one of those types, that contains the value to be converted.</paragraph> + <note id="par_id731628787003937">If the <emph>Text</emph> argument is a string representing a date, time, currency or a numeric value with decimal and thousands separators, the string must comply with current locale settings.</note> + <embed href="text/scalc/01/ful_func.xhp#func_head_example"/> + <paragraph role="paragraph" id="par_id451628776707264"><input>=VALUE("1234")</input> returns the numeric value 1234.</paragraph> + <paragraph role="paragraph" id="par_id101628778036375"><input>=VALUE("+1,234.567")</input> returns 1234.567 (considering en-US locale). Note that the "+" sign could have been omitted.</paragraph> + <paragraph role="paragraph" id="par_id991628779914913"><input>=VALUE("$100")</input> returns 100 (considering en-US locale). Note that the currency prefix must match the current locale settings.</paragraph> + <paragraph role="paragraph" id="par_id101628780114427"><input>=VALUE("50%")</input> returns 0.5. Note that the character "%" causes the numeric part to be divided by 100.</paragraph> + <paragraph role="paragraph" id="par_id731628780240876"><input>=VALUE("07/30/2021")</input> returns 44407 (considering en-US locale) which is the date-time sequence number corresponding to the specified date.</paragraph> + <paragraph role="paragraph" id="par_id501628780340635"><input>=VALUE("09:20:25")</input> returns 0.389178240740741 which is the date-time sequence number corresponding to the specified time value.</paragraph> + <tip id="par_id801628779804928">Refer to the <link href="https://wiki.documentfoundation.org/Documentation/Calc_Functions/VALUE" name="VALUE Wiki">VALUE</link> wiki page for more details about this function.</tip> + + <section id="relatedtopics"> + <embed href="text/scalc/01/func_datevalue.xhp#datevalue"/> + <embed href="text/scalc/01/func_numbervalue.xhp#numbervalue_h1"/> + <embed href="text/scalc/01/func_timevalue.xhp#timevalue"/> + </section> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/func_webservice.xhp b/helpcontent2/source/text/scalc/01/func_webservice.xhp new file mode 100644 index 000000000..cd1df5c87 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/func_webservice.xhp @@ -0,0 +1,82 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- +* This file is part of the LibreOffice project. +* +* This Source Code Form is subject to the terms of the Mozilla Public +* License, v. 2.0. If a copy of the MPL was not distributed with this +* file, You can obtain one at http://mozilla.org/MPL/2.0/. +* +--> +<helpdocument version="1.0"> + <meta> + <topic id="textscalc01func_webservice" indexer="include" status="PUBLISH"> + <title id="tit" xml-lang="en-US">URI Functions</title> + <filename>/text/scalc/01/func_webservice.xhp</filename> + </topic> + </meta> + <body> + <section id="webservice"> + <bookmark xml-lang="en-US" branch="index" id="bm_id3149012"> + <bookmark_value>WEBSERVICE function</bookmark_value> + </bookmark> + <bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_WEBSERVICE" id="bm_id3150028" localize="false"/> + <section id="webservicefuncheader"> + <h2 id="hd_id3149012"><variable id="webservicefuncname"><link href="text/scalc/01/func_webservice.xhp#webservice" name="webservice">WEBSERVICE</link></variable></h2> + <paragraph role="paragraph" id="par_id3149893" xml-lang="en-US"><ahelp + hid="HID_FUNC_WEBSERVICE">Get some web content from a URI.</ahelp></paragraph> + </section> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph role="code" id="par_id3154844" xml-lang="en-US">WEBSERVICE(URI)</paragraph> + <paragraph role="paragraph" id="par_id3147469" xml-lang="en-US"><emph>URI: </emph> URI text of the web service.</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph role="paragraph" id="par_id3146142" xml-lang="en-US"><item type="input">=WEBSERVICE("wiki.documentfoundation.org/api.php?hidebots=1&days=7&limit=50&action=feedrecentchanges&feedformat=rss")</item></paragraph> + <paragraph role="paragraph" id="par_id3146143" xml-lang="en-US">Returns the web page content of "https://wiki.documentfoundation.org/api.php?hidebots=1&days=7&limit=50&action=feedrecentchanges&feedformat=rss".</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectiontechinfo"/> + <embed href="text/scalc/00/avail_release.xhp#4.2"/> + <embed href="text/scalc/01/common_func.xhp#notODFF"/> + <paragraph role="paragraph" id="par_id341640870986703" localize="false"><literal>COM.MICROSOFT.WEBSERVICE</literal></paragraph> + </section> + <section id="filterxml"> + <bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_FILTERXML" id="bm_id2950028" localize="false"/> + <bookmark xml-lang="en-US" branch="index" id="bm_id2949012"> + <bookmark_value>FILTERXML function</bookmark_value> + </bookmark> + <section id="filterxmlfuncheader"> + <h2 id="hd_id2949012"><variable id="filterxmlfuncname"><link href="text/scalc/01/func_webservice.xhp#filterxml" name="filterxml">FILTERXML</link></variable></h2> + <paragraph role="paragraph" id="par_id2949893" xml-lang="en-US"><ahelp hid="HID_FUNC_FILTERXML">Apply a XPath expression to a XML document.</ahelp></paragraph> + </section> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph role="code" id="par_id2954844" xml-lang="en-US">FILTERXML(XML Document; XPath expression)</paragraph> + <paragraph role="paragraph" id="par_id2947469" xml-lang="en-US"><emph>XML Document (required):</emph> String containing a valid XML stream.</paragraph> + <paragraph role="paragraph" id="par_id2847469" xml-lang="en-US"><emph>XPath expression (required):</emph> String containing a valid XPath expression.</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph role="paragraph" id="par_id2946142" xml-lang="en-US"><item type="input">=FILTERXML(WEBSERVICE("wiki.documentfoundation.org/api.php?hidebots=1&days=7&limit=50&action=feedrecentchanges&feedformat=rss");"//lastBuildDate")</item></paragraph> + <paragraph role="paragraph" id="par_id2946143" xml-lang="en-US"> Returns information on the last build date of the wiki.</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectiontechinfo"/> + <embed href="text/scalc/00/avail_release.xhp#4.2"/> + <embed href="text/scalc/01/common_func.xhp#notODFF"/> + <paragraph role="paragraph" id="par_id341600873986703" localize="false"><literal>COM.MICROSOFT.FILTERXML</literal></paragraph> + </section> + <section id="encodeurl"> + <bookmark id="bm_id121517132649769" xml-lang="en-US" branch="hid/SC_HID_FUNC_ENCODEURL" localize="false"/> + <bookmark xml-lang="en-US" branch="index" id="bm_id811517136840444"> + <bookmark_value>ENCODEURL function</bookmark_value> + </bookmark> + <section id="encodeurlfuncheader"> + <h2 id="hd_id671517132649769"><variable id="encodeurlname"><link href="text/scalc/01/func_webservice.xhp#encodeurl" name="linkname">ENCODEURL</link></variable></h2> + <paragraph id="par_id51517132649769" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_ENCODEURL">Returns a URL-encoded string.</ahelp></paragraph> + </section> + <paragraph role="paragraph" id="par_id721517134647880" xml-lang="en-US">Use this function to transform text with symbols of national alphabets (for example accented characters, non-ASCII alphabets or Asian words) to a string of URL-standard symbols.</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> + <paragraph role="code" id="par_id351517132879400" xml-lang="en-US">ENCODEURL(Text)</paragraph> + <paragraph role="paragraph" id="par_id921517132924079" xml-lang="en-US"><emph>Text</emph>: String to encode to a sequence of URL-standard symbols.</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph role="paragraph" id="par_id651517132994921" xml-lang="en-US">If cell A1 contains the Cyrillic text "автомобиль", <item type="input">=ENCODEURL(A1)</item> returns %D0%B0%D0%B2%D1%82%D0%BE%D0%BC%D0%BE%D0%B1%D0%B8%D0%BB%D1%8C (the word "автомобиль" means car in Russian).</paragraph> + <paragraph role="paragraph" id="par_id991517133057478" xml-lang="en-US">If cell B1 contains the text "車", <item type="input">=ENCODEURL(B1)</item> returns %E8%BB%8A ("車" means car in Japanese).</paragraph> + <embed href="text/scalc/01/common_func.xhp#sectiontechinfo"/> + <embed href="text/scalc/00/avail_release.xhp#5.0"/> + <embed href="text/scalc/01/common_func.xhp#notODFF"/> + <paragraph role="paragraph" id="par_id301640873986703" localize="false"><literal>COM.MICROSOFT.ENCODEURL</literal></paragraph> + </section> + </body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/func_weekday.xhp b/helpcontent2/source/text/scalc/01/func_weekday.xhp new file mode 100644 index 000000000..f000d5fe7 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/func_weekday.xhp @@ -0,0 +1,151 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . +--> + +<meta> + <topic id="textscalc01func_weekdayxml" indexer="include" status="PUBLISH"> + <title id="tit" xml-lang="en-US">WEEKDAY </title> + <filename>/text/scalc/01/func_weekday.xhp</filename> + </topic> +</meta> + +<body> + +<bookmark xml-lang="en-US" branch="index" id="bm_id3154925"> + <bookmark_value>WEEKDAY function</bookmark_value> +</bookmark> + +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_WOCHENTAG" id="bm_id3152359" localize="false"/> + +<h2 id="hd_id3154925"><variable id="weekday"><link href="text/scalc/01/func_weekday.xhp">WEEKDAY</link> </variable></h2> +<paragraph id="par_id3154228" role="paragraph" xml-lang="en-US"><ahelp hid="HID_FUNC_WOCHENTAG">Returns the day of the week for the given date value.</ahelp> The day is returned as an integer between 1 (Sunday) and 7 (Saturday) if no type or type=1 is specified. For other types, see the table below.</paragraph> +<embed href="text/scalc/01/ODFF.xhp#odff"/> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id3149033" role="code" xml-lang="en-US">WEEKDAY(Number [; Type])</paragraph> +<paragraph id="par_id3149046" role="paragraph" xml-lang="en-US"> <emph>Number</emph>, as a date value, is a decimal for which the weekday is to be returned.</paragraph> +<paragraph id="par_id3154394" role="paragraph" xml-lang="en-US"> <emph>Type</emph> is optional and determines the type of calculation. </paragraph> + +<table id="tbl_050220170549191947"> + <tablerow> + <tablecell> + <paragraph id="par_id050220170615596613" role="tablehead" xml-lang="en-US">Type</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id05022017061559141" role="tablehead" xml-lang="en-US">Weekday number returned</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id050220170615599995" role="tablecontent" xml-lang="en-US">1 or omitted</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id050220170615597231" role="tablecontent" xml-lang="en-US">1 (Sunday) through 7 (Saturday). For compatibility with Microsoft Excel.</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id050220170609471518" role="tablecontent" localize="false" xml-lang="en-US">2</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id050220170615596260" role="tablecontent" xml-lang="en-US">1 (Monday) through 7 (Sunday).</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id050220170609564629" role="tablecontent" localize="false" xml-lang="en-US">3</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id050220170615597630" role="tablecontent" xml-lang="en-US">0 (Monday) through 6 (Sunday)</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id050220170609575426" role="tablecontent" localize="false" xml-lang="en-US">11</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id050220170615592023" role="tablecontent" xml-lang="en-US">1 (Monday) through 7 (Sunday).</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id050220170609583004" role="tablecontent" localize="false" xml-lang="en-US">12</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id050220170615591349" role="tablecontent" xml-lang="en-US">1 (Tuesday) through 7 (Monday).</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id05022017060959167" role="tablecontent" localize="false" xml-lang="en-US">13</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id050220170615593664" role="tablecontent" xml-lang="en-US">1 (Wednesday) through 7 (Tuesday).</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id050220170609591975" role="tablecontent" localize="false" xml-lang="en-US">14</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id050220170615599110" role="tablecontent" xml-lang="en-US">1 (Thursday) through 7 (Wednesday).</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id05022017061000285" role="tablecontent" localize="false" xml-lang="en-US">15</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id05022017061600535" role="tablecontent" xml-lang="en-US">1 (Friday) through 7 (Thursday).</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id050220170610017288" role="tablecontent" localize="false" xml-lang="en-US">16</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id050220170616003219" role="tablecontent" xml-lang="en-US">1 (Saturday) through 7 (Friday).</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id050220170610027543" role="tablecontent" localize="false" xml-lang="en-US">17</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id050220170616002095" role="tablecontent" xml-lang="en-US">1 (Sunday) through 7 (Saturday).</paragraph> + </tablecell> + </tablerow> +</table> + +<note id="par_id3156188">These values apply only to the standard date format that you select under <switchinline select="sys"><caseinline select="MAC"><item type="menuitem">%PRODUCTNAME - Preferences</item> +</caseinline><defaultinline><item type="menuitem">Tools - Options</item></defaultinline></switchinline><item type="menuitem">- %PRODUCTNAME Calc - Calculate</item>.</note> +<embed href="text/scalc/01/04060102.xhp#datenumberinfo"/> +<embed href="text/scalc/01/04060102.xhp#datenumberwarn"/> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id3150317" role="paragraph" xml-lang="en-US"><item type="input">=WEEKDAY("2000-06-14")</item> returns 4 (the Type parameter is missing, therefore the standard count is used. The standard count starts with Sunday as day number 1. June 14, 2000 was a Wednesday and therefore day number 4).</paragraph> +<paragraph id="par_id3153174" role="paragraph" xml-lang="en-US"><item type="input">=WEEKDAY("1996-07-24";2)</item> returns 3 (the Type parameter is 2, therefore Monday is day number 1. July 24, 1996 was a Wednesday and therefore day number 3).</paragraph> +<paragraph id="par_id3153525" role="paragraph" xml-lang="en-US"><item type="input">=WEEKDAY("1996-07-24";1)</item> returns 4 (the Type parameter is 1, therefore Sunday is day number 1. July 24, 1996 was a Wednesday and therefore day number 4).</paragraph> +<paragraph id="par_id050220170616006699" role="paragraph" xml-lang="en-US"><item type="input">=WEEKDAY("2017-05-02";14)</item> returns 6 (the Type parameter is 14, therefore Thursday is day number 1. May 2, 2017 was a Tuesday and therefore day number 6)</paragraph> +<paragraph id="par_id3150575" role="paragraph" xml-lang="en-US"><item type="input">=WEEKDAY(NOW())</item> returns the number of the current day.</paragraph> +<tip id="par_id3150588">To obtain a function indicating whether a day in A1 is a business day, use the IF and WEEKDAY functions as follows: <br/><item type="input">IF(WEEKDAY(A1;2)<6;"Business day";"Weekend")</item></tip> +<section id="relatedtopics"> + <embed href="text/scalc/01/04060102.xhp#datetimefunctions"/> +</section> +</body> + +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/func_weeknum.xhp b/helpcontent2/source/text/scalc/01/func_weeknum.xhp new file mode 100644 index 000000000..99a089af3 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/func_weeknum.xhp @@ -0,0 +1,184 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . + --> +<helpdocument version="1.0"> +<meta> +<topic id="textscalc01func_weeknumxml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">WEEKNUM</title> +<filename>/text/scalc/01/func_weeknum.xhp</filename> +</topic> +</meta> +<body> +<bookmark xml-lang="en-US" branch="index" id="bm_id3159161"><bookmark_value>WEEKNUM function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_KALENDERWOCHE" id="bm_id3158403" localize="false"/><h2 id="hd_id3159161"><variable id="weeknum"><link href="text/scalc/01/func_weeknum.xhp">WEEKNUM</link> +</variable></h2> +<paragraph role="paragraph" id="par_id3149770" xml-lang="en-US"><ahelp hid="HID_FUNC_KALENDERWOCHE">WEEKNUM calculates the week number of the year for the internal date value as defined in ODF OpenFormula and compatible with other spreadsheet applications.</ahelp></paragraph> +<paragraph role="paragraph" id="par_id3147220" xml-lang="en-US">Supported are two week numbering systems:</paragraph> +<table id="tab_id481535122363435"> + <tablerow> + <tablecell> + <paragraph id="par_id851535122363435" role="tablehead" xml-lang="en-US">System</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id901535122363436" role="tablehead" xml-lang="en-US" localize="false">Description</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id691535122363437" role="tablecontent" xml-lang="en-US">System 1</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id3147221" role="tablecontent" xml-lang="en-US">The week containing January 1 is the first week of the year, and is numbered week 1.</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id741535122455285" role="tablecontent" xml-lang="en-US">System 2</paragraph> + </tablecell> + <tablecell> + <paragraph role="tablecontent" id="par_id3147222" xml-lang="en-US">The week containing the first Thursday of the year is the first week of the year, and is numbered week 1. That means that week number 1 of any year is the week that contains January 4th. ISO 8601 defines this system and that the week starts on Monday.</paragraph> + </tablecell> + </tablerow> +</table> +<embed href="text/scalc/01/ODFF.xhp#odff"/> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph role="code" id="par_id3147236" xml-lang="en-US">WEEKNUM(Number [; Mode])</paragraph> +<paragraph role="paragraph" id="par_id3147511" xml-lang="en-US"> +<emph>Number</emph> is the internal date number.</paragraph> +<paragraph role="paragraph" id="par_id3154269" xml-lang="en-US"> +<emph>Mode</emph> sets the start of the week and the week numbering system. This parameter is optional, if omitted the default value is 1.</paragraph> +<table id="tab_id491535122633826"> + <tablerow> + <tablecell> + <paragraph id="par_id961535122993923" role="tablehead" xml-lang="en-US">System</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id151535122633826" role="tablehead" xml-lang="en-US">Mode</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id231535122633827" role="tablehead" xml-lang="en-US">Day of the week</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell rowspan="9"> + <paragraph id="par_id531535124180000" role="tablecontents" xml-lang="en-US">System 1</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id931535122633827" role="tablecontent" xml-lang="en-US" localize="false">1</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id351535122633828" role="tablecontent" xml-lang="en-US">Sunday</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id441535122735565" role="tablecontents" xml-lang="en-US" localize="false">2</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id591535122756686" role="tablecontents" xml-lang="en-US">Monday</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id541535122798459" role="tablecontents" xml-lang="en-US" localize="false">11</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id881535122835126" role="tablecontents" xml-lang="en-US">Monday</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id941535122866815" role="tablecontent" xml-lang="en-US" localize="false">12</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id241535122903569" role="tablecontents" xml-lang="en-US">Tuesday</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id271535124253476" role="tablecontents" xml-lang="en-US" localize="false">13</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id31535124277973" role="tablecontents" xml-lang="en-US">Wednesday</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id281535124290548" role="tablecontents" xml-lang="en-US" localize="false">14</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id21535124310462" role="tablecontents" xml-lang="en-US">Thursday</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id721535124338290" role="tablecontents" xml-lang="en-US" localize="false">15</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id921535124365435" role="tablecontents" xml-lang="en-US">Friday</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id781535124380237" role="tablecontents" xml-lang="en-US" localize="false">16</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id211535124416253" role="tablecontents" xml-lang="en-US">Saturday</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id601535124440320" role="tablecontents" xml-lang="en-US" localize="false">17</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id461535124473824" role="tablecontents" xml-lang="en-US">Sunday</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell rowspan="2"> + <paragraph id="par_id471535124489997" role="tablecontents" xml-lang="en-US">System 2</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id431535124539573" role="tablecontents" xml-lang="en-US" localize="false">21</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id391535124564520" role="tablecontents" xml-lang="en-US">Monday (ISO 8601)</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id971535124578111" role="tablecontents" xml-lang="en-US" localize="false">150</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id661535124640643" role="tablecontents" xml-lang="en-US">(ISO 8601, for interoperability with Gnumeric)</paragraph> + </tablecell> +</tablerow> +</table> +<embed href="text/scalc/01/04060102.xhp#datenumberinfo"/> +<embed href="text/scalc/01/04060102.xhp#datenumberwarn"/> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph role="paragraph" id="par_id3150704" xml-lang="en-US"><item type="input">=WEEKNUM(DATE(1995;1;1);1)</item> returns 1</paragraph> +<paragraph role="paragraph" id="par_id3149792" xml-lang="en-US"><item type="input">=WEEKNUM(DATE(1995;1;1);2)</item> returns 1. Using System 1, the week containing January 1 is the first week of the year.</paragraph> +<paragraph role="paragraph" id="par_id3149793" xml-lang="en-US"><item type="input">=WEEKNUM(DATE(1995;1;1);21)</item> returns 52. Week 1 starts on Monday, 1995-01-02.</paragraph> +<paragraph role="paragraph" id="par_id3149794" xml-lang="en-US"><item type="input">=WEEKNUM(DATE(1999;1;1);21)</item> returns 53. Week 1 starts on Monday, 1999-01-04.</paragraph> +<section id="relatedtopics"> + <embed href="text/scalc/01/04060102.xhp#datetimefunctions"/> +</section> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/func_weeknum_ooo.xhp b/helpcontent2/source/text/scalc/01/func_weeknum_ooo.xhp new file mode 100644 index 000000000..28519d22a --- /dev/null +++ b/helpcontent2/source/text/scalc/01/func_weeknum_ooo.xhp @@ -0,0 +1,55 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . + --> +<helpdocument version="1.0"> +<meta> +<topic id="textscalc01func_weeknum_oooxml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">WEEKNUM_OOO</title> +<filename>/text/scalc/01/func_weeknum_ooo.xhp</filename> +</topic> +</meta> +<body> +<bookmark xml-lang="en-US" branch="index" id="bm_id3159161"><bookmark_value>WEEKNUM_OOO function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_WEEKNUM_OOO" id="bm_id3158403" localize="false"/><h2 id="hd_id3159161"><variable id="weeknum_ooo"><link href="text/scalc/01/func_weeknum_ooo.xhp">WEEKNUM_OOO</link> +</variable></h2> +<paragraph role="paragraph" id="par_id3149770" xml-lang="en-US"><ahelp hid="HID_FUNC_WEEKNUM_OOO">WEEKNUM_OOO calculates the week number of the year for the internal date value.</ahelp></paragraph> +<note id="par_idN105E4">This function exists for interoperability with %PRODUCTNAME releases older than 5.1.0 and OpenOffice.org. It calculates week numbers for a week numbering system in that week number 1 is the week that contains the January 4th. This function does not provide interoperability with other spreadsheet applications. For new documents use the <link href="text/scalc/01/func_weeknum.xhp">WEEKNUM</link> or <link href="text/scalc/01/func_isoweeknum.xhp">ISOWEEKNUM</link> function instead.</note> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph role="code" id="par_id3147236" xml-lang="en-US">WEEKNUM_OOO(Number; Mode)</paragraph> +<paragraph role="paragraph" id="par_id3147511" xml-lang="en-US"> +<emph>Number</emph> is the internal date number.</paragraph> +<paragraph role="paragraph" id="par_id3154269" xml-lang="en-US"> +<emph>Mode</emph> sets the start of the week and the calculation type.</paragraph> +<paragraph role="paragraph" id="par_id3148930" xml-lang="en-US">1 = Sunday</paragraph> +<paragraph role="paragraph" id="par_id3154280" xml-lang="en-US">2 = Monday (ISO 8601)</paragraph> +<paragraph role="paragraph" id="par_id3154281" xml-lang="en-US">any other value = Monday (ISO 8601)</paragraph> +<embed href="text/scalc/01/04060102.xhp#datenumberinfo"/> +<embed href="text/scalc/01/04060102.xhp#datenumberwarn"/> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph role="paragraph" id="par_id3150704" xml-lang="en-US"><item type="input">=WEEKNUM_OOO(DATE(1995;1;1);1)</item> returns 1</paragraph> +<paragraph role="paragraph" id="par_id3149792" xml-lang="en-US"><item type="input">=WEEKNUM_OOO(DATE(1995;1;1);2)</item> returns 52. Week 1 starts on Monday, 1995-01-02.</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectiontechinfo"/> +<embed href="text/scalc/00/avail_release.xhp#5.1"/> +<embed href="text/scalc/01/common_func.xhp#notODFF"/> +<paragraph role="paragraph" id="par_id311640873986703" localize="false"><literal>ORG.LIBREOFFICE.WEEKNUM_OOO</literal></paragraph> +<section id="relatedtopics"> + <embed href="text/scalc/01/04060102.xhp#datetimefunctions"/> +</section> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/func_weeknumadd.xhp b/helpcontent2/source/text/scalc/01/func_weeknumadd.xhp new file mode 100644 index 000000000..57f838d9a --- /dev/null +++ b/helpcontent2/source/text/scalc/01/func_weeknumadd.xhp @@ -0,0 +1,47 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . + --> +<helpdocument version="1.0"> +<meta> +<topic id="textscalc01func_weeknumaddxml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">WEEKNUM_EXCEL2003 </title> +<filename>/text/scalc/01/func_weeknumadd.xhp</filename> +</topic> +</meta> +<body> +<bookmark xml-lang="en-US" branch="index" id="bm_id3166443"><bookmark_value>WEEKNUM_EXCEL2003 function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_WEEKNUM" id="bm_id3166454" localize="false"/><h2 id="hd_id3166443"><variable id="weeknumadd"><link href="text/scalc/01/func_weeknumadd.xhp">WEEKNUM_EXCEL2003</link> +</variable></h2> +<paragraph role="paragraph" id="par_id3152945" xml-lang="en-US"><ahelp hid="HID_AAI_FUNC_WEEKNUM">The result indicates the number of the calendar week for a date.</ahelp></paragraph> +<tip id="par_idN105DD">The WEEKNUM_EXCEL2003 function is designed to calculate week numbers exactly as Microsoft Excel 2003 did. Use the <link href="text/scalc/01/func_weeknum.xhp">WEEKNUM</link> function for ODF OpenFormula and Excel 2010 compatibility, or <link href="text/scalc/01/func_isoweeknum.xhp">ISOWEEKNUM</link> function when you just need ISO 8601 week numbers. In releases prior to $[officename] 5.1 WEEKNUM_EXCEL2003 was named WEEKNUM_ADD.</tip> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph role="code" id="par_id3153685" xml-lang="en-US">WEEKNUM_EXCEL2003(Date; ReturnType)</paragraph> +<paragraph role="paragraph" id="par_id3159277" xml-lang="en-US"> +<emph>Date</emph> is the date within the calendar week.</paragraph> +<paragraph role="paragraph" id="par_id3154098" xml-lang="en-US"> +<emph>ReturnType</emph> is 1 for week beginning on a Sunday, 2 for week beginning on a Monday.</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph role="paragraph" id="par_id3149973" xml-lang="en-US">In which week number does 2001-12-24 fall?</paragraph> +<paragraph role="paragraph" id="par_id3149914" xml-lang="en-US"> +<item type="input">=WEEKNUM_EXCEL2003(DATE(2001;12;24);1)</item> returns 52.</paragraph> +<section id="relatedtopics"> + <embed href="text/scalc/01/04060102.xhp#datetimefunctions"/> +</section> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/func_workday.intl.xhp b/helpcontent2/source/text/scalc/01/func_workday.intl.xhp new file mode 100644 index 000000000..f41a62d87 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/func_workday.intl.xhp @@ -0,0 +1,66 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . +--> + +<meta> + <topic id="textscalc01func_workdaysxml"> + <title id="tit" xml-lang="en-US">WORKDAY.INTL</title> + <filename>/text/scalc/01/func_workday.intl.xhp</filename> + </topic> +</meta> +<body> +<section id="workdays"> +<bookmark xml-lang="en-US" branch="index" id="bm_id231020162341219565"> + <bookmark_value>WORKDAY.INTL function</bookmark_value> +</bookmark> + +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_WORKDAY_MS" id="bm_id231020162348499245" localize="false"/> + +<h2 id="hd_id231020162348002143"><variable id="workdaysintl"><link href="text/scalc/01/func_workday.intl.xhp">WORKDAY.INTL</link></variable></h2> +<paragraph id="par_id23102016234837285" role="paragraph" xml-lang="en-US"><ahelp hid=".">Returns the date calculated from a start date with a specific number of work days, before or after the start date. The calculation can include week-ends and holidays as non-working days.</ahelp></paragraph> +</section> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph id="par_id241020160008306838" role="code" xml-lang="en-US">WORKDAY.INTL(StartDate; Days [; Weekend [; Holidays]])</paragraph> +<paragraph id="par_id241020160008308885" role="paragraph" xml-lang="en-US"><emph>StartDate</emph>: is the date from when the calculation is carried out.</paragraph> +<paragraph id="par_id241020160008305329" role="paragraph" xml-lang="en-US"><emph>Days</emph> is the number of workdays. Positive value for a result after the start date, negative value for a result before the start date.</paragraph> +<embed href="text/scalc/01/common_func_workdaysintl.xhp#embed_workdays_intl"/> +<embed href="text/scalc/01/04060102.xhp#datenumberinfo"/> +<embed href="text/scalc/01/04060102.xhp#datenumberwarn"/> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id241020160012177196" role="paragraph" xml-lang="en-US">What date comes 20 workdays after December 13, 2016? Enter the start date in C3 and the number of workdays in D3.</paragraph> +<paragraph id="par_id241020160012178429" role="paragraph" xml-lang="en-US">The weekend parameter (number) may be left blank or defined as 1 for default weekend (non-working days) – Saturday and Sunday.</paragraph> +<paragraph id="par_id241020160012172125" role="paragraph" xml-lang="en-US">Cells F3 to J3 contain five (5) holidays for Christmas and New Year in date format: December 24, 2016; December 25, 2016; December 26, 2016; December 31, 2016; and January 1, 2017.</paragraph> +<paragraph id="par_id241020160012177923" role="paragraph" xml-lang="en-US"><item type="input">=WORKDAY.INTL(C3;D3;;F3:J3)</item> returns January 11, 2017 in the result cell, say D6 (use date format for the cell).</paragraph> +<paragraph id="par_id24102016001217206" role="paragraph" xml-lang="en-US">To define Friday and Saturday as weekend days, use the weekend parameter 7.</paragraph> +<paragraph id="par_id241020160012178562" role="paragraph" xml-lang="en-US"><item type="input">=WORKDAY.INTL(C3;D3;7;F3:J3)</item> returns January 15, 2017 with weekend parameter 7.</paragraph> +<paragraph id="par_id241020160012176149" role="paragraph" xml-lang="en-US">To define Sunday only the weekend day, use the weekend parameter 11.</paragraph> +<paragraph id="par_id241020160012181455" role="paragraph" xml-lang="en-US"><item type="input">=WORKDAY.INTL(C3;D3;11;F3:J3)</item> returns January 9, 2017.</paragraph> +<paragraph id="par_id24102016001218469" role="paragraph" xml-lang="en-US">Alternatively, use the weekend string "0000001" for Sunday only weekend.</paragraph> +<paragraph id="par_id241020160012183680" role="paragraph" xml-lang="en-US"><item type="input">=WORKDAY.INTL(C3;D3;"0000001";F3:J3)</item> returns January 9, 2017.</paragraph> +<paragraph id="par_id241020160012181870" role="paragraph" xml-lang="en-US">The function can be used without the two optional parameters – Weekday and Holidays – by leaving them out:</paragraph> +<paragraph id="par_id241020160012182048" role="paragraph" xml-lang="en-US"><item type="input">=WORKDAY.INTL(C3;D3)</item> gives the result: January 10, 2017.</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectiontechinfo"/> +<embed href="text/scalc/00/avail_release.xhp#4.3"/> +<embed href="text/scalc/01/common_func.xhp#notODFF"/> +<paragraph role="paragraph" id="par_id341640873986703" localize="false"><literal>COM.MICROSOFT.WORKDAY.INTL</literal></paragraph> +<section id="relatedtopics"> + <embed href="text/scalc/01/04060102.xhp#datetimefunctions"/> +</section> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/func_workday.xhp b/helpcontent2/source/text/scalc/01/func_workday.xhp new file mode 100644 index 000000000..95b1f9510 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/func_workday.xhp @@ -0,0 +1,57 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . + --> +<helpdocument version="1.0"> +<meta> +<topic id="textscalc01func_workdayxml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">WORKDAY</title> +<filename>/text/scalc/01/func_workday.xhp</filename> +</topic> +</meta> +<body> +<bookmark xml-lang="en-US" branch="index" id="bm_id3149012"><bookmark_value>WORKDAY function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_WORKDAY" id="bm_id3150028" localize="false"/> +<h2 id="hd_id3149012"><variable id="workday"><link href="text/scalc/01/func_workday.xhp">WORKDAY</link></variable></h2> +<paragraph role="paragraph" id="par_id3149893" xml-lang="en-US"><ahelp hid="HID_AAI_FUNC_WORKDAY"> The result is a date number that can be formatted as a date. You then see the date of a day that is a certain number of <emph>workdays</emph> away from the <emph>start date</emph>.</ahelp></paragraph> +<embed href="text/scalc/01/ODFF.xhp#odff"/> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph role="code" id="par_id3154844" xml-lang="en-US">WORKDAY(StartDate; Days [; Holidays])</paragraph> +<paragraph role="paragraph" id="par_id3147469" xml-lang="en-US"> +<emph>StartDate</emph> is the date from when the calculation is carried out. If the start date is a workday, the day is included in the calculation.</paragraph> +<paragraph role="paragraph" id="par_id3153038" xml-lang="en-US"> +<emph>Days</emph> is the number of workdays. Positive value for a result after the start date, negative value for a result before the start date.</paragraph> +<paragraph role="paragraph" id="par_id3150693" xml-lang="en-US"> +<emph>Holidays</emph> is a list of optional holidays. These are non-working days. Enter a cell range in which the holidays are listed individually.</paragraph> +<embed href="text/scalc/01/04060102.xhp#datenumberinfo"/> +<embed href="text/scalc/01/04060102.xhp#datenumberwarn"/> +<embed href="text/scalc/01/common_func.xhp#datenumbersequencenote"/> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph role="paragraph" id="par_id3152782" xml-lang="en-US">What date came 17 workdays after 1 December 2001? Enter the start date "2001-12-01" in C3 and the number of workdays in D3. Cells F3 to J3 contain the following Christmas and New Year holidays: "2001-12-24", "2001-12-25", "2001-12-26", "2001-12-31", "2002-01-01".</paragraph> +<paragraph role="paragraph" id="par_id3146142" xml-lang="en-US"><item type="input">=WORKDAY(C3;D3;F3:J3)</item> returns 2001-12-28. Format the serial date number as a date, for example in the format YYYY-MM-DD.<comment>UFI: fixed #i30213#</comment></paragraph> +<section id="relatedtopics"> + <embed href="text/scalc/01/func_networkdays.xhp#networkdays"/> + <embed href="text/scalc/01/func_networkdays.intl.xhp#networkdaysintl"/> + <embed href="text/scalc/01/func_workday.intl.xhp#workdaysintl"/> +<paragraph id="par_id23102016225717242" role="paragraph" xml-lang="en-US"><link href="text/scalc/01/04060102.xhp">Date functions</link></paragraph> +</section> +<section id="relatedtopics"> + <embed href="text/scalc/01/04060102.xhp#datetimefunctions"/> +</section> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/func_year.xhp b/helpcontent2/source/text/scalc/01/func_year.xhp new file mode 100644 index 000000000..c2fe1b635 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/func_year.xhp @@ -0,0 +1,50 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . + --> +<helpdocument version="1.0"> +<meta> +<topic id="textscalc01func_yearxml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">YEAR</title> +<filename>/text/scalc/01/func_year.xhp</filename> +</topic> +</meta> +<body> +<bookmark xml-lang="en-US" branch="index" id="bm_id3153982"><bookmark_value>YEAR function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_JAHR" id="bm_id3159179" localize="false"/><h2 id="hd_id3153982"><variable id="year"><link href="text/scalc/01/func_year.xhp">YEAR</link> +</variable></h2> +<paragraph role="paragraph" id="par_id3147496" xml-lang="en-US"><ahelp hid="HID_FUNC_JAHR">Returns the year as a number according to the <link href="text/scalc/01/04060102.xhp#datebase" name="date calculation rules">internal calculation rules</link>.</ahelp></paragraph> +<embed href="text/scalc/01/ODFF.xhp#odff"/> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph role="code" id="par_id3154304" xml-lang="en-US">YEAR(Number)</paragraph> +<paragraph role="paragraph" id="par_id3156013" xml-lang="en-US"> +<emph>Number</emph> shows the internal date value for which the year is to be returned.</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph role="paragraph" id="par_id3145668" xml-lang="en-US"> +<item type="input">=YEAR(1)</item> returns 1899</paragraph> +<paragraph role="paragraph" id="par_id3151168" xml-lang="en-US"> +<item type="input">=YEAR(2)</item> returns 1900</paragraph> +<paragraph role="paragraph" id="par_id3150115" xml-lang="en-US"> +<item type="input">=YEAR(33333.33)</item> returns 1991</paragraph> +<paragraph role="paragraph" id="par_id141577548861101"><input>=YEAR(DATEVALUE('2010-09-28'))</input> returns 2010.</paragraph> + +<section id="relatedtopics"> + <embed href="text/scalc/01/04060102.xhp#datetimefunctions"/> +</section> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/func_yearfrac.xhp b/helpcontent2/source/text/scalc/01/func_yearfrac.xhp new file mode 100644 index 000000000..52cb40c5c --- /dev/null +++ b/helpcontent2/source/text/scalc/01/func_yearfrac.xhp @@ -0,0 +1,100 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . + --> +<helpdocument version="1.0"> +<meta> +<topic id="textscalc01func_yearfracxml" indexer="include" status="PUBLISH"> +<title id="tit" xml-lang="en-US">YEARFRAC</title> +<filename>/text/scalc/01/func_yearfrac.xhp</filename> +</topic> +</meta> +<body> +<bookmark xml-lang="en-US" branch="index" id="bm_id3148735"><bookmark_value>YEARFRAC function</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/SC_HID_AAI_FUNC_YEARFRAC" id="bm_id3149251" localize="false"/> +<h2 id="hd_id3148735"><variable id="yearfrac"><link href="text/scalc/01/func_yearfrac.xhp">YEARFRAC</link></variable></h2> +<paragraph role="paragraph" id="par_id3150899" xml-lang="en-US"><ahelp hid="HID_AAI_FUNC_YEARFRAC">The result is the number of the years (including fractional part) between <emph>StartDate</emph> and <emph>EndDate</emph>.</ahelp></paragraph> +<embed href="text/scalc/01/ODFF.xhp#odff"/> +<embed href="text/scalc/01/common_func.xhp#sectionsyntax"/> +<paragraph role="code" id="par_id3155823" xml-lang="en-US">YEARFRAC(StartDate; EndDate [; Basis])</paragraph> +<paragraph role="paragraph" id="par_id3145144" xml-lang="en-US"> +<emph>StartDate</emph> and <emph>EndDate</emph> are two date values.</paragraph> +<section id="basis"> +<paragraph role="paragraph" id="par_id3149954" xml-lang="en-US"> +<emph>Basis</emph> (optional) is chosen from a list of options and indicates how the year is to be calculated.</paragraph> +<table id="tbl_id3145590"> +<tablerow> +<tablecell> +<paragraph role="tablehead" id="par_id3146847" xml-lang="en-US">Basis</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablehead" id="par_id3155956" xml-lang="en-US">Calculation</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph role="tablecontent" id="par_id3154502" xml-lang="en-US">0 or missing</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablecontent" id="par_id3149877" xml-lang="en-US">US method (NASD), 12 months of 30 days each</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> + <paragraph role="tablecontent" id="par_id3148766" xml-lang="en-US" localize="false">1</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablecontent" id="par_id3154326" xml-lang="en-US">Exact number of days in months, exact number of days in year</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> + <paragraph role="tablecontent" id="par_id3145245" xml-lang="en-US" localize="false">2</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablecontent" id="par_id3155620" xml-lang="en-US">Exact number of days in month, year has 360 days</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> + <paragraph role="tablecontent" id="par_id3145297" xml-lang="en-US" localize="false">3</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablecontent" id="par_id3148394" xml-lang="en-US">Exact number of days in month, year has 365 days</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> + <paragraph role="tablecontent" id="par_id3151022" xml-lang="en-US" localize="false">4</paragraph> +</tablecell> +<tablecell> +<paragraph role="tablecontent" id="par_id3150931" xml-lang="en-US">European method, 12 months of 30 days each</paragraph> +</tablecell> +</tablerow> +</table> +</section> +<embed href="text/scalc/01/04060102.xhp#datenumberinfo"/> +<embed href="text/scalc/01/04060102.xhp#datenumberwarn"/> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph role="paragraph" id="par_id3149007" xml-lang="en-US">What fraction of the year 2008 lies between 2008-01-01 and 2008-07-01?</paragraph> +<paragraph role="paragraph" id="par_id3154632" xml-lang="en-US"><item type="input">=YEARFRAC("2008-01-01"; "2008-07-01";0)</item> returns 0.50.</paragraph> +<section id="relatedtopics"> + <embed href="text/scalc/01/04060102.xhp#datetimefunctions"/> +</section> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/live_data_stream.xhp b/helpcontent2/source/text/scalc/01/live_data_stream.xhp new file mode 100644 index 000000000..774ec4e0f --- /dev/null +++ b/helpcontent2/source/text/scalc/01/live_data_stream.xhp @@ -0,0 +1,76 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . +--> +<meta> + <topic id="textscalc01live_data_streamxml"> + <title id="tit" xml-lang="en-US">Live Data Stream</title> + <filename>/text/scalc/01/live_data_stream.xhp</filename> + </topic> +</meta> +<body> + <bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/datastreams/DataStreamDialog" id="bm_id240920171033409926" localize="false"/> + <bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/datastreams/@@nowidget@@" id="bm_id240920171033409926" localize="false"/> + <bookmark xml-lang="en-US" branch="index" id="bm_id240920171018528200"> + <bookmark_value>Data Stream;Live data stream</bookmark_value> + <bookmark_value>Data Stream;Streams</bookmark_value> + </bookmark> + <section id="live_data_stream"> + <h1 id="hd_id240920171003006302"><link href="text/scalc/01/live_data_stream.xhp">Live Data Stream</link></h1> + <paragraph id="par_id240920171003293400" role="paragraph"><ahelp hid="."><variable id="streams_desc">Create live data streams for spreadsheets.</variable></ahelp></paragraph> + </section> + <section id="howtoget"> + <paragraph id="par_id240920171007389295" role="paragraph">Choose <menuitem>Data – Streams</menuitem></paragraph> + </section> + <embed href="text/shared/optionen/experimental.xhp#experimental"/> + <embed href="text/shared/need_help.xhp#needhelp"/> + <paragraph role="paragraph" id="par_id221641995264796">Data streaming is the continuous flow of data generated by various sources. In %PRODUCTNAME Calc, data streams can be processed, stored, analyzed, and acted upon as it's generated in real-time.</paragraph> + <paragraph role="paragraph" id="par_id831641996045238">Some real-life examples of streaming data include use cases in every industry, including real-time stock trades, up-to-the-minute retail inventory management, social media feeds, multiplayer game interactions, and ride-sharing apps.</paragraph> + + <h2 id="hd_id791641995257145">Source stream</h2> + <h3 id="hd_id931641998122172">URL</h3> + <paragraph role="paragraph" id="par_id31641995269740">URL of the source document in the local file system or internet.</paragraph> + + <h3 id="hd_id811641996480534">Interpret stream data as</h3> + <list type="unordered"> + <listitem> + <paragraph id="par_id591641996318461" role="listitem"><emph>value1,value2,...,valueN, and fill into range</emph>:</paragraph> + </listitem> + <listitem> + <paragraph id="par_id441641996322078" role="listitem"><emph>address,value</emph>:</paragraph> + </listitem> + </list> + <h3 id="hd_id241641998151807">Empty lines trigger UI refresh</h3> + + <h2 id="hd_id341641995330350">When new data arrives</h2> + <paragraph role="paragraph" id="par_id731641995339462">There are three features of this option:</paragraph> + <list type="unordered"> + <listitem> + <paragraph id="par_id471641995370002" role="listitem"><emph>Move existing data down</emph>: the existing data is moved down in index and the empty space is filled by arriving data. In short, we deal in fix range of indexes. </paragraph> + </listitem> + <listitem> + <paragraph id="par_id841641995386510" role="listitem"><emph>Move the range down</emph>: the arriving data is appended at the end of existing data and range of indexes to be processed is shifted.</paragraph> + </listitem> + <listitem> + <paragraph id="par_id1001641996559358" role="listitem"><emph>Overwrite existing data</emph>: the arriving data overrides the existing data.</paragraph> + </listitem> + </list> + <h2 id="hd_id121641995404922">Maximal Amount of Rows</h2> + <paragraph role="paragraph" id="par_id961641995414472">Limit the maximum numbers of rows to a specified value or leave undefined, but limited to the %PRODUCTNAME Calc row limit.</paragraph> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/recalculate_hard.xhp b/helpcontent2/source/text/scalc/01/recalculate_hard.xhp new file mode 100644 index 000000000..296a3fd1e --- /dev/null +++ b/helpcontent2/source/text/scalc/01/recalculate_hard.xhp @@ -0,0 +1,37 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * +--> + +<meta> + <topic id="recalculate hard" indexer="include" status="PUBLISH"> + <title id="tit" xml-lang="en-US">Recalculate hard</title> + <filename>/text/scalc/01/recalculate_hard.xhp</filename> + </topic> +</meta> +<body> +<bookmark id="bm_id581645217532281" xml-lang="en-US" branch="hid/.uno:CalculateHard" localize="false"/> +<bookmark xml-lang="en-US" branch="index" id="bm_id351645231629404"> + <bookmark_value>calculate;recalculate hard</bookmark_value> + <bookmark_value>formulas;recalculate hard</bookmark_value> + <bookmark_value>calculate;force recalculation</bookmark_value> + <bookmark_value>formulas;force recalculation</bookmark_value> + <bookmark_value>non volatile functions;force recalculation</bookmark_value> + <bookmark_value>cell contents;force recalculation</bookmark_value> +</bookmark> +<section id="recalculate_hard_head"> + <h1 id="hd_id611645217532285"><variable id="recalculatehardh1"><link href="text/scalc/01/recalculate_hard.xhp" name="recalculate hard">Recalculate Hard</link></variable></h1> + <paragraph id="par_id631645217532291" role="paragraph" xml-lang="en-US">Recalculates all formulas in the document, including Add-In functions and non-volatile functions.</paragraph> +</section> +<section id="howtoget"> + <embed href="text/scalc/00/00000406.xhp#recalculate_hard"/> +</section> +<paragraph role="paragraph" id="par_id361645227084327">The <menuitem>Recalculate Hard</menuitem> command forces recalculation of all formula cells of the spreadsheet document, including explicit non-volatile functions, even if no new input event exist. Examples of explicit non-volatile functions are <link href="text/scalc/01/04060106.xhp#rand_nv" name="RAND.NV">RAND.NV</link> and <link href="text/scalc/01/04060106.xhp#randbetween_nv" name="RANDBETWEEN.NV">RANDBETWEEN.NV</link>.</paragraph> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/shared_spreadsheet.xhp b/helpcontent2/source/text/scalc/01/shared_spreadsheet.xhp new file mode 100644 index 000000000..c93c059d1 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/shared_spreadsheet.xhp @@ -0,0 +1,47 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> + <!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + --> + + <meta> + <topic id="sharespreadsheet" indexer="include" status="PUBLISH"> + <title id="tit" xml-lang="en-US">Sharing Spreadsheets</title> + <filename>/text/scalc/01/shared_spreadsheet.xhp</filename> + </topic> + </meta> + <body> + <bookmark xml-lang="en-US" branch="index" id="bm_id671647274159909"> + <bookmark_value>share spreadsheet</bookmark_value> + <bookmark_value>spreadsheet;collaboration</bookmark_value> + <bookmark_value>spreadsheet;share</bookmark_value> + </bookmark> + <section id="shared_spreadsheet_head"> + <bookmark id="bm_id551647272004703" xml-lang="en-US" branch="hid/.uno:ShareDocument" localize="false"/> + <h1 id="hd_id461647272004705"><variable id="h1"><link href="text/scalc/01/shared_spreadsheet.xhp" name="Share spreadsheet">Share Spreadsheet</link></variable></h1> + <paragraph id="par_id551647272004709" role="paragraph" xml-lang="en-US">Sharing a spreadsheet allows several users to open the same file for editing at the same time.</paragraph> + </section> + <section id="howtoget"> + <embed href="text/scalc/00/00000406.xhp#share_spreadsheet"/> + </section> + <paragraph role="paragraph" id="par_id211647275285230">The spreadsheet needs to be on a shared drive, server, website, or similar. Some conditions must be met on operating systems with user permission management:</paragraph> + <list type="unordered"> + <listitem> + <paragraph id="par_id621647275321672" role="listitem">The shared file needs to reside in a location which is accessible by all collaborators.</paragraph> + </listitem> + <listitem> + <paragraph id="par_id731647275360618" role="listitem">The file permissions for both the document and the corresponding lock file need to be set so that all collaborators can create, delete, and change the files.</paragraph> + </listitem> + </list> + <tip id="par_id631647275500217">In order to correctly identify the changes, each collaborator should enter their name in <switchinline select="sys"><caseinline select="MAC"><menuitem>%PRODUCTNAME - Preferences</menuitem></caseinline><defaultinline><menuitem>Tools - Options</menuitem></defaultinline></switchinline><menuitem> - %PRODUCTNAME - User Data</menuitem> on the Menu bar.</tip> + + <section id="relatedtopics"> + <paragraph localize="false" role="paragraph" id="par_id991647272437516"><embedvar href="text/shared/guide/collab.xhp#collab"/></paragraph> + </section> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/solver.xhp b/helpcontent2/source/text/scalc/01/solver.xhp new file mode 100644 index 000000000..1aa2fa6a3 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/solver.xhp @@ -0,0 +1,153 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . +--> + +<meta> + <topic id="textscalc01solverxml" indexer="include" status="PUBLISH"> + <title id="tit" xml-lang="en-US">Solver</title> + <filename>/text/scalc/01/solver.xhp</filename> + </topic> +</meta> + +<body> + +<section id="solverhead"> +<bookmark xml-lang="en-US" branch="index" id="bm_id7654652"> + <bookmark_value>goal seeking;solver</bookmark_value> + <bookmark_value>what if operations;solver</bookmark_value> + <bookmark_value>back-solving</bookmark_value> + <bookmark_value>solver</bookmark_value> + <bookmark_value>mathematical programming;solver for Calc</bookmark_value> + <bookmark_value>mathematical optimization;solver for Calc</bookmark_value> + <bookmark_value>operations research;solver for Calc</bookmark_value> +</bookmark> + +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/solverdlg/SolverDialog" id="bm_id5634023" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/solverdlg/@@nowidget@@" id="bm_id5634023" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/.uno:SolverDialog" id="bm_id5634022" localize="false"/> + +<h1 id="hd_id9216284"><variable id="solver"><link href="text/scalc/01/solver.xhp">Solver</link></variable></h1> +<paragraph id="par_id9210486" role="paragraph" xml-lang="en-US"><ahelp hid=".">Opens the Solver dialog. A solver allows you to solve mathematical problems with multiple unknown variables and a set of constraints on the variables by goal-seeking methods.</ahelp></paragraph> +</section> + +<section id="howtoget"> +<embed href="text/scalc/00/00000406.xhp#solver"/> +</section> +<comment>target cell</comment> +<h2 id="hd_id21589912365601">Solver settings</h2> + +<warning id="par_id501589912905479">Solver settings are not saved to the file by %PRODUCTNAME Calc. Closing and reopening the file will reset the solver dialog to default settings.</warning> + +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/solverdlg/targetedit" id="bm_id8861964" localize="false"/> +<h3 id="hd_id121589913023217">Target Cell</h3> +<paragraph id="par_id8538773" role="paragraph" xml-lang="en-US"><ahelp hid=".">Enter or click the cell reference of the target cell. This field takes the address of the cell whose value is to be optimized.</ahelp></paragraph> + +<h3 id="hd_id441589913036601">Optimize results to</h3> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/solverdlg/max" id="bm_id8373973" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/solverdlg/min" id="bm_id6767174" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/solverdlg/valueedit" id="bm_id2756126" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/solverdlg/value" id="bm_id5222022" localize="false"/> +<list type="unordered"> + <listitem> + <paragraph id="par_id7564012" role="listitem" xml-lang="en-US"><ahelp hid="."><emph>Maximum:</emph> Try to solve the equation for a maximum value of the target cell.</ahelp></paragraph> + </listitem> + <listitem> + <paragraph id="par_id1186254" role="listitem" xml-lang="en-US"><ahelp hid="."><emph>Minimum:</emph> Try to solve the equation for a minimum value of the target cell.</ahelp></paragraph> + </listitem> + <listitem> + <paragraph id="par_id7432477" role="listitem" xml-lang="en-US"><ahelp hid="."><emph>Value of:</emph> Try to solve the equation to approach a given value of the target cell.</ahelp></paragraph> + <paragraph id="par_id7141026" role="listitem" xml-lang="en-US"><ahelp hid=".">Enter the value or a cell reference in the text field.</ahelp></paragraph> + </listitem> +</list> + +<h3 id="hd_id761589914010085">By Changing Cells</h3> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/solverdlg/changeedit" id="bm_id4908902" localize="false"/> +<paragraph id="par_id8531449" role="paragraph" xml-lang="en-US"><ahelp hid=".">Enter the cell range that can be changed.</ahelp> These are the variables of the equations.</paragraph> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/solverdlg/ref1edit" id="bm_id8499099" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/solverdlg/ref2edit" id="bm_id9544663" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/solverdlg/ref3edit" id="bm_id5762199" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/solverdlg/ref4edit" id="bm_id9534287" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/solverdlg/op1list" id="bm_id9408551" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/solverdlg/op2list" id="bm_id1329386" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/solverdlg/op3list" id="bm_id4931180" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/solverdlg/op4list" id="bm_id5970030" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/solverdlg/var1edit" id="bm_id496841" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/solverdlg/var2edit" id="bm_id7440717" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/solverdlg/var3edit" id="bm_id2470778" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/solverdlg/var4edit" id="bm_id3389080" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/solverdlg/targetbutton" id="bm_id5104220" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/solverdlg/valuebutton" id="bm_id6714" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/solverdlg/changebutton" id="bm_id8507339" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/solverdlg/ref1button" id="bm_id5296792" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/solverdlg/ref2button" id="bm_id3949400" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/solverdlg/ref3button" id="bm_id9991760" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/solverdlg/ref4button" id="bm_id2726828" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/solverdlg/var1button" id="bm_id6034424" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/solverdlg/var2button" id="bm_id6998809" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/solverdlg/var3button" id="bm_id71413" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/solverdlg/var4button" id="bm_id2924283" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/solverdlg/del1" id="bm_id5781731" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/solverdlg/del2" id="bm_id6942045" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/solverdlg/del3" id="bm_id4721823" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/solverdlg/del4" id="bm_id5806756" localize="false"/> + +<h3 id="hd_id671589914927836">Limiting Conditions</h3> +<paragraph role="paragraph" id="par_id421589915278885">Add the set of constraints for the mathematical problem. Each constraint is represented by a cell reference (a variable), an operator, and a value.</paragraph> +<list type="unordered"> + <listitem> + <paragraph id="par_id9183935" role="listitem" xml-lang="en-US"><ahelp hid="."><emph>Cell reference:</emph> Enter a cell reference of the variable.</ahelp></paragraph> + <paragraph id="par_id1939451" role="listitem" xml-lang="en-US"><ahelp hid=".">Click the Shrink button to shrink or restore the dialog. You can click or select cells in the sheet. You can enter a cell reference manually in the input box.</ahelp></paragraph> + </listitem> + <listitem> + <paragraph id="par_id946684" role="listitem" xml-lang="en-US"><ahelp hid="."><emph>Operator:</emph> Select an operator from the list.</ahelp> Use Binary operator to restrict your variable to 0 or 1. Use the Integer operator to restrict your variable to take only integer values (no decimal part).</paragraph> + </listitem> + <listitem> + <paragraph id="par_id9607226" role="listitem" xml-lang="en-US"><ahelp hid="." ><emph>Value:</emph> Enter a value or a cell reference.</ahelp> This field is ignored when the operator is Binary or Integer.</paragraph> + </listitem> + <listitem> + <paragraph id="par_id9038972" role="paragraph" xml-lang="en-US"><ahelp hid="."><emph>Remove button:</emph> Click to remove the row from the list. Any rows from below this row move up.</ahelp></paragraph> + </listitem> +</list> +<note id="par_id511589916338595">You can set multiple conditions for a variable. For example, a variable in cell A1 that must be an integer less than 10. In that case, set two limiting conditions for A1.</note> + +<h3 id="hd_id441589917031236">Options</h3> + +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/solverdlg/options" id="bm_id8915372" localize="false"/> +<paragraph id="par_id2423780" role="paragraph" xml-lang="en-US"><ahelp hid=".">Opens the <link href="text/scalc/01/solver_options.xhp#solveroptionsh1" name="solveroptions">Solver Options</link> dialog.</ahelp></paragraph> +<paragraph role="paragraph" id="par_id221589917833431">The <emph>Solver Options</emph> dialog let you select the different solver algorithms for either linear and non-linear problems and set their solving parameters.</paragraph> +<h3 id="hd_id771589917064147">Solve</h3> +<comment>solve button</comment> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/solverdlg/solve" id="bm_id6070436" localize="false"/> +<paragraph id="par_id2569658" role="paragraph" xml-lang="en-US"><ahelp hid=".">Click to solve the problem with the current settings. The dialog settings are retained until you close the current document.</ahelp></paragraph> + +<h2 id="par_id5474410">To solve equations with the solver</h2> +<paragraph id="par_id2216559" role="paragraph" xml-lang="en-US">The goal of the solver process is to find those variable values of an equation that result in an optimized value in the <emph>target cell</emph>, also named the "objective". You can choose whether the value in the target cell should be a maximum, a minimum, or approaching a given value.</paragraph> +<paragraph id="par_id7869502" role="paragraph" xml-lang="en-US">The initial variable values are inserted in a rectangular cell range that you enter in the <emph>By changing cells</emph> box.</paragraph> +<paragraph id="par_id9852900" role="paragraph" xml-lang="en-US">You can define a series of limiting conditions that set constraints for some cells. For example, you can set the constraint that one of the variables or cells must not be bigger than another variable, or not bigger than a given value. You can also define the constraint that one or more variables must be integers (values without decimals), or binary values (where only 0 and 1 are allowed).</paragraph> +<h2 id="hd_id0603200910430882">Using Non-Linear solvers</h2> +<paragraph xml-lang="en-US" id="par_id0603200910430845" role="paragraph">Regardless whether you use DEPS or SCO, you start by going to <menuitem>Tools - Solver</menuitem> and set the Cell to be optimized, the direction to go (minimization, maximization) and the cells to be modified to reach the goal. Then you go to the Options and specify the solver to be used and if necessary adjust the according <link href="text/scalc/01/solver_options.xhp">parameters</link>.</paragraph> +<paragraph xml-lang="en-US" id="par_id0603200910430821" role="paragraph">There is also a list of constraints you can use to restrict the possible range of solutions or to penalize certain conditions. However, in case of the evolutionary solvers DEPS and SCO, these constraints are also used to specify bounds on the variables of the problem. Due to the random nature of the algorithms, it is <emph>highly recommended</emph> to do so and give upper (and in case "Assume Non-Negative Variables" is turned off also lower) bounds for all variables. They don't have to be near the actual solution (which is probably unknown) but should give a rough indication of the expected size (0 ≤ var ≤ 1 or maybe -1000000 ≤ var ≤ 1000000).</paragraph> +<paragraph xml-lang="en-US" id="par_id0603200910430873" role="paragraph">Bounds are specified by selecting one or more variables (as range) on the left side and entering a numerical value (not a cell or a formula) on the right side. That way you can also choose one or more variables to be <emph>Integer</emph> or <emph>Binary</emph> only.</paragraph> +<section id="relatedtopics"> + <embed href="text/scalc/01/solver_options.xhp#solveroptionsh1"/> + <embed href="text/scalc/01/solver_options_algo.xhp#SolverAlgorithmsOptionsh1"/> + <paragraph role="paragraph" id="par_id271589981559367"><link href="https://wiki.documentfoundation.org/" name="wikipage">Wiki page on solvers and theirs algorithms</link></paragraph> +</section> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/solver_options.xhp b/helpcontent2/source/text/scalc/01/solver_options.xhp new file mode 100644 index 000000000..e4e2291d4 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/solver_options.xhp @@ -0,0 +1,80 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . +--> + +<meta> + <topic id="textscalc01solver_optionsxml" indexer="include" status="PUBLISH"> + <title id="tit" xml-lang="en-US">Solver Options</title> + <filename>/text/scalc/01/solver_options.xhp</filename> + </topic> +</meta> + +<body> + +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/solveroptionsdialog/SolverOptionsDialog" id="bm_id7214271" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/solveroptionsdialog/@@nowidget@@" id="bm_id7214271" localize="false"/> +<bookmark xml-lang="en-US" branch="index" id="bm_id291590166034871"> + <bookmark_value>solver for Calc;options</bookmark_value> +</bookmark> +<h1 id="hd_id2794274"><variable id="solveroptionsh1"><link href="text/scalc/01/solver_options.xhp" name="Solver Options">Solver Options</link></variable></h1> + +<paragraph id="par_id3163853" role="paragraph" xml-lang="en-US">Use the Options dialog to configure the solver engine.</paragraph> + +<section id="howtoget"> +<embed href="text/scalc/00/00000406.xhp#solver_options"/> +</section> + +<paragraph id="par_id9999694" role="paragraph" xml-lang="en-US">Click OK to accept the changes and to go back to the <link href="text/scalc/01/solver.xhp">Solver</link> dialog.</paragraph> +<h2 id="hd_id581589922716672">Solver engine</h2> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/solveroptionsdialog/engine" id="bm_id7214270" localize="false"/> +<paragraph id="par_id393993" role="paragraph" xml-lang="en-US"><ahelp hid=".">Select a solver engine. The listbox is disabled if only one solver engine is installed.</ahelp></paragraph> +<note id="par_id221589959855748">You can install more solver engines as extensions, if available. Open <menuitem>Tools - Extension Manager</menuitem> and browse to the Extensions web site to search for extensions.</note> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/solveroptionsdialog/settings" id="bm_id1331217" localize="false"/> +<h2 id="hd_id711589922750833">Settings</h2> +<paragraph id="par_id130619" role="paragraph" xml-lang="en-US">Configure the current solver. In the Settings box, check all settings that you want to use for the current goal seeking operation. If the current option offers different values, the Edit button is enabled. Click <emph>Edit</emph> to open a dialog where you can change the value.</paragraph> +<list type="unordered"> + <listitem> + <paragraph id="par_id651589925044267" role="listitem" localize="false"><embedvar href="text/scalc/01/solver_options_algo.xhp#DEPSEvolutionaryalgorithmh2"/></paragraph> + </listitem> + <listitem> + <paragraph id="par_id391589925078747" role="listitem" localize="false"><embedvar href="text/scalc/01/solver_options_algo.xhp#SCOEvolutionaryAlgorithmh2"/></paragraph> + </listitem> + <listitem> + <paragraph id="par_id671589925148891" role="listitem" localize="false"><embedvar href="text/scalc/01/solver_options_algo.xhp#LinearSolverh2"/></paragraph> + </listitem> + <listitem> + <paragraph id="par_id711589925192067" role="listitem" localize="false"><embedvar href="text/scalc/01/solver_options_algo.xhp#SwarmNonLinearSolverh2"/></paragraph> + </listitem> +</list> +<h2 id="hd_id481589922813764">Edit</h2> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/solveroptionsdialog/edit" id="bm_id2186346" localize="false"/> +<paragraph id="par_id6531266" role="paragraph" xml-lang="en-US"><ahelp hid=".">If the current entry in the Settings listbox allows you to edit a value, you can click the Edit button. A dialog opens where you can change the value.</ahelp></paragraph> +<h2 id="hd_id331589923158248">Edit settings spin box</h2> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/doubledialog/DoubleDialog" id="bm_id2761315" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/doubledialog/@@nowidget@@" id="bm_id2761315" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/integerdialog/IntegerDialog" id="bm_id2761314" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/integerdialog/@@nowidget@@" id="bm_id2761314" localize="false"/> +<paragraph id="par_id3912778" role="paragraph" xml-lang="en-US"><ahelp hid=".">Enter or change the value of the selected setting.</ahelp></paragraph> +<section id="relatedtopics"> + <embed href="text/scalc/01/solver.xhp#solver"/> + <embed href="text/scalc/01/solver_options_algo.xhp#SolverAlgorithmsOptionsh1"/> + <paragraph role="paragraph" id="par_id271589981559367"><link href="https://wiki.documentfoundation.org/NLPSolver" name="wikipage">Wiki page on non-linear solvers and theirs algorithms</link></paragraph> +</section> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/solver_options_algo.xhp b/helpcontent2/source/text/scalc/01/solver_options_algo.xhp new file mode 100644 index 000000000..486212284 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/solver_options_algo.xhp @@ -0,0 +1,386 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> + + <!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . + --> + + <meta> + <topic id="nlpsolveroptions" indexer="include"> + <title xml-lang="en-US" id="tit">Options</title> + <filename>/text/scalc/01/solver_options_algo.xhp</filename> + </topic> + </meta> + <body> + <bookmark xml-lang="en-US" branch="index" id="bm_id0503200917110375_scalc"> + <bookmark_value>Solver for Nonlinear Problems;Options</bookmark_value> + <bookmark_value>solver for Calc; DEPS evolutionary algorithm</bookmark_value> + <bookmark_value>solver for Calc; SCO evolutionary algorithm</bookmark_value> + <bookmark_value>solver for Calc; linear solver</bookmark_value> + <bookmark_value>solver for Calc; CoinMP linear solver</bookmark_value> + <bookmark_value>solver for Calc; swarm non-linear solver</bookmark_value> + </bookmark> + + <h1 id="hd_id0503200917103593"><variable id="SolverAlgorithmsOptionsh1"><link href="text/scalc/01/solver_options_algo.xhp#SolverAlgorithmsOptionsh1" name="Solver Algorithms Options">Solver Algorithms Options</link></variable></h1> + + <h2 id="par_id651589925044267"><variable id="DEPSEvolutionaryalgorithmh2"><link href="text/scalc/01/solver_options_algo.xhp#DEPSEvolutionaryalgorithmh2" name="DEPS Evolutionary algorithm">DEPS Evolutionary Algorithm</link></variable></h2> + <paragraph role="paragraph" id="par_id931590164412542">DEPS consists of two independent algorithms: Differential Evolution and Particle Swarm Optimization. Both are especially suited for numerical problems, such as nonlinear optimization, and are complementary to each other in that they even out their others shortcomings. </paragraph> + <table id="id=tab_id971589978166858"> + <tablerow> + <tablecell> + <paragraph id="par_id91559962440066" role="tablehead" xml-lang="en-US" localize="false"><embedvar href="text/scalc/01/solver_options_algo.xhp#settingshead"/></paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id111584962440067" role="tablehead" xml-lang="en-US" localize="false"><embedvar href="text/scalc/01/solver_options_algo.xhp#descriptionhead"/></paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph xml-lang="en-US" id="par_id0603200910394232" role="tablecontent" >Agent Switch Rate</paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id0603200910394248" role="tablecontent" >Specifies the probability for an individual to choose the Differential Evolution strategy.</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id481559963120045" role="tablecontent" xml-lang="en-US" localize="false"><embedvar href="text/scalc/01/solver_options_algo.xhp#noneghead" markup="ignore"/></paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id301589063120047" role="tablecontent" xml-lang="en-US" localize="false" ><embedvar href="text/scalc/01/solver_options_algo.xhp#nonegdesc" markup="ignore"/></paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph xml-lang="en-US" id="par_id0603200910394277" role="tablecontent" >DE: Crossover Probability</paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id0603200910394280" role="tablecontent" >Defines the probability of the individual being combined with the globally best point. If crossover is not used, the point is assembled from the own memory of the individual.</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph xml-lang="en-US" id="par_id0643200910394216" role="tablecontent" >DE: Scaling Factor</paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id360320091039424" role="tablecontent" >During crossover, the scaling factor decides about the “speed” of movement.</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph xml-lang="en-US" id="par_id0507200917103771" role="tablecontent" >Learning Cycles</paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id0503210917103720" role="tablecontent" >Defines the number of iterations, the algorithm should take. In each iteration, all individuals make a guess on the best solution and share their knowledge.</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3603200910394222" role="tablecontent" >PS: Cognitive Constant</paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id3603200915394212" role="tablecontent" >Sets the importance of the own memory (in particular the best reached point so far).</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph xml-lang="en-US" id="par_id060324091037421" role="tablecontent" >PS: Constriction Coefficient</paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id0608200910394225" role="tablecontent" >Defines the speed at which the particles/individuals move towards each other.</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph xml-lang="en-US" id="par_id060320091039425" role="tablecontent" >PS: Mutation Probability</paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id0603200910394272" role="tablecontent" >Defines the probability, that instead of moving a component of the particle towards the best point, it randomly chooses a new value from the valid range for that variable.</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph xml-lang="en-US" id="par_id0603200910394292" role="tablecontent" >PS: Social Constant</paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id0603200910394284" role="tablecontent" >Sets the importance of the global best point between all particles/individuals.</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph xml-lang="en-US" id="par_id0503200217103891" role="tablecontent" ><variable id="enhstatusheader">Show Enhanced Solver Status</variable></paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id0523200917103832" role="tablecontent" ><variable id="enhstatusdesc">If <emph>enabled</emph>, an additional dialog is shown during the solving process which gives information about the current progress, the level of stagnation, the currently best known solution as well as the possibility, to stop or resume the solver.</variable></paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph xml-lang="en-US" id="par_id0503200417103780" role="tablecontent" ><variable id="swarmheader">Size of Swarm</variable></paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id0503100917103723" role="tablecontent" ><variable id="swarmdesc">Defines the number of individuals to participate in the learning process. Each individual finds its own solutions and contributes to the overall knowledge.</variable></paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph xml-lang="en-US" id="par_id0504200917103794" role="tablecontent" ><variable id="stagnationheader">Stagnation Limit</variable></paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id050320091710377" role="tablecontent" ><variable id="stagnationdesc">If this number of individuals found solutions within a close range, the iteration is stopped and the best of these values is chosen as optimal.</variable></paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph xml-lang="en-US" id="par_id0503200917103762" role="tablecontent" ><variable id="stagtolheader">Stagnation Tolerance</variable></paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id0503200917103834" role="tablecontent" ><variable id="stagtoldesc">Defines in what range solutions are considered “similar”.</variable></paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph xml-lang="en-US" id="par_id0503200917103740" role="tablecontent" ><variable id="acrheader">Use ACR Comparator</variable></paragraph> + </tablecell> + <tablecell> + <section id="acrdesc"> + <paragraph xml-lang="en-US" id="par_id0503200917103766" role="tablecontent" >If <emph>disabled</emph> (default), the BCH Comparator is used. It compares two individuals by first looking at their constraint violations and only if those are equal, it measures their current solution.</paragraph> + <paragraph xml-lang="en-US" id="par_id0503200917103744" role="tablecontent" >If <emph>enabled</emph>, the ACR Comparator is used. It compares two individuals dependent on the current iteration and measures their goodness with knowledge about the libraries worst known solutions (in regard to their constraint violations).</paragraph> + </section> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph xml-lang="en-US" id="par_id0503200917103792" role="tablecontent" >Use Random Starting Point</paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id0503200917103790" role="tablecontent" >If <emph>enabled</emph>, the library is simply filled up with randomly chosen points.</paragraph> + <paragraph xml-lang="en-US" id="par_id0503200917103765" role="tablecontent" >If <emph>disabled</emph>, the currently present values (as given by the user) are inserted in the library as reference point.</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph xml-lang="en-US" id="par_id0503200917103732" role="tablecontent" ><variable id="variableguessheader">Variable Bounds Guessing</variable></paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id050320091710378" role="tablecontent" ><variable id="variableguessdesc">If enabled (default), the algorithm tries to find variable bounds by looking at the starting values.</variable></paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph xml-lang="en-US" id="par_id0503200917103794" role="tablecontent" ><variable id="variablethresheader">Variable Bounds Threshold</variable></paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id0503200917103710" role="tablecontent" ><variable id="variablethresdesc">When guessing variable bounds, this threshold specifies, how the initial values are shifted to build the bounds. For an example how these values are calculated, please refer to the Manual in the Wiki.</variable></paragraph> + </tablecell> + </tablerow> + </table> + + <h2 id="par_id391589925078747"><variable id="SCOEvolutionaryAlgorithmh2"><link href="text/scalc/01/solver_options_algo.xhp#SCOEvolutionaryAlgorithmh2" name="SCO Evolutionary Algorithm">SCO Evolutionary Algorithm</link></variable></h2> + <paragraph role="paragraph" id="par_id681590165847694">Social Cognitive Optimization takes into account the human behavior of learning and sharing information. Each individual has access to a common library with knowledge shared between all individuals. </paragraph> + <table id="tab_id911589978200895"> + <tablerow> + <tablecell> + <paragraph id="par_id41589962440066" role="tablehead" xml-lang="en-US" localize="false"><embedvar href="text/scalc/01/solver_options_algo.xhp#settingshead"/></paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id11158996249067" role="tablehead" xml-lang="en-US" localize="false"><embedvar href="text/scalc/01/solver_options_algo.xhp#descriptionhead"/></paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id481552963120045" role="tablecontent" xml-lang="en-US" localize="false"><embedvar href="text/scalc/01/solver_options_algo.xhp#noneghead" markup="ignore"/></paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id341589063120047" role="tablecontent" xml-lang="en-US" localize="false" ><embedvar href="text/scalc/01/solver_options_algo.xhp#nonegdesc" markup="ignore"/></paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph xml-lang="en-US" id="par_id0503200917103771" role="tablecontent" >Learning Cycles</paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id0503200917103720" role="tablecontent" >Defines the number of iterations, the algorithm should take. In each iteration, all individuals make a guess on the best solution and share their knowledge.</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id961589978701649" role="tablecontent" xml-lang="en-US" localize="false"><embedvar href="text/scalc/01/solver_options_algo.xhp#enhstatusheader"/></paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id591589978701651" role="tablecontent" xml-lang="en-US" localize="false"><embedvar href="text/scalc/01/solver_options_algo.xhp#enhstatusdesc"/></paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph xml-lang="en-US" id="par_id0603200910401382" role="tablecontent">Size of Library</paragraph> + </tablecell> + <tablecell> + <paragraph xml-lang="en-US" id="par_id060320091040136" role="tablecontent"> Defines the amount of information to store in the public library. Each individual stores knowledge there and asks for information.</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id201589979438102" role="tablecontent" xml-lang="en-US" localize="false"><embedvar href="text/scalc/01/solver_options_algo.xhp#swarmheader"/></paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id51589979438103" role="tablecontent" xml-lang="en-US" localize="false"><embedvar href="text/scalc/01/solver_options_algo.xhp#swarmdesc"/></paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id21589979541011" role="tablecontent" xml-lang="en-US" localize="false"><embedvar href="text/scalc/01/solver_options_algo.xhp#stagnationheader"/></paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id381589979541012" role="tablecontent" xml-lang="en-US" localize="false"><embedvar href="text/scalc/01/solver_options_algo.xhp#stagnationdesc"/></paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id371589979941538" role="tablecontent" xml-lang="en-US" localize="false"><embedvar href="text/scalc/01/solver_options_algo.xhp#stagtolheader"/></paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id991589979941539" role="tablecontent" xml-lang="en-US" localize="false"><embedvar href="text/scalc/01/solver_options_algo.xhp#stagtoldesc"/></paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id921589980257791" role="tablecontent" xml-lang="en-US" localize="false"><embedvar href="text/scalc/01/solver_options_algo.xhp#acrheader"/></paragraph> + </tablecell> + <tablecell> + <embed href="text/scalc/01/solver_options_algo.xhp#acrdesc"/> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id941589980611077" role="tablecontent" xml-lang="en-US" localize="false"><embedvar href="text/scalc/01/solver_options_algo.xhp#variableguessheader"/></paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id561589980611078" role="tablecontent" xml-lang="en-US" localize="false"><embedvar href="text/scalc/01/solver_options_algo.xhp#variableguessdesc"/></paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id741589980722689" role="tablecontent" xml-lang="en-US" ><embedvar href="text/scalc/01/solver_options_algo.xhp#variablethresheader"/></paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id901589980722691" role="tablecontent" xml-lang="en-US" ><embedvar href="text/scalc/01/solver_options_algo.xhp#variablethresdesc"/></paragraph> + </tablecell> + </tablerow> + </table> + <h2 id="par_id671589925148891"><variable id="LinearSolverh2"><link href="text/scalc/01/solver_options_algo.xhp#LinearSolverh2" name="%PRODUCTNAME Linear Solver">%PRODUCTNAME Linear Solver and CoinMP Linear solver</link></variable></h2> + <table id="tab_id251589925837980"> + <tablerow> + <tablecell> + <paragraph id="par_id731589925837981" role="tablehead" xml-lang="en-US"><variable id="settingshead">Setting</variable></paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id611589925837982" role="tablehead" xml-lang="en-US"><variable id="descriptionhead">Description</variable></paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id511589925837984" role="paragraph" xml-lang="en-US"><variable id="integerhead">Assume variables as integers</variable></paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id11589925837985" role="paragraph" xml-lang="en-US"><variable id="integerdesc">Mark to force variables to be integers only.</variable></paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id221589961756407" role="tablecontent" xml-lang="en-US" ><variable id="noneghead">Assume variables as non negative</variable></paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id861589961756408" role="tablecontent" xml-lang="en-US" ><variable id="nonegdesc">Mark to force variables to be positive only.</variable></paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id971589961907787" role="tablecontent" xml-lang="en-US" >Epsilon level</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id421589961907788" role="tablecontent" xml-lang="en-US" >Epsilon level. Valid values are in range 0 (very tight) to 3 (very loose). Epsilon is the tolerance for rounding values to zero.</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id71589961998523" role="tablecontent" xml-lang="en-US" >Limit branch-and-bound depth</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id331589961998525" role="tablecontent" xml-lang="en-US" > Specifies the maximum branch-and-bound depth. A positive value means that the depth is absolute. A negative value means a relative branch-and-bound depth limit.</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id91589962070327" role="tablecontent" xml-lang="en-US" ><variable id="timelimithead">Solver time limit</variable></paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id331589962070329" role="tablecontent" xml-lang="en-US" ><variable id="timelimitdesc">Sets the maximum time for the algorithm to converge to a solution.</variable></paragraph> + </tablecell> + </tablerow> + </table> + <h2 id="par_id711589925192067"><variable id="SwarmNonLinearSolverh2"><link href="text/scalc/01/solver_options_algo.xhp#SwarmNonLinearSolverh2" name="%PRODUCTNAME Swarm Non-Linear Solver (Experimental)">%PRODUCTNAME Swarm Non-Linear Solver (Experimental)</link></variable></h2> + <table id="tab_id471589962440065"> + <tablerow> + <tablecell> + <paragraph id="par_id91589962440066" role="tablehead" xml-lang="en-US" localize="false"><embedvar href="text/scalc/01/solver_options_algo.xhp#settingshead"/></paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id111589962440067" role="tablehead" xml-lang="en-US" localize="false"><embedvar href="text/scalc/01/solver_options_algo.xhp#descriptionhead"/></paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id581589962440069" role="paragraph" xml-lang="en-US" localize="false"><embedvar href="text/scalc/01/solver_options_algo.xhp#integerhead" markup="ignore"/></paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id161589962440070" role="paragraph" xml-lang="en-US" localize="false"><embedvar href="text/scalc/01/solver_options_algo.xhp#integerdesc" markup="ignore"/></paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id481589963120045" role="tablecontent" xml-lang="en-US" localize="false"><embedvar href="text/scalc/01/solver_options_algo.xhp#noneghead" markup="ignore"/></paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id301589963120047" role="tablecontent" xml-lang="en-US" localize="false" ><embedvar href="text/scalc/01/solver_options_algo.xhp#nonegdesc" markup="ignore"/></paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id101589963304145" role="tablecontent" xml-lang="en-US" localize="false" ><embedvar href="text/scalc/01/solver_options_algo.xhp#timelimithead" markup="ignore"/></paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id461589963304146" role="tablecontent" xml-lang="en-US" localize="false"><embedvar href="text/scalc/01/solver_options_algo.xhp#timelimitdesc" markup="ignore"/></paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id971589963431459" role="tablecontent" xml-lang="en-US" >Swarm algorithm</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id71589963431460" role="tablecontent" xml-lang="en-US" >Set the swarm algorithm. 0 for differential evolution and 1 for particle swarm optimization. Default is 0.</paragraph> + </tablecell> + </tablerow> + </table> + <section id="relatedtopics"> + <embed href="text/scalc/01/solver_options.xhp#solveroptionsh1"/> + <embed href="text/scalc/01/solver.xhp#solver"/> + <paragraph role="paragraph" id="par_id271589981559367"><link href="https://wiki.documentfoundation.org/NLPSolver" name="wikipage">Wiki page on non-linear solvers and theirs algorithms</link></paragraph> + <paragraph role="paragraph" id="par_id211590163660314"><link href="http://lpsolve.sourceforge.net/">lp_solve reference guide in sourceforge.net</link></paragraph> + </section> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/sparklines.xhp b/helpcontent2/source/text/scalc/01/sparklines.xhp new file mode 100644 index 000000000..70d9c1b0e --- /dev/null +++ b/helpcontent2/source/text/scalc/01/sparklines.xhp @@ -0,0 +1,91 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> + <!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + --> + + <meta> + <topic id="textscalc01sparklines.xhp" indexer="include" status="PUBLISH"> + <title id="tit" xml-lang="en-US">Sparklines</title> + <filename>/text/scalc/01/sparklines.xhp</filename> + </topic> + </meta> + <body> + <bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/sparklinedialog/SparklineDialog" id="bm_id551654173649481" localize="false"/> + <bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/sparklinedialog/@@nowidget@@" id="bm_id561654173649481" localize="false"/> + + <bookmark xml-lang="en-US" branch="index" id="bm_id901654173679276"> +<bookmark_value>sparklines</bookmark_value> + </bookmark> + <section id="sparklinesh1"> + <h1 id="hd_id721654173263812"><variable id="sparklines"><link href="text/scalc/01/sparklines.xhp" name="Sparklines">Sparklines</link></variable></h1> + <paragraph id="par_id981654173263817" role="paragraph" xml-lang="en-US">Sparklines are small data charts displayed inside a cell.</paragraph> + </section> + <paragraph role="paragraph" id="par_id341654174064080">Sparklines are defined for one cell, but multiple sparklines can be joined together into a group. The group shares the same properties for rendering the sparkline. The unique data that is defined only for one sparkline is the data range, that a sparkline will use for rendering.</paragraph> + <section id="howtoget"> + <paragraph role="paragraph" id="par_id761654173486733">Choose <menuitem>Insert – Sparklines</menuitem></paragraph> + </section> + <h2 id="hd_id391654173530650">Data</h2> + <paragraph role="paragraph" id="par_id751654174462868"><emph>Input range</emph>: enter the cell range of the data. Use the <emph>shrink</emph> button to select the data range with the mouse.</paragraph> + <paragraph role="paragraph" id="par_id701654174578218"><emph>Output range</emph>: select the cell range to receive the sparkline. Use the <emph>shrink</emph> button to select the cell range with the mouse.</paragraph> + <h2 id="hd_id651654174597644">Properties</h2> + <paragraph role="paragraph" id="par_id961654174732293"><emph>Type</emph>: select the sparkline type in the drop-down list. Choices are:</paragraph> + <list type="unordered"> + <listitem> + <paragraph id="par_id481654191793887" role="listitem"><emph>Line</emph>: draws a line between data values.</paragraph> + </listitem> + <listitem> + <paragraph id="par_id391654191798913" role="listitem"><emph>Column</emph>: draws a bar for each data value.</paragraph> + </listitem> + <listitem> + <paragraph id="par_id481654191804474" role="listitem"><emph>Stacked</emph>: also known as win/loss. Displays equally sized bars indicating positive and negative values.</paragraph> + </listitem> + </list> + <paragraph role="paragraph" id="par_id701654174850309"><emph>Line width</emph>: enter the line width number manually or use the spin button.</paragraph> + <paragraph role="paragraph" id="par_id761654176569576"><emph>Display empty cells as</emph>: choices are available in the drop-down list:</paragraph> + <list type="unordered"> + <listitem> + <paragraph id="par_id171654176533173" role="listitem"><emph>Gap</emph>: the missing data is not displayed. The line type discontinues in the gap and the column is not displayed.</paragraph> + </listitem> + <listitem> + <paragraph id="par_id81654176538165" role="listitem"><emph>Zero</emph>: the missing data is displayed as value zero.</paragraph> + </listitem> + <listitem> + <paragraph id="par_id801654176544375" role="listitem"><emph>Span</emph>: for line type only, draws a continuous line connecting the previous value to the next value.</paragraph> + </listitem> + </list> + <paragraph role="paragraph" id="par_id431654176711837"><emph>Display hidden</emph>: check to show all columns or stacks in the range even when the data is in hidden cells. If unchecked, the hidden data is ignored.</paragraph> + <paragraph role="paragraph" id="par_id21654177035348"><emph>Right-to-left</emph>: check to display the sparklines reverse order of the data.</paragraph> + <h2 id="hd_id911654177186844">Colors</h2> + <paragraph role="paragraph" id="par_id11654177765370"><emph>Series</emph>: select the main color for the sparklines.</paragraph> + <paragraph role="paragraph" id="par_id421654177770032"><emph>Negative points</emph>: check and select the color for negative points.</paragraph> + <paragraph role="paragraph" id="par_id231654177773798"><emph>High points</emph>: check and select the color for high points.</paragraph> + <paragraph role="paragraph" id="par_id371654177777479"><emph>Low points</emph>: check and select the color for low points.</paragraph> + <paragraph role="paragraph" id="par_id521654177784536"><emph>Marker</emph>: check and select the color for data points (line type only).</paragraph> + <paragraph role="paragraph" id="par_id181654177788533"><emph>First point</emph>: check and select the color for first point.</paragraph> + <paragraph role="paragraph" id="par_id241654177793144"><emph>Last point</emph>: check and select the color for last point.</paragraph> + + <h2 id="hd_id251654180880861">Axes</h2> + <paragraph role="paragraph" id="par_id871654181525722"><emph>Display X axis</emph>: check to show the X axis for sparklines.</paragraph> + <paragraph role="paragraph" id="par_id891654181533521"><emph>Vertical minimum, Vertical maximum:</emph> check to set the minimum (maximum) value for the Y axis. Select one of following:</paragraph> + <list type="unordered"> + <listitem> + <paragraph id="par_id521654181404234" role="listitem"><emph>Individual</emph>: sets automatically the minimum (maximum) value for each sparkline based on the sparkline data range values.</paragraph> + </listitem> + <listitem> + <paragraph id="par_id821654181425448" role="listitem"><emph>Group</emph>: sets the minimum (maximum) value based on the lower and higher values found in the group of sparklines.</paragraph> + </listitem> + <listitem> + <paragraph id="par_id51654181442414" role="listitem"><emph>Custom</emph>: enter the minimum (maximum) value for the sparkline group. Enter the minimum (maximum) values or use the spin buttons.</paragraph> + </listitem> + </list> + <section id="relatedtopics"> + <paragraph role="paragraph" id="par_id801654192214865"><link href="https://tomazvajngerl.blogspot.com/2022/03/sparklines-in-calc.html" name="developer info">Developer blog post on sparklines</link></paragraph> + </section> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/stat_data.xhp b/helpcontent2/source/text/scalc/01/stat_data.xhp new file mode 100644 index 000000000..7556d0d10 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/stat_data.xhp @@ -0,0 +1,1337 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> + <!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + --> + + <meta> + <topic id="ID" indexer="include"> + <title id="tit" xml-lang="en-US">Data</title> + <filename>/text/scalc/01/stat_data.xhp</filename> + </topic> + </meta> + + <body> + + <section id="data"> + <h2 id="hd_id1000010">Data</h2> + <paragraph id="par_id1000010" role="paragraph" xml-lang="en-US"><emph>Input Range</emph>: The reference of the range of the data to analyze.</paragraph> + <paragraph id="par_id1000020" role="paragraph" xml-lang="en-US"><emph>Results to</emph>: The reference of the top left cell of the range where the results will be displayed.</paragraph> + </section> + + <section id="grouped"> + <h3 id="hd_id1000020">Grouped By</h3> + <paragraph id="par_id1000030" role="paragraph" xml-lang="en-US">Select whether the input data has <emph>columns</emph> or <emph>rows</emph> layout.</paragraph> + </section> + +<section id="otherstat"> +<embed href="text/scalc/01/statistics_sampling.xhp#datasamplingh1"/> +<embed href="text/scalc/01/statistics_descriptive.xhp#descriptivestatisticsh1"/> +<embed href="text/scalc/01/statistics_anova.xhp#anovah1"/> +<embed href="text/scalc/01/statistics_correlation.xhp#correlationh1"/> +<embed href="text/scalc/01/statistics_covariance.xhp#covarianceh1"/> +<embed href="text/scalc/01/statistics_exposmooth.xhp#exponentialsmoothingh1"/> +<embed href="text/scalc/01/statistics_movingavg.xhp#movingaverageh1"/> +<embed href="text/scalc/01/statistics_regression.xhp#regressionanalysish1"/> +<embed href="text/scalc/01/statistics_test_t.xhp#ttesth1"/> +<embed href="text/scalc/01/statistics_test_f.xhp#ftesth1"/> +<embed href="text/scalc/01/statistics_test_z.xhp#ztesth1"/> +<embed href="text/scalc/01/statistics_test_chisqr.xhp#chisqtesth1"/> +<embed href="text/scalc/01/statistics_fourier.xhp#fourieranalysysh1"/> +</section> + +<section id="sampledata01"> + + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph id="par_id1000040" role="paragraph" xml-lang="en-US">The following data will be used as example </paragraph> + + <table id="Tabela3"> + <tablerow> + <tablecell> + </tablecell> + <tablecell> + <paragraph id="par_id1000050" localize="false" role="tablehead" xml-lang="en-US">A</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id1000060" role="tablehead" xml-lang="en-US" localize="false">B</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id1000070" role="tablehead" xml-lang="en-US" localize="false">C</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id1000080" role="tablehead" localize="false" xml-lang="en-US">1</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id1000090" role="tablehead" xml-lang="en-US">Maths</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id1000100" role="tablehead" xml-lang="en-US">Physics</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id1000110" role="tablehead" xml-lang="en-US">Biology</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id1000120" role="tablehead" localize="false" xml-lang="en-US">2</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id1000130" role="tablecontent" localize="false" xml-lang="en-US">47</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id1000140" role="tablecontent" localize="false" xml-lang="en-US">67</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id1000150" role="tablecontent" localize="false" xml-lang="en-US">33</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id1000160" role="tablehead" localize="false" xml-lang="en-US">3</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id1000170" role="tablecontent" localize="false" xml-lang="en-US">36</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id1000180" role="tablecontent" localize="false" xml-lang="en-US">68</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id1000190" role="tablecontent" localize="false" xml-lang="en-US">42</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id1000200" role="tablehead" localize="false" xml-lang="en-US">4</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id1000210" role="tablecontent" localize="false" xml-lang="en-US">40</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id1000220" role="tablecontent" localize="false" xml-lang="en-US">65</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id1000230" role="tablecontent" localize="false" xml-lang="en-US">44</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id1000240" role="tablehead" localize="false" xml-lang="en-US">5</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id1000250" role="tablecontent" localize="false" xml-lang="en-US">39</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id1000260" role="tablecontent" localize="false" xml-lang="en-US">64</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id1000270" role="tablecontent" localize="false" xml-lang="en-US">60</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id1000280" role="tablehead" localize="false" xml-lang="en-US">6</paragraph> + </tablecell> + <tablecell> + </tablecell> + <tablecell> + <paragraph id="par_id1000290" role="tablecontent" localize="false" xml-lang="en-US">38</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id1000300" role="tablecontent" localize="false" xml-lang="en-US">43</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id1000310" role="tablehead" localize="false" xml-lang="en-US">7</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id1000320" role="tablecontent" localize="false" xml-lang="en-US">47</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id1000330" role="tablecontent" localize="false" xml-lang="en-US">84</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id1000340" role="tablecontent" localize="false" xml-lang="en-US">62</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id1000350" role="tablehead" localize="false" xml-lang="en-US">8</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id1000360" role="tablecontent" localize="false" xml-lang="en-US">29</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id1000370" role="tablecontent" localize="false" xml-lang="en-US">80</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id1000380" role="tablecontent" localize="false" xml-lang="en-US">51</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id1000390" role="tablehead" localize="false" xml-lang="en-US">9</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id1000400" role="tablecontent" localize="false" xml-lang="en-US">27</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id1000410" role="tablecontent" localize="false" xml-lang="en-US">49</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id1000420" role="tablecontent" localize="false" xml-lang="en-US">40</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id1000430" role="tablehead" localize="false" xml-lang="en-US">10</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id1000440" role="tablecontent" localize="false" xml-lang="en-US">57</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id1000450" role="tablecontent" localize="false" xml-lang="en-US">49</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id1000460" role="tablecontent" localize="false" xml-lang="en-US">12</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id1000470" role="tablehead" localize="false" xml-lang="en-US">11</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id1000480" role="tablecontent" localize="false" xml-lang="en-US">56</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id1000490" role="tablecontent" localize="false" xml-lang="en-US">33</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id1000500" role="tablecontent" localize="false" xml-lang="en-US">60</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id1000510" role="tablehead" localize="false" xml-lang="en-US">12</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id1000520" role="tablecontent" localize="false" xml-lang="en-US">57</paragraph> + </tablecell> + <tablecell> + </tablecell> + <tablecell> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id1000530" role="tablehead" localize="false" xml-lang="en-US">13</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id1000540" role="tablecontent" localize="false" xml-lang="en-US">26</paragraph> + </tablecell> + <tablecell> + </tablecell> + <tablecell> + </tablecell> + </tablerow> + </table> + + </section> + + <section id="timeseries01"> + + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph id="par_id1000550" role="paragraph" xml-lang="en-US">The following table has two time series, one representing an impulse function at time t=0 and the other an impulse function at time t=2.</paragraph> + + <table id="Tabela8"> + <tablerow> + <tablecell> + </tablecell> + <tablecell> + <paragraph id="par_id1000560" role="tablehead" localize="false" xml-lang="en-US">A</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id1000570" role="tablehead" localize="false" xml-lang="en-US">B</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id1000580" role="tablehead" localize="false" xml-lang="en-US">1</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id1000590" role="tablecontent" localize="false" xml-lang="en-US">1</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id1000600" role="tablecontent" localize="false" xml-lang="en-US">0</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id1000610" role="tablehead" localize="false" xml-lang="en-US">2</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id1000620" role="tablecontent" localize="false" xml-lang="en-US">0</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id1000630" role="tablecontent" localize="false" xml-lang="en-US">0</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id1000640" role="tablehead" localize="false" xml-lang="en-US">3</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id1000650" role="tablecontent" localize="false" xml-lang="en-US">0</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id1000660" role="tablecontent" localize="false" xml-lang="en-US">1</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id1000670" role="tablehead" localize="false" xml-lang="en-US">4</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id1000680" role="tablecontent" localize="false" xml-lang="en-US">0</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id1000690" role="tablecontent" localize="false" xml-lang="en-US">0</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id1000700" role="tablehead" localize="false" xml-lang="en-US">5</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id1000710" role="tablecontent" localize="false" xml-lang="en-US">0</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id1000720" role="tablecontent" localize="false" xml-lang="en-US">0</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id1000730" role="tablehead" localize="false" xml-lang="en-US">6</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id1000740" role="tablecontent" localize="false" xml-lang="en-US">0</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id1000750" role="tablecontent" localize="false" xml-lang="en-US">0</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id1000760" role="tablehead" localize="false" xml-lang="en-US">7</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id1000770" role="tablecontent" localize="false" xml-lang="en-US">0</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id1000780" role="tablecontent" localize="false" xml-lang="en-US">0</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id1000790" role="tablehead" localize="false" xml-lang="en-US">8</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id1000800" role="tablecontent" localize="false" xml-lang="en-US">0</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id1000810" role="tablecontent" localize="false" xml-lang="en-US">0</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id1000820" role="tablehead" localize="false" xml-lang="en-US">9</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id1000830" role="tablecontent" localize="false" xml-lang="en-US">0</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id1000840" role="tablecontent" localize="false" xml-lang="en-US">0</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id1000850" role="tablehead" localize="false" xml-lang="en-US">10</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id1000860" role="tablecontent" localize="false" xml-lang="en-US">0</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id1000870" role="tablecontent" localize="false" xml-lang="en-US">0</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id1000880" role="tablehead" localize="false" xml-lang="en-US">11</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id1000890" role="tablecontent" localize="false" xml-lang="en-US">0</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id1000900" role="tablecontent" localize="false" xml-lang="en-US">0</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id1000910" role="tablehead" localize="false" xml-lang="en-US">12</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id1000920" role="tablecontent" localize="false" xml-lang="en-US">0</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id1000930" role="tablecontent" localize="false" xml-lang="en-US">0</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id1000940" role="tablehead" localize="false" xml-lang="en-US">13</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id1000950" role="tablecontent" localize="false" xml-lang="en-US">0</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id1000960" role="tablecontent" localize="false" xml-lang="en-US">0</paragraph> + </tablecell> + </tablerow> + </table> + + </section> + + <section id="datafortests"> + + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph id="par_id1000970" role="paragraph" xml-lang="en-US">The following table has two data sets.</paragraph> + + <table id="Tabela9"> + <tablerow> + <tablecell> + </tablecell> + <tablecell> + <paragraph id="par_id1000980" role="tablehead" xml-lang="en-US" localize="false">A</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id1000990" role="tablehead" xml-lang="en-US" localize="false">B</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id1001000" role="tablehead" xml-lang="en-US" localize="false">1</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id1001010" role="tablecontent" xml-lang="en-US" localize="false">28</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id1001020" role="tablecontent" xml-lang="en-US" localize="false">19</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id1001030" role="tablehead" xml-lang="en-US" localize="false">2</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id1001040" role="tablecontent" xml-lang="en-US" localize="false">26</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id1001050" role="tablecontent" xml-lang="en-US" localize="false">13</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id1001060" role="tablehead" xml-lang="en-US" localize="false">3</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id1001070" role="tablecontent" xml-lang="en-US" localize="false">31</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id1001080" role="tablecontent" xml-lang="en-US" localize="false">12</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id1001090" role="tablehead" xml-lang="en-US" localize="false">4</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id1001100" role="tablecontent" xml-lang="en-US" localize="false">23</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id1001110" role="tablecontent" xml-lang="en-US" localize="false">5</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id1001120" role="tablehead" xml-lang="en-US" localize="false">5</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id1001130" role="tablecontent" xml-lang="en-US" localize="false">20</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id1001140" role="tablecontent" xml-lang="en-US" localize="false">34</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id1001150" role="tablehead" xml-lang="en-US" localize="false">6</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id1001160" role="tablecontent" xml-lang="en-US" localize="false">27</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id1001170" role="tablecontent" xml-lang="en-US" localize="false">31</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id1001180" role="tablehead" xml-lang="en-US" localize="false">7</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id1001190" role="tablecontent" xml-lang="en-US" localize="false">28</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id1001200" role="tablecontent" xml-lang="en-US" localize="false">31</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id1001210" role="tablehead" xml-lang="en-US" localize="false">8</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id1001220" role="tablecontent" xml-lang="en-US" localize="false">14</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id1001230" role="tablecontent" xml-lang="en-US" localize="false">12</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id1001240" role="tablehead" xml-lang="en-US" localize="false">9</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id1001250" role="tablecontent" xml-lang="en-US" localize="false">4</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id1001260" role="tablecontent" xml-lang="en-US" localize="false">24</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id1001270" role="tablehead" xml-lang="en-US" localize="false">10</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id1001280" role="tablecontent" xml-lang="en-US" localize="false">0</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id1001290" role="tablecontent" xml-lang="en-US" localize="false">23</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id1001300" role="tablehead" xml-lang="en-US" localize="false">11</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id1001310" role="tablecontent" xml-lang="en-US" localize="false">2</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id1001320" role="tablecontent" xml-lang="en-US" localize="false">19</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id1001330" role="tablehead" xml-lang="en-US" localize="false">12</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id1001340" role="tablecontent" xml-lang="en-US" localize="false">8</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id1001350" role="tablecontent" xml-lang="en-US" localize="false">10</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id1001360" role="tablehead" xml-lang="en-US" localize="false">13</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id1001370" role="tablecontent" xml-lang="en-US" localize="false">9</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id1001380" role="tablecontent" xml-lang="en-US" localize="false">33</paragraph> + </tablecell> + </tablerow> + </table> + + </section> + + <section id="regressiondata"> + + <embed href="text/scalc/01/common_func.xhp#sectionexample"/> + <paragraph id="par_id1701201619425624" role="paragraph" xml-lang="en-US">The following table has samples of a physical phenomenon taken in 1 second interval.</paragraph> + <table id="table regression"> + <tablerow> + <tablecell> + </tablecell> + <tablecell> + <paragraph id="par_id170120161940524" role="tablehead" xml-lang="en-US" localize="false">A</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id1701201619405255" role="tablehead" xml-lang="en-US" localize="false">B</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id1701201619405244" role="tablehead" xml-lang="en-US" localize="false">1</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id1901201614441023" role="paragraph" xml-lang="en-US" localize="false">Time</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id1901201614441056" role="paragraph" xml-lang="en-US" localize="false">Measurement</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id1701201619405214" role="tablehead" xml-lang="en-US" localize="false">2</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id1901201614441082" role="paragraph" xml-lang="en-US" localize="false">1</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id190120161501214" role="paragraph" xml-lang="en-US" localize="false">2.7</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id1701201619405278" role="tablehead" xml-lang="en-US" localize="false">3</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id1901201614441385" role="paragraph" xml-lang="en-US" localize="false">2</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id1901201615012191" role="paragraph" xml-lang="en-US" localize="false">4.0</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id1701201619405257" role="tablehead" xml-lang="en-US" localize="false">4</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id1901201614441322" role="paragraph" xml-lang="en-US" localize="false">3</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id1901201615012192" role="paragraph" xml-lang="en-US" localize="false">4.4</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id1701201619405289" role="tablehead" xml-lang="en-US" localize="false">5</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id1901201614441312" role="paragraph" xml-lang="en-US" localize="false">4</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id1901201615012187" role="paragraph" xml-lang="en-US" localize="false">7.1</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id1701201619405317" role="tablehead" xml-lang="en-US" localize="false">6</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id1901201614441399" role="paragraph" xml-lang="en-US" localize="false">5</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id1901201615012121" role="paragraph" xml-lang="en-US" localize="false">4.9</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id1701201619405368" role="tablehead" xml-lang="en-US" localize="false">7</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id1901201614441393" role="paragraph" xml-lang="en-US" localize="false">6</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id1901201615012143" role="paragraph" xml-lang="en-US" localize="false">3.6</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id1701201619405345" role="tablehead" xml-lang="en-US" localize="false">8</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id190120161444136" role="paragraph" xml-lang="en-US" localize="false">7</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id1901201615012166" role="paragraph" xml-lang="en-US" localize="false">4.0</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id1701201619405311" role="tablehead" xml-lang="en-US" localize="false">9</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id1901201614441334" role="paragraph" xml-lang="en-US" localize="false">8</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id1901201615012149" role="paragraph" xml-lang="en-US" localize="false">0.6</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id1701201619405353" role="tablehead" xml-lang="en-US" localize="false">10</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id1901201614441380" role="paragraph" xml-lang="en-US" localize="false">9</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id1901201615012153" role="paragraph" xml-lang="en-US" localize="false">1.0</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id1701201619405381" role="tablehead" xml-lang="en-US" localize="false">11</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id1901201614441330" role="paragraph" xml-lang="en-US" localize="false">10</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id1901201615012135" role="paragraph" xml-lang="en-US" localize="false">4.3</paragraph> + </tablecell> + </tablerow> + </table> + </section> + + <section id="fourierdata"> + <table id="fouriertable"> + <tablerow> + <tablecell colspan="2"> + <paragraph role="paragraph" id="par_id11561818344892"><emph>Group By Columns</emph></paragraph> + </tablecell> + <tablecell colspan="3"> + <paragraph role="paragraph" id="par_id151561818353339">TRUE</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell colspan="2"> + <paragraph role="paragraph" id="par_id141561818361892"><emph>Polar</emph></paragraph> + </tablecell> + <tablecell colspan="3"> + <paragraph role="paragraph" id="par_id361561818366868">FALSE</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell colspan="2"> + <paragraph role="paragraph" id="par_id181561818387534"><emph>Inverse</emph></paragraph> + </tablecell> + <tablecell colspan="3"> + <paragraph role="paragraph" id="par_id681561818391189">FALSE</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell colspan="2"> + <paragraph id="par_id201561827895671" role="paragraph"><emph>Formula</emph></paragraph> + </tablecell> + <tablecell colspan="3"> + <paragraph role="paragraph" id="par_id361561818379679">{=FOURIER(B6:C40,B1,B2,B3,0)}</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell colspan="2"> + <paragraph role="tablehead" id="par_id711561818399814"><emph>Source Array</emph></paragraph> + </tablecell> + <tablecell> + </tablecell> + <tablecell colspan="2"> + <paragraph role="tablehead" id="par_id551561818405550"><emph>Transformed Array</emph></paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph role="tablecontent" id="par_id581561818425613"><emph>Real</emph></paragraph> + </tablecell> + <tablecell> + <paragraph role="tablecontent" id="par_id251561818431620"><emph>Imaginary</emph></paragraph> + </tablecell> + <tablecell> + </tablecell> + <tablecell> + <paragraph role="tablecontent" id="par_id161561818436495"><emph>Real</emph></paragraph> + </tablecell> + <tablecell> + <paragraph role="tablecontent" id="par_id471561818441429"><emph>Imaginary</emph></paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph role="paragraph" localize="false" id="par_id801561818463882">0.392555411592569</paragraph> + </tablecell> + <tablecell> + <paragraph role="paragraph" localize="false" id="par_id721561818470696">0</paragraph> + </tablecell> + <tablecell> + </tablecell> + <tablecell> + <paragraph role="paragraph" localize="false" id="par_id901561818478432">17.1775578743134</paragraph> + </tablecell> + <tablecell> + <paragraph role="paragraph" localize="false" id="par_id231561818483198">3.88635177703826E-015</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph role="paragraph" localize="false" id="par_id451561818495372">1.20843701681219</paragraph> + + </tablecell> + <tablecell> + <paragraph role="paragraph" localize="false" id="par_id841561818500031">0</paragraph> + </tablecell> + <tablecell> + </tablecell> + <tablecell> + <paragraph role="paragraph" localize="false" id="par_id351561818505918">3.428868795359</paragraph> + </tablecell> + <tablecell> + <paragraph role="paragraph" localize="false" id="par_id741561818511221">2.37164790000189</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph role="paragraph" localize="false" id="par_id71561818588117">0.851477676762644</paragraph> + </tablecell> + <tablecell> + <paragraph role="paragraph" localize="false" id="par_id151561818594448">0</paragraph> + </tablecell> + <tablecell> + </tablecell> + <tablecell> + <paragraph role="paragraph" localize="false" id="par_id781561818600947">-6.80271615433369</paragraph> + </tablecell> + <tablecell> + <paragraph role="paragraph" localize="false" id="par_id331561818606157">-15.1345439297576</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph role="paragraph" localize="false" id="par_id511561818617438">1.78534651907738</paragraph> + </tablecell> + <tablecell> + <paragraph role="paragraph" localize="false" id="par_id71561818624526">0</paragraph> + </tablecell> + <tablecell> + </tablecell> + <tablecell> + <paragraph role="paragraph" localize="false" id="par_id511561818630050">-1.605447356601</paragraph> + </tablecell> + <tablecell> + <paragraph role="paragraph" localize="false" id="par_id531561818635293">-5.08653060378972</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph role="paragraph" localize="false" id="par_id201561818646809">1.77946506138316</paragraph> + </tablecell> + <tablecell> + <paragraph role="paragraph" localize="false" id="par_id181561818652799">0</paragraph> + </tablecell> + <tablecell> + </tablecell> + <tablecell> + <paragraph role="paragraph" localize="false" id="par_id941561818657440">0.395847917447356</paragraph> + </tablecell> + <tablecell> + <paragraph role="paragraph" localize="false" id="par_id211561818662346">-2.41926785527625</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph role="paragraph" localize="false" id="par_id201561818672591">1.51890060220168</paragraph> + </tablecell> + <tablecell> + <paragraph role="paragraph" localize="false" id="par_id521561818697771">0</paragraph> + </tablecell> + <tablecell> + </tablecell> + <tablecell> + <paragraph role="paragraph" localize="false" id="par_id231561818703358">-1.49410383304833</paragraph> + </tablecell> + <tablecell> + <paragraph role="paragraph" localize="false" id="par_id351561818708108">-2.39148041275</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph role="paragraph" localize="false" id="par_id511561818720692">1.04694666137238</paragraph> + </tablecell> + <tablecell> + <paragraph role="paragraph" localize="false" id="par_id81561818725058">0</paragraph> + </tablecell> + <tablecell> + </tablecell> + <tablecell> + <paragraph role="paragraph" localize="false" id="par_id631561818732885">0.87223579298981</paragraph> + </tablecell> + <tablecell> + <paragraph role="paragraph" localize="false" id="par_id491561818737195">-1.14394086206797</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph role="paragraph" localize="false" id="par_id341561818748455">0.83110083951399</paragraph> + </tablecell> + <tablecell> + <paragraph role="paragraph" localize="false" id="par_id731561818753079">0</paragraph> + </tablecell> + <tablecell> + </tablecell> + <tablecell> + <paragraph role="paragraph" localize="false" id="par_id171561818760856">1.5332458505929</paragraph> + </tablecell> + <tablecell> + <paragraph role="paragraph" localize="false" id="par_id371561818765611">0.678159168870983</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph role="paragraph" localize="false" id="par_id271561818784104">1.23006228455127</paragraph> + </tablecell> + <tablecell> + <paragraph role="paragraph" localize="false" id="par_id661561818790833">0</paragraph> + </tablecell> + <tablecell> + </tablecell> + <tablecell> + <paragraph role="paragraph" localize="false" id="par_id101561818795844">0.450563708411459</paragraph> + </tablecell> + <tablecell> + <paragraph role="paragraph" localize="false" id="par_id31561818802582">0.22911248792634</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph role="paragraph" localize="false" id="par_id11561818812548">0.133409796396031</paragraph> + </tablecell> + <tablecell> + <paragraph role="paragraph" localize="false" id="par_id41561818817467">0</paragraph> + </tablecell> + <tablecell> + </tablecell> + <tablecell> + <paragraph role="paragraph" localize="false" id="par_id461561818823748">0.545106616940358</paragraph> + </tablecell> + <tablecell> + <paragraph role="paragraph" localize="false" id="par_id761561818828054">0.411028927740438</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph role="paragraph" localize="false" id="par_id961561818837482">0.130471655802496</paragraph> + </tablecell> + <tablecell> + <paragraph role="paragraph" localize="false" id="par_id651561818842250">0</paragraph> + </tablecell> + <tablecell> + </tablecell> + <tablecell> + <paragraph role="paragraph" localize="false" id="par_id281561818846175">2.22685996425193</paragraph> + </tablecell> + <tablecell> + <paragraph role="paragraph" localize="false" id="par_id891561818850209">-2.43092236748302</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph role="paragraph" localize="false" id="par_id391561818882179">0.386478761838145</paragraph> + </tablecell> + <tablecell> + <paragraph role="paragraph" localize="false" id="par_id511561818888890">0</paragraph> + </tablecell> + <tablecell> + </tablecell> + <tablecell> + <paragraph role="paragraph" localize="false" id="par_id11561818894216">-1.61522859107175</paragraph> + </tablecell> + <tablecell> + <paragraph role="paragraph" localize="false" id="par_id781561818899764">-2.41682657284899</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph role="paragraph" localize="false" id="par_id801561818913687">-0.703398287742919</paragraph> + </tablecell> + <tablecell> + <paragraph role="paragraph" localize="false" id="par_id871561818918456">0</paragraph> + </tablecell> + <tablecell> + </tablecell> + <tablecell> + <paragraph role="paragraph" localize="false" id="par_id651561818923166">1.30245078290168</paragraph> + </tablecell> + <tablecell> + <paragraph role="paragraph" localize="false" id="par_id381561818928231">1.45443785733126</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph role="paragraph" localize="false" id="par_id781561818940758">-0.899115309693977</paragraph> + </tablecell> + <tablecell> + <paragraph role="paragraph" localize="false" id="par_id971561818947103">0</paragraph> + </tablecell> + <tablecell> + </tablecell> + <tablecell> + <paragraph role="paragraph" localize="false" id="par_id111561818951932">1.57930628561185</paragraph> + </tablecell> + <tablecell> + <paragraph role="paragraph" localize="false" id="par_id961561818966489">-1.33862736591677</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph role="paragraph" localize="false" id="par_id151561818975263">-0.124045510064504</paragraph> + </tablecell> + <tablecell> + <paragraph role="paragraph" localize="false" id="par_id501561818979823">0</paragraph> + </tablecell> + <tablecell> + </tablecell> + <tablecell> + <paragraph role="paragraph" localize="false" id="par_id471561818985572">-1.07572227365276</paragraph> + </tablecell> + <tablecell> + <paragraph role="paragraph" localize="false" id="par_id331561818991587">-0.921557968003809</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph role="paragraph" localize="false" id="par_id861561819001577">-0.513553513012611</paragraph> + </tablecell> + <tablecell> + <paragraph role="paragraph" localize="false" id="par_id511561819007803">0</paragraph> + </tablecell> + <tablecell> + </tablecell> + <tablecell> + <paragraph role="paragraph" localize="false" id="par_id851561819018109">-0.0557824179238028</paragraph> + </tablecell> + <tablecell> + <paragraph role="paragraph" localize="false" id="par_id1001561819024945">-1.81336029451831</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph role="paragraph" localize="false" id="par_id201561819246213">-0.613559196487517</paragraph> + </tablecell> + <tablecell> + <paragraph role="paragraph" localize="false" id="par_id651561819250743">0</paragraph> + </tablecell> + <tablecell> + </tablecell> + <tablecell> + <paragraph role="paragraph" localize="false" id="par_id71561819260676">-0.577666040004067</paragraph> + </tablecell> + <tablecell> + <paragraph role="paragraph" localize="false" id="par_id551561819266277">1.38887243891951</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph role="paragraph" localize="false" id="par_id431561819277248">0.32607259491689</paragraph> + </tablecell> + <tablecell> + <paragraph role="paragraph" localize="false" id="par_id791561819282068">0</paragraph> + </tablecell> + <tablecell> + </tablecell> + <tablecell> + <paragraph role="paragraph" localize="false" id="par_id621561819290524">-0.826878282157686</paragraph> + </tablecell> + <tablecell> + <paragraph role="paragraph" localize="false" id="par_id981561819297732">-0.186591000796403</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph role="paragraph" localize="false" id="par_id261561819306914">0.0316297814625926</paragraph> + </tablecell> + <tablecell> + <paragraph role="paragraph" localize="false" id="par_id251561819311860">0</paragraph> + </tablecell> + <tablecell> + </tablecell> + <tablecell> + <paragraph role="paragraph" localize="false" id="par_id391561819316479">-0.826878282157715</paragraph> + </tablecell> + <tablecell> + <paragraph role="paragraph" localize="false" id="par_id961561819322645">0.186591000796416</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph role="paragraph" localize="false" id="par_id731561819333339">0.52298725899815</paragraph> + </tablecell> + <tablecell> + <paragraph role="paragraph" localize="false" id="par_id941561819339393">0</paragraph> + </tablecell> + <tablecell> + </tablecell> + <tablecell> + <paragraph role="paragraph" localize="false" id="par_id121561819344871">-0.577666040004051</paragraph> + </tablecell> + <tablecell> + <paragraph role="paragraph" localize="false" id="par_id971561819349810">-1.38887243891954</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph role="paragraph" id="par_id731561819392346" localize="false">0.436798031445888</paragraph> + </tablecell> + <tablecell> + <paragraph role="paragraph" id="par_id561561819399250" localize="false">0</paragraph> + </tablecell> + <tablecell> + </tablecell> + <tablecell> + <paragraph role="paragraph" id="par_id61561819405840" localize="false">-0.0557824179237846</paragraph> + </tablecell> + <tablecell> + <paragraph role="paragraph" id="par_id191561819410154" localize="false">1.81336029451832</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph role="paragraph" id="par_id71561819420534" localize="false">0.846212627320418</paragraph> + </tablecell> + <tablecell> + <paragraph role="paragraph" id="par_id461561819426024" localize="false">0</paragraph> + </tablecell> + <tablecell> + </tablecell> + <tablecell> + <paragraph role="paragraph" id="par_id21561819430293" localize="false">-1.07572227365276</paragraph> + </tablecell> + <tablecell> + <paragraph role="paragraph" id="par_id511561819434519" localize="false">0.921557968003802</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph role="paragraph" id="par_id291561819447556" localize="false">0.913061096906024</paragraph> + </tablecell> + <tablecell> + <paragraph role="paragraph" id="par_id521561819452047" localize="false">0</paragraph> + </tablecell> + <tablecell> + </tablecell> + <tablecell> + <paragraph role="paragraph" id="par_id91561819456321" localize="false">1.57930628561187</paragraph> + </tablecell> + <tablecell> + <paragraph role="paragraph" id="par_id301561819461753" localize="false">1.33862736591678</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph role="paragraph" id="par_id521561819471243" localize="false">1.2666287534781</paragraph> + </tablecell> + <tablecell> + <paragraph role="paragraph" id="par_id921561819476877" localize="false">0</paragraph> + </tablecell> + <tablecell> + </tablecell> + <tablecell> + <paragraph role="paragraph" id="par_id861561819481609" localize="false">1.3024507829017</paragraph> + </tablecell> + <tablecell> + <paragraph role="paragraph" id="par_id281561819486147" localize="false">-1.45443785733125</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph role="paragraph" id="par_id851561819501489" localize="false">1.6653650481107</paragraph> + </tablecell> + <tablecell> + <paragraph role="paragraph" id="par_id301561819506930" localize="false">0</paragraph> + </tablecell> + <tablecell> + </tablecell> + <tablecell> + <paragraph role="paragraph" id="par_id701561819513459" localize="false">-1.61522859107176</paragraph> + </tablecell> + <tablecell> + <paragraph role="paragraph" id="par_id831561819519487" localize="false">2.416826572849</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph role="paragraph" id="par_id681561819528152" localize="false">1.36582636202864</paragraph> + </tablecell> + <tablecell> + <paragraph role="paragraph" id="par_id91561819533149" localize="false">0</paragraph> + </tablecell> + <tablecell> + </tablecell> + <tablecell> + <paragraph role="paragraph" id="par_id361561819538204" localize="false">2.22685996425191</paragraph> + </tablecell> + <tablecell> + <paragraph role="paragraph" id="par_id981561819543324" localize="false">2.43092236748304</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph role="paragraph" id="par_id571561819553521" localize="false">1.46722190894756</paragraph> + </tablecell> + <tablecell> + <paragraph role="paragraph" id="par_id931561819558299" localize="false">0</paragraph> + </tablecell> + <tablecell> + </tablecell> + <tablecell> + <paragraph role="paragraph" id="par_id681561819565335" localize="false">0.545106616940365</paragraph> + </tablecell> + <tablecell> + <paragraph role="paragraph" id="par_id861561819569932" localize="false">-0.411028927740441</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph role="paragraph" id="par_id491561819657054" localize="false">0.66120489728397</paragraph> + </tablecell> + <tablecell> + <paragraph role="paragraph" id="par_id641561819661633" localize="false">0</paragraph> + </tablecell> + <tablecell> + </tablecell> + <tablecell> + <paragraph role="paragraph" id="par_id911561819665799" localize="false">0.450563708411458</paragraph> + </tablecell> + <tablecell> + <paragraph role="paragraph" id="par_id641561819670302" localize="false">-0.229112487926344</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph role="paragraph" id="par_id411561819678799" localize="false">0.701534531762234</paragraph> + </tablecell> + <tablecell> + <paragraph role="paragraph" id="par_id821561819683412" localize="false">0</paragraph> + </tablecell> + <tablecell> + </tablecell> + <tablecell> + <paragraph role="paragraph" id="par_id271561819689747" localize="false">1.53324585059292</paragraph> + </tablecell> + <tablecell> + <paragraph role="paragraph" id="par_id151561819694309" localize="false">-0.678159168870965</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph role="paragraph" id="par_id571561819705483" localize="false">0.65869368245062</paragraph> + </tablecell> + <tablecell> + <paragraph role="paragraph" id="par_id231561819709872" localize="false">0</paragraph> + </tablecell> + <tablecell> + </tablecell> + <tablecell> + <paragraph role="paragraph" id="par_id71561819715948" localize="false">0.872235792989797</paragraph> + </tablecell> + <tablecell> + <paragraph role="paragraph" id="par_id551561819721648" localize="false">1.14394086206799</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph role="paragraph" id="par_id211561819731261" localize="false">0.287522455580069</paragraph> + </tablecell> + <tablecell> + <paragraph role="paragraph" id="par_id861561819735297" localize="false">0</paragraph> + </tablecell> + <tablecell> + </tablecell> + <tablecell> + <paragraph role="paragraph" id="par_id281561819740362" localize="false">-1.49410383304834</paragraph> + </tablecell> + <tablecell> + <paragraph role="paragraph" id="par_id821561819745383" localize="false">2.39148041275001</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph role="paragraph" id="par_id241561819755044" localize="false">-0.409911360506096</paragraph> + </tablecell> + <tablecell> + <paragraph role="paragraph" id="par_id401561819759465" localize="false">0</paragraph> + </tablecell> + <tablecell> + </tablecell> + <tablecell> + <paragraph role="paragraph" id="par_id161561819764609" localize="false">0.395847917447327</paragraph> + </tablecell> + <tablecell> + <paragraph role="paragraph" id="par_id821561819768996" localize="false">2.41926785527626</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph role="paragraph" id="par_id981561819778078" localize="false">-0.583168875679498</paragraph> + </tablecell> + <tablecell> + <paragraph role="paragraph" id="par_id1001561819781923" localize="false">0</paragraph> + </tablecell> + <tablecell> + </tablecell> + <tablecell> + <paragraph role="paragraph" id="par_id471561819786217" localize="false">-1.60544735660102</paragraph> + </tablecell> + <tablecell> + <paragraph role="paragraph" id="par_id671561819789866" localize="false">5.08653060378972</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph role="paragraph" id="par_id21561819799738" localize="false">-0.799684083650078</paragraph> + </tablecell> + <tablecell> + <paragraph role="paragraph" id="par_id851561819803994" localize="false">0</paragraph> + </tablecell> + <tablecell> + </tablecell> + <tablecell> + <paragraph role="paragraph" id="par_id671561819808109" localize="false">-6.80271615433379</paragraph> + </tablecell> + <tablecell> + <paragraph role="paragraph" id="par_id631561819812163" localize="false">15.1345439297575</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph role="paragraph" id="par_id961561819820866" localize="false">-0.621417306845244</paragraph> + </tablecell> + <tablecell> + <paragraph role="paragraph" id="par_id361561819824853" localize="false">0</paragraph> + </tablecell> + <tablecell> + </tablecell> + <tablecell> + <paragraph role="paragraph" id="par_id811561819835495" localize="false">3.42886879535907</paragraph> + </tablecell> + <tablecell> + <paragraph role="paragraph" id="par_id451561819841409" localize="false">-2.37164790000194</paragraph> + </tablecell> + </tablerow> + </table> + </section> + </body> + +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/statistics.xhp b/helpcontent2/source/text/scalc/01/statistics.xhp new file mode 100644 index 000000000..a81feab1b --- /dev/null +++ b/helpcontent2/source/text/scalc/01/statistics.xhp @@ -0,0 +1,49 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . + --> + +<meta> +<topic id="statisticsmenu" indexer="include" status="PUBLISH"> +<title xml-lang="en-US" id="tit">Data Statistics in Calc</title> +<filename>/text/scalc/01/statistics.xhp</filename> +</topic> +</meta> +<body> + +<section id="analysistoolpack"> +<h1 id="hd_id1000010"><link href="text/scalc/01/statistics.xhp" name="Data Statistics in Calc">Statistics</link></h1> +<paragraph id="par_id1000010" role="paragraph" xml-lang="en-US">Use the data statistics in Calc to perform complex data analysis</paragraph> +</section> + +<paragraph id="par_id1000020" role="paragraph" xml-lang="en-US">To work on a complex statistical or engineering analysis, you can save steps and time by using Calc Data Statistics. You provide the data and parameters for each analysis, and the set of tools uses the appropriate statistical or engineering functions to calculate and display the results in an output table.</paragraph> +<embed href="text/scalc/01/statistics_sampling.xhp#datasampling"/> +<embed href="text/scalc/01/statistics_descriptive.xhp#descriptivestatistics"/> +<embed href="text/scalc/01/statistics_anova.xhp#anova"/> +<embed href="text/scalc/01/statistics_correlation.xhp#correlation"/> +<embed href="text/scalc/01/statistics_covariance.xhp#covariance"/> +<embed href="text/scalc/01/statistics_exposmooth.xhp#exponentialsmoothing"/> +<embed href="text/scalc/01/statistics_movingavg.xhp#movingaverage"/> +<embed href="text/scalc/01/statistics_regression.xhp#regression"/> +<embed href="text/scalc/01/statistics_test_t.xhp#ttest"/> +<embed href="text/scalc/01/statistics_test_f.xhp#ftest"/> +<embed href="text/scalc/01/statistics_test_z.xhp#ztest"/> +<embed href="text/scalc/01/statistics_test_chisqr.xhp#chisqtest"/> +<embed href="text/scalc/01/statistics_fourier.xhp#fourieranalysis"/> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/statistics_anova.xhp b/helpcontent2/source/text/scalc/01/statistics_anova.xhp new file mode 100644 index 000000000..8aed3da8b --- /dev/null +++ b/helpcontent2/source/text/scalc/01/statistics_anova.xhp @@ -0,0 +1,271 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + --> + +<meta> +<topic id="anovatopic" indexer="include" status="PUBLISH"> +<title xml-lang="en-US" id="tit">ANOVA</title> +<filename>/text/scalc/01/statistics_anova.xhp</filename> +</topic> +</meta> +<body> +<bookmark xml-lang="en-US" branch="index" id="bm_id02001"> +<bookmark_value>Analysis toolpack;analysis of variance</bookmark_value> +<bookmark_value>Analysis toolpack;ANOVA</bookmark_value> +<bookmark_value>analysis of variance;Analysis toolpack</bookmark_value> +<bookmark_value>ANOVA;Analysis toolpack</bookmark_value> +<bookmark_value>Data statistics;analysis of variance</bookmark_value> +<bookmark_value>Data statistics;ANOVA</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/analysisofvariancedialog/AnalysisOfVarianceDialog" id="bm_id02002" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/analysisofvariancedialog/@@nowidget@@" id="bm_id02002" localize="false"/> +<section id="anova"> +<h1 id="hd_id1000060"><variable id="anovah1"><link href="text/scalc/01/statistics_anova.xhp" name="Analysis of Variance (ANOVA)">Analysis of Variance (ANOVA)</link></variable></h1> +<paragraph id="par_id1001240" role="paragraph" xml-lang="en-US"><ahelp hid="modules/scalc/ui/analysisofvariancedialog/AnalysisOfVarianceDialog">Produces the analysis of variance (ANOVA) of a given data set</ahelp></paragraph> + </section> +<section id="howtoget"> +<paragraph id="par_id1001250" role="paragraph" xml-lang="en-US"><variable id="sam01">Choose <menuitem>Data - Statistics - Analysis of Variance (ANOVA)</menuitem></variable></paragraph> +</section> +<paragraph id="par_id1001260" role="paragraph" xml-lang="en-US">ANOVA is the acronym for <emph>AN</emph>alysis <emph>O</emph>f <emph>VA</emph>riance. This tool produces the analysis of variance of a given data set</paragraph> +<note id="par_id1001270">For more information on ANOVA, refer to the <link href="https://en.wikipedia.org/wiki/ANOVA" name="English Wikipedia: ANOVA">corresponding Wikipedia article</link>.</note> +<embed href="text/scalc/01/stat_data.xhp#data"/> +<embed href="text/scalc/01/stat_data.xhp#grouped"/> +<h2 id="hd_id1000070">Type</h2> +<paragraph id="par_id1001280" role="paragraph" xml-lang="en-US">Select if the analysis is for a <emph>single factor</emph> or for <emph>two factor</emph> ANOVA.</paragraph> +<h2 id="hd_id1000080">Parameters</h2> +<paragraph id="par_id1001290" role="paragraph" xml-lang="en-US"><emph>Alpha</emph>: the level of significance of the test.</paragraph> +<paragraph id="par_id1001300" role="paragraph" xml-lang="en-US"><emph>Rows per sample</emph>: Define how many rows a sample has.</paragraph> + +<embed href="text/scalc/01/stat_data.xhp#sampledata01"/> + +<paragraph id="par_id1001310" role="paragraph" xml-lang="en-US">The following table displays the results of the <emph>analysis of variance (ANOVA)</emph> of the sample data above.</paragraph> +<table id="Tabela5"> +<tablerow> +<tablecell> +<paragraph id="par_id1001320" role="tablehead" xml-lang="en-US">ANOVA - Single Factor</paragraph> +</tablecell> +<tablecell> +</tablecell> +<tablecell> +</tablecell> +<tablecell> +</tablecell> +<tablecell> +</tablecell> +<tablecell> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph id="par_id1001330" role="tablecontent" xml-lang="en-US">Alpha</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1001340" role="tablecontent" xml-lang="en-US" localize="false">0.05</paragraph> +</tablecell> +<tablecell> +</tablecell> +<tablecell> +</tablecell> +<tablecell> +</tablecell> +<tablecell> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +</tablecell> +<tablecell> +</tablecell> +<tablecell> +</tablecell> +<tablecell> +</tablecell> +<tablecell> +</tablecell> +<tablecell> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph id="par_id1001350" role="tablecontent" xml-lang="en-US">Groups</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1001360" role="tablecontent" xml-lang="en-US">Count</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1001370" role="tablecontent" xml-lang="en-US">Sum</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1001380" role="tablecontent" xml-lang="en-US">Mean</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1001390" role="tablecontent" xml-lang="en-US">Variance</paragraph> +</tablecell> +<tablecell> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph id="par_id1001400" role="tablecontent" xml-lang="en-US">Column 1</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1001410" role="tablecontent" xml-lang="en-US" localize="false">11</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1001420" role="tablecontent" xml-lang="en-US" localize="false">461</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1001430" role="tablecontent" xml-lang="en-US" localize="false">41.9090909091</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1001440" role="tablecontent" xml-lang="en-US" localize="false">139.4909090909</paragraph> +</tablecell> +<tablecell> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph id="par_id1001450" role="tablecontent" xml-lang="en-US">Column 2</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1001460" role="tablecontent" xml-lang="en-US" localize="false">10</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1001470" role="tablecontent" xml-lang="en-US" localize="false">597</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1001480" role="tablecontent" xml-lang="en-US" localize="false">59.7</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1001490" role="tablecontent" xml-lang="en-US" localize="false">287.1222222222</paragraph> +</tablecell> +<tablecell> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph id="par_id1001500" role="tablecontent" xml-lang="en-US">Column 3</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1001510" role="tablecontent" xml-lang="en-US" localize="false">10</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1001520" role="tablecontent" xml-lang="en-US" localize="false">447</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1001530" role="tablecontent" xml-lang="en-US" localize="false">44.7</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1001540" role="tablecontent" xml-lang="en-US" localize="false">227.3444444444</paragraph> +</tablecell> +<tablecell> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +</tablecell> +<tablecell> +</tablecell> +<tablecell> +</tablecell> +<tablecell> +</tablecell> +<tablecell> +</tablecell> +<tablecell> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph id="par_id1001550" role="tablecontent" xml-lang="en-US">Source of Variation</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1001560" role="tablecontent" xml-lang="en-US">SS</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1001570" role="tablecontent" xml-lang="en-US">df</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1001580" role="tablecontent" xml-lang="en-US">MS</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1001590" role="tablecontent" xml-lang="en-US">F</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1001600" role="tablecontent" xml-lang="en-US">P-value</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id841554943563747" role="paragraph" xml-lang="en-US">F-critical</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph id="par_id1001610" role="tablecontent" xml-lang="en-US">Between Groups</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1001620" role="tablecontent" xml-lang="en-US" localize="false">1876.5683284457</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1001630" role="tablecontent" xml-lang="en-US" localize="false">2</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1001640" role="tablecontent" xml-lang="en-US" localize="false">938.2841642229</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1001650" role="tablecontent" xml-lang="en-US" localize="false">4.3604117704</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1001660" role="tablecontent" xml-lang="en-US" localize="false">0.0224614952</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id411554944014360" role="paragraph" xml-lang="en-US" localize="false">3.340385558</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph id="par_id1001670" role="tablecontent" xml-lang="en-US">Within Groups</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1001680" role="tablecontent" xml-lang="en-US" localize="false">6025.1090909091</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1001690" role="tablecontent" xml-lang="en-US" localize="false">28</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1001700" role="tablecontent" xml-lang="en-US" localize="false">215.1824675325</paragraph> +</tablecell> +<tablecell> +</tablecell> +<tablecell> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph id="par_id1001710" role="tablecontent" xml-lang="en-US">Total</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1001720" role="tablecontent" xml-lang="en-US" localize="false">7901.6774193548</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1001730" role="tablecontent" xml-lang="en-US" localize="false">30</paragraph> +</tablecell> +<tablecell> +</tablecell> +<tablecell> +</tablecell> +<tablecell> +</tablecell> +</tablerow> +</table> +<section id="relatedtopics"> +<embed href="text/scalc/01/stat_data.xhp#otherstat"/> +</section> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/statistics_correlation.xhp b/helpcontent2/source/text/scalc/01/statistics_correlation.xhp new file mode 100644 index 000000000..43b1b5d5d --- /dev/null +++ b/helpcontent2/source/text/scalc/01/statistics_correlation.xhp @@ -0,0 +1,101 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + --> + +<meta> +<topic id="ID" indexer="include" status="PUBLISH"> +<title xml-lang="en-US" id="tit">Data Correlation in Calc</title> +<filename>/text/scalc/01/statistics_correlation.xhp</filename> +</topic> +</meta> +<body> + +<bookmark xml-lang="en-US" branch="index" id="bm_id1464278"> +<bookmark_value>Analysis toolpack;correlation</bookmark_value> +<bookmark_value>correlation;Analysis toolpack</bookmark_value> +<bookmark_value>Data statistics;correlation</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/correlationdialog/CorrelationDialog" id="bm_id3145673" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/correlationdialog/@@nowidget@@" id="bm_id3145673" localize="false"/> +<section id="correlation"> +<h1 id="hd_id1000090"><variable id="correlationh1"><link href="text/scalc/01/statistics_correlation.xhp" name="Correlation">Correlation</link></variable></h1> +<paragraph id="par_id1001740" role="paragraph" xml-lang="en-US"><ahelp hid="modules/scalc/ui/correlationdialog/CorrelationDialog">Calculates the correlation of two sets of numeric data.</ahelp></paragraph> +</section> +<section id="howtoget"> +<paragraph id="par_id1001750" role="paragraph" xml-lang="en-US"><variable id="corr01">Choose <menuitem>Data - Statistics - Correlation</menuitem></variable></paragraph> +</section> +<paragraph id="par_id1001760" role="paragraph" xml-lang="en-US">The correlation coefficient (a value between -1 and +1) means how strongly two variables are related to each other. You can use the CORREL function or the Data Statistics to find the correlation coefficient between two variables.</paragraph> +<paragraph id="par_id1001770" role="paragraph" xml-lang="en-US">A correlation coefficient of +1 indicates a perfect positive correlation. </paragraph> +<paragraph id="par_id1001780" role="paragraph" xml-lang="en-US">A correlation coefficient of -1 indicates a perfect negative correlation</paragraph> +<note id="par_id1001790">For more information on statistical correlation, refer to the <link href="https://en.wikipedia.org/wiki/Correlation" name="English Wikipedia: Correlation">corresponding Wikipedia article</link>.</note> +<embed href="text/scalc/01/stat_data.xhp#data"/> +<embed href="text/scalc/01/stat_data.xhp#grouped"/> +<embed href="text/scalc/01/stat_data.xhp#sampledata01"/> +<paragraph id="par_id1001800" role="paragraph" xml-lang="en-US">The following table displays the results of the correlation of the sample data above.</paragraph> +<table id="Tabela6"> +<tablerow> +<tablecell> +<paragraph id="par_id1001810" role="tablehead" xml-lang="en-US">Correlations</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1001820" role="tablehead" xml-lang="en-US">Column 1</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1001830" role="tablehead" xml-lang="en-US">Column 2</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1001840" role="tablehead" xml-lang="en-US">Column 3</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph id="par_id1001850" role="tablehead" xml-lang="en-US">Column 1</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1001860" role="tablecontent" xml-lang="en-US" localize="false">1</paragraph> +</tablecell> +<tablecell> +</tablecell> +<tablecell> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph id="par_id1001870" role="tablehead" xml-lang="en-US">Column 2</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1001880" role="tablecontent" xml-lang="en-US" localize="false">-0.4029254917</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1001890" role="tablecontent" xml-lang="en-US" localize="false">1</paragraph> +</tablecell> +<tablecell> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph id="par_id1001900" role="tablehead" xml-lang="en-US">Column 3</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1001910" role="tablecontent" xml-lang="en-US" localize="false">-0.2107642836</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1001920" role="tablecontent" xml-lang="en-US" localize="false">0.2309714048</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1001930" role="tablecontent" xml-lang="en-US" localize="false">1</paragraph> +</tablecell> +</tablerow> +</table> +<section id="relatedtopics"> +<embed href="text/scalc/01/stat_data.xhp#otherstat"/> +</section> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/statistics_covariance.xhp b/helpcontent2/source/text/scalc/01/statistics_covariance.xhp new file mode 100644 index 000000000..b2b4d1d96 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/statistics_covariance.xhp @@ -0,0 +1,97 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + --> + +<meta> +<topic id="ID" indexer="include" status="PUBLISH"> +<title xml-lang="en-US" id="tit">Data Covariance in Calc</title> +<filename>/text/scalc/01/statistics_covariance.xhp</filename> +</topic> +</meta> +<body> +<bookmark xml-lang="en-US" branch="index" id="bm_id2964278"> +<bookmark_value>Analysis toolpack;covariance</bookmark_value> +<bookmark_value>covariance;Analysis toolpack</bookmark_value> +<bookmark_value>Data statistics;covariance</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/covariancedialog/CovarianceDialog" id="bm_id2945673" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/covariancedialog/@@nowidget@@" id="bm_id2945673" localize="false"/> +<section id="covariance"> + <h1 id="hd_id1000100"><variable id="covarianceh1"><link href="text/scalc/01/statistics_covariance.xhp" name="Covariance">Covariance</link></variable></h1> +<paragraph id="par_id1001940" role="paragraph" xml-lang="en-US"><ahelp hid="modules/scalc/ui/covariancedialog/CovarianceDialog">Calculates the covariance of two sets of numeric data.</ahelp></paragraph> +</section> +<section id="howtoget"> +<paragraph id="par_id1001950" role="paragraph" xml-lang="en-US"><variable id="cov01">Choose <menuitem>Data - Statistics - Covariance</menuitem></variable></paragraph> +</section> +<paragraph id="par_id1001960" role="paragraph" xml-lang="en-US">The covariance is a measure of how much two random variables change together.</paragraph> +<note id="par_id1001970">For more information on statistical covariance, refer to the <link href="https://en.wikipedia.org/wiki/Covariance" name="English Wikipedia: Covariance">corresponding Wikipedia article</link>.</note> +<embed href="text/scalc/01/stat_data.xhp#data"/> +<embed href="text/scalc/01/stat_data.xhp#grouped"/><embed href="text/scalc/01/stat_data.xhp#sampledata01"/> +<paragraph id="par_id1001980" role="paragraph" xml-lang="en-US">The following table displays the results of the covariance of the sample data above.</paragraph> +<table id="Tabela7"> +<tablerow> +<tablecell> +<paragraph id="par_id1001990" role="tablehead" xml-lang="en-US">Covariances</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1002000" role="tablehead" xml-lang="en-US">Column 1</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1002010" role="tablehead" xml-lang="en-US">Column 2</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1002020" role="tablehead" xml-lang="en-US">Column 3</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph id="par_id1002030" role="tablehead" xml-lang="en-US">Column 1</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1002040" role="tablecontent" xml-lang="en-US" localize="false">126.8099173554</paragraph> +</tablecell> +<tablecell> +</tablecell> +<tablecell> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph id="par_id1002050" role="tablehead" xml-lang="en-US">Column 2</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1002060" role="tablecontent" xml-lang="en-US" localize="false">-61.4444444444</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1002070" role="tablecontent" xml-lang="en-US" localize="false">258.41</paragraph> +</tablecell> +<tablecell> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph id="par_id1002080" role="tablehead" xml-lang="en-US">Column 3</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1002090" role="tablecontent" xml-lang="en-US" localize="false">-32</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1002100" role="tablecontent" xml-lang="en-US" localize="false">53.11</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1002110" role="tablecontent" xml-lang="en-US" localize="false">204.61</paragraph> +</tablecell> +</tablerow> +</table> +<section id="relatedtopics"> +<embed href="text/scalc/01/stat_data.xhp#otherstat"/> +</section> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/statistics_descriptive.xhp b/helpcontent2/source/text/scalc/01/statistics_descriptive.xhp new file mode 100644 index 000000000..d05d34e16 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/statistics_descriptive.xhp @@ -0,0 +1,240 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. +--> + +<meta> +<topic id="ID" indexer="include" status="PUBLISH"> +<title xml-lang="en-US" id="tit">Descriptive Statistics in Calc</title> +<filename>/text/scalc/01/statistics_descriptive.xhp</filename> +</topic> +</meta> +<body> + +<bookmark xml-lang="en-US" branch="index" id="bm_id01001"> +<bookmark_value>Analysis toolpack;descriptive statistics</bookmark_value> +<bookmark_value>descriptive statistics;Analysis toolpack</bookmark_value> +<bookmark_value>Data statistics;descriptive statistics</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/descriptivestatisticsdialog/DescriptiveStatisticsDialog" id="bm_id01002" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/descriptivestatisticsdialog/@@nowidget@@" id="bm_id01002" localize="false"/> +<section id="descriptivestatistics"> + <h1 id="hd_id1000050"><variable id="descriptivestatisticsh1"><link href="text/scalc/01/statistics_descriptive.xhp" name="Descriptive Statistics">Descriptive Statistics</link></variable></h1> +<paragraph id="par_id1000640" role="paragraph" xml-lang="en-US"><ahelp hid="modules/scalc/ui/descriptivestatisticsdialog/DescriptiveStatisticsDialog">Fill a table in the spreadsheet with the main statistical properties of the data set.</ahelp></paragraph> +</section> +<section id="howtoget"> +<paragraph id="par_id1000650" role="paragraph" xml-lang="en-US"><variable id="sam01">Choose <menuitem>Data - Statistics - Descriptive Statistics</menuitem></variable></paragraph> +</section> +<paragraph id="par_id1000660" role="paragraph" xml-lang="en-US">The Descriptive Statistics analysis tool generates a report of univariate statistics for data in the input range, providing information about the central tendency and variability of your data.</paragraph> +<note id="par_id1000670">For more information on descriptive statistics, refer to the <link href="https://en.wikipedia.org/wiki/Descriptive_statistics" name="English Wikipedia: Descriptive statistics">corresponding Wikipedia article</link>.</note> +<embed href="text/scalc/01/stat_data.xhp#data"/> +<embed href="text/scalc/01/stat_data.xhp#grouped"/> +<embed href="text/scalc/01/stat_data.xhp#sampledata01"/> +<paragraph id="par_id1000680" role="paragraph" xml-lang="en-US">The following table displays the results of the descriptive statistics of the sample data above.</paragraph> +<table id="Tabela4"> +<tablerow> +<tablecell> +</tablecell> +<tablecell> +<paragraph id="par_id1000690" role="tablehead" xml-lang="en-US">Maths</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1000700" role="tablehead" xml-lang="en-US">Physics</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1000710" role="tablehead" xml-lang="en-US">Biology</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph id="par_id1000720" role="tablehead" xml-lang="en-US">Mean</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1000730" role="tablecontent" xml-lang="en-US" localize="false">41.9090909091</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1000740" role="tablecontent" xml-lang="en-US" localize="false">59.7</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1000750" role="tablecontent" xml-lang="en-US" localize="false">44.7</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph id="par_id1000760" role="tablehead" xml-lang="en-US">Standard Error</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1000770" role="tablecontent" xml-lang="en-US" localize="false">3.5610380138</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1000780" role="tablecontent" xml-lang="en-US" localize="false">5.3583786934</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1000790" role="tablecontent" xml-lang="en-US" localize="false">4.7680650629</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph id="par_id1000800" role="tablehead" xml-lang="en-US">Mode</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1000810" role="tablecontent" xml-lang="en-US" localize="false">47</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1000820" role="tablecontent" xml-lang="en-US" localize="false">49</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1000830" role="tablecontent" xml-lang="en-US" localize="false">60</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph id="par_id1000840" role="tablehead" xml-lang="en-US">Median</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1000850" role="tablecontent" xml-lang="en-US" localize="false">40</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1000860" role="tablecontent" xml-lang="en-US" localize="false">64.5</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1000870" role="tablecontent" xml-lang="en-US" localize="false">43.5</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph id="par_id1000880" role="tablehead" xml-lang="en-US">Variance</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1000890" role="tablecontent" xml-lang="en-US" localize="false">139.4909090909</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1000900" role="tablecontent" xml-lang="en-US" localize="false">287.1222222222</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1000910" role="tablecontent" xml-lang="en-US" localize="false">227.3444444444</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph id="par_id1000920" role="tablehead" xml-lang="en-US">Standard Deviation</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1000930" role="tablecontent" xml-lang="en-US" localize="false">11.8106269559</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1000940" role="tablecontent" xml-lang="en-US" localize="false">16.944681237</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1000950" role="tablecontent" xml-lang="en-US" localize="false">15.0779456308</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph id="par_id1000960" role="tablehead" xml-lang="en-US">Kurtosis</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1000970" role="tablecontent" xml-lang="en-US" localize="false">-1.4621677981</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1000980" role="tablecontent" xml-lang="en-US" localize="false">-0.9415988746</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1000990" role="tablecontent" xml-lang="en-US" localize="false">1.418052719</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph id="par_id1001000" role="tablehead" xml-lang="en-US">Skewness</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1001010" role="tablecontent" xml-lang="en-US" localize="false">0.0152409533</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1001020" role="tablecontent" xml-lang="en-US" localize="false">-0.2226426904</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1001030" role="tablecontent" xml-lang="en-US" localize="false">-0.9766803373</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph id="par_id1001040" role="tablehead" xml-lang="en-US">Range</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1001050" role="tablecontent" xml-lang="en-US" localize="false">31</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1001060" role="tablecontent" xml-lang="en-US" localize="false">51</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1001070" role="tablecontent" xml-lang="en-US" localize="false">50</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph id="par_id1001080" role="tablehead" xml-lang="en-US">Minimum</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1001090" role="tablecontent" xml-lang="en-US" localize="false">26</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1001100" role="tablecontent" xml-lang="en-US" localize="false">33</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1001110" role="tablecontent" xml-lang="en-US" localize="false">12</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph id="par_id1001120" role="tablehead" xml-lang="en-US">Maximum</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1001130" role="tablecontent" xml-lang="en-US" localize="false">57</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1001140" role="tablecontent" xml-lang="en-US" localize="false">84</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1001150" role="tablecontent" xml-lang="en-US" localize="false">62</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph id="par_id1001160" role="tablehead" xml-lang="en-US">Sum</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1001170" role="tablecontent" xml-lang="en-US" localize="false">461</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1001180" role="tablecontent" xml-lang="en-US" localize="false">597</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1001190" role="tablecontent" xml-lang="en-US" localize="false">447</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph id="par_id1001200" role="tablehead" xml-lang="en-US">Count</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1001210" role="tablecontent" xml-lang="en-US" localize="false">11</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1001220" role="tablecontent" xml-lang="en-US" localize="false">10</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1001230" role="tablecontent" xml-lang="en-US" localize="false">10</paragraph> +</tablecell> +</tablerow> +</table> +<section id="relatedtopics"> +<embed href="text/scalc/01/stat_data.xhp#otherstat"/> +</section> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/statistics_exposmooth.xhp b/helpcontent2/source/text/scalc/01/statistics_exposmooth.xhp new file mode 100644 index 000000000..4ff6a3e1f --- /dev/null +++ b/helpcontent2/source/text/scalc/01/statistics_exposmooth.xhp @@ -0,0 +1,177 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + --> + +<meta> +<topic id="exponentialsmooth" indexer="include" status="PUBLISH"> +<title xml-lang="en-US" id="tit">Exponential Smoothing in Calc</title> +<filename>/text/scalc/01/statistics_exposmooth.xhp</filename> +</topic> +</meta> +<body> +<bookmark xml-lang="en-US" branch="index" id="bm_id03001"> +<bookmark_value>Analysis toolpack;exponential smoothing</bookmark_value> +<bookmark_value>exponential smoothing;Analysis toolpack</bookmark_value> +<bookmark_value>Data statistics;exponential smoothing</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/exponentialsmoothingdialog/ExponentialSmoothingDialog" id="bm_id03002" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/exponentialsmoothingdialog/@@nowidget@@" id="bm_id03002" localize="false"/> +<section id="exponentialsmoothing"> + <h1 id="hd_id1000110"><variable id="exponentialsmoothingh1"><link href="text/scalc/01/statistics_exposmooth.xhp" name="Exponential Smoothing">Exponential Smoothing</link></variable></h1> +<paragraph id="par_id1002120" role="paragraph" xml-lang="en-US"><ahelp hid="modules/scalc/ui/exponentialsmoothingdialog/ExponentialSmoothingDialog">Results in a smoothed data series</ahelp></paragraph> +</section> +<section id="howtoget"> +<paragraph id="par_id1002130" role="paragraph" xml-lang="en-US"><variable id="sam01">Choose <menuitem>Data - Statistics - Exponential Smoothing</menuitem></variable></paragraph> +</section> +<paragraph id="par_id1002140" role="paragraph" xml-lang="en-US">Exponential smoothing is a filtering technique that when applied to a data set, produces smoothed results. It is employed in many domains such as stock market, economics and in sampled measurements.</paragraph> +<note id="par_id1002150">For more information on exponential smoothing, refer to the <link href="https://en.wikipedia.org/wiki/Exponential_smoothing" name="English Wikipedia: Exponential smoothing">corresponding Wikipedia article</link>.</note><embed href="text/scalc/01/stat_data.xhp#data"/><embed href="text/scalc/01/stat_data.xhp#grouped"/> +<h2 id="hd_id1000120">Parameters</h2> +<paragraph id="par_id1002160" role="paragraph" xml-lang="en-US"><emph>Smoothing Factor</emph>: A parameter between 0 and 1 that represents the damping factor Alpha in the smoothing equation.</paragraph><embed href="text/scalc/01/stat_data.xhp#timeseries01"/> +<paragraph id="par_id1002170" role="paragraph" xml-lang="en-US">The resulting smoothing is below with smoothing factor as 0.5:</paragraph> +<table id="Tabela9"> +<tablerow> +<tablecell> +<paragraph id="par_id1002180" role="tablehead" xml-lang="en-US">Alpha</paragraph> +</tablecell> +<tablecell> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph id="par_id1002190" role="tablecontent" xml-lang="en-US" localize="false">0.5</paragraph> +</tablecell> +<tablecell> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph id="par_id1002200" role="tablehead" xml-lang="en-US">Column 1</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1002210" role="tablehead" xml-lang="en-US">Column 2</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph id="par_id1002220" role="tablecontent" xml-lang="en-US" localize="false">1</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1002230" role="tablecontent" xml-lang="en-US" localize="false">0</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph id="par_id1002240" role="tablecontent" xml-lang="en-US" localize="false">1</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1002250" role="tablecontent" xml-lang="en-US" localize="false">0</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph id="par_id1002260" role="tablecontent" xml-lang="en-US" localize="false">0.5</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1002270" role="tablecontent" xml-lang="en-US" localize="false">0</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph id="par_id1002280" role="tablecontent" xml-lang="en-US" localize="false">0.25</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1002290" role="tablecontent" xml-lang="en-US" localize="false">0.5</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph id="par_id1002300" role="tablecontent" xml-lang="en-US" localize="false">0.125</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1002310" role="tablecontent" xml-lang="en-US" localize="false">0.25</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph id="par_id1002320" role="tablecontent" xml-lang="en-US" localize="false">0.0625</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1002330" role="tablecontent" xml-lang="en-US" localize="false">0.125</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph id="par_id1002340" role="tablecontent" xml-lang="en-US" localize="false">0.03125</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1002350" role="tablecontent" xml-lang="en-US" localize="false">0.0625</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph id="par_id1002360" role="tablecontent" xml-lang="en-US" localize="false">0.015625</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1002370" role="tablecontent" xml-lang="en-US" localize="false">0.03125</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph id="par_id1002380" role="tablecontent" xml-lang="en-US" localize="false">0.0078125</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1002390" role="tablecontent" xml-lang="en-US" localize="false">0.015625</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph id="par_id1002400" role="tablecontent" xml-lang="en-US" localize="false">0.00390625</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1002410" role="tablecontent" xml-lang="en-US" localize="false">0.0078125</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph id="par_id1002420" role="tablecontent" xml-lang="en-US" localize="false">0.001953125</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1002430" role="tablecontent" xml-lang="en-US" localize="false">0.00390625</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph id="par_id1002440" role="tablecontent" xml-lang="en-US" localize="false">0.0009765625</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1002450" role="tablecontent" xml-lang="en-US" localize="false">0.001953125</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph id="par_id1002460" role="tablecontent" xml-lang="en-US" localize="false">0.0004882813</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1002470" role="tablecontent" xml-lang="en-US" localize="false">0.0009765625</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph id="par_id1002480" role="tablecontent" xml-lang="en-US" localize="false">0.0002441406</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1002490" role="tablecontent" xml-lang="en-US" localize="false">0.0004882813</paragraph> +</tablecell> +</tablerow> +</table> +<section id="relatedtopics"> +<embed href="text/scalc/01/stat_data.xhp#otherstat"/> +</section> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/statistics_fourier.xhp b/helpcontent2/source/text/scalc/01/statistics_fourier.xhp new file mode 100644 index 000000000..34d0b635d --- /dev/null +++ b/helpcontent2/source/text/scalc/01/statistics_fourier.xhp @@ -0,0 +1,652 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> + <!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + --> + + <meta> + <topic id="ID" indexer="include" status="PUBLISH"> + <title id="tit" xml-lang="en-US">Fourier Analysis</title> + <filename>/text/scalc/01/statistics_fourier.xhp</filename> + </topic> + </meta> + + <body> + <bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/fourieranalysisdialog/FourierAnalysisDialog" id="bm_id2345673" localize="false"/> + <bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/regressiondialog/@@nowidget@@" id="bm_id2745673" localize="false"/> + <bookmark xml-lang="en-US" branch="index" id="bm_id2764278"> +<bookmark_value>Analysis toolpack;Fourier analysis</bookmark_value> +<bookmark_value>Fourier analysis;Analysis toolpack</bookmark_value> +<bookmark_value>Data statistics;Fourier analysis</bookmark_value> + </bookmark> + + <section id="fourieranalysis"> + <h1 id="hd_id431561808831965"><variable id="fourieranalysysh1"><link href="text/scalc/01/statistics_fourier.xhp" name="Fourier analysis">Fourier Analysis</link></variable></h1> + <paragraph id="par_id1001240" role="paragraph" xml-lang="en-US"><ahelp hid="modules/scalc/ui/regressiondialog/RegressionDialog">Produces the Fourier analysis of a data set by computing the Discrete Fourier Transform (DFT) of an input array of complex numbers using a couple of Fast Fourier Transform (FFT) algorithms.</ahelp></paragraph> +</section> + <section id="howtoget"> + <paragraph id="par_id1000040" role="paragraph" xml-lang="en-US"><variable id="sam01">Choose <menuitem>Data - Statistics - Fourier Analysis</menuitem></variable></paragraph> + </section> + <note id="par_id1001270">For more information on Fourier analysis, refer to the <link href="https://en.wikipedia.org/wiki/Fourier_analysis" name="English Wikipedia: Fourier analysis">corresponding Wikipedia article</link>.</note> + + <embed href="text/scalc/01/stat_data.xhp#data"/> + <paragraph role="paragraph" id="par_id301561811172762"><emph>Input range has label</emph>: Mark when the first row or column of the input array is actually a label and not part of the data analysis.</paragraph> + <paragraph role="paragraph" id="par_id741556228390897">Input Range is a 2 x N or N x 2 range representing an array of complex number to be transformed, where N is the length of the array. The array represents the real and imaginary parts of the data.</paragraph> + <embed href="text/scalc/01/stat_data.xhp#grouped"/> + + <h3 id="hd_id211561811324208">Options:</h3> + <paragraph role="paragraph" id="par_id631556228516997"><emph>Inverse</emph>: When checked, calculates the inverse Discrete Fourier Transform.</paragraph> + <paragraph role="paragraph" id="par_id811561732287508"><emph>Polar</emph>: When checked, the results are in polar coordinates (magnitude, phase).</paragraph> + <paragraph role="paragraph" id="par_id661561732521977"><emph>Minimum magnitude for polar form output (in dB)</emph>: used only when output is in polar form. All frequency components with magnitude less than this value in decibels will be suppressed with a zero magnitude-phase entry. This is very useful when looking at the magnitude-phase spectrum of a signal because there is always some very tiny amount of rounding error when doing FFT algorithms and results in incorrect non-zero phase for non-existent frequencies. By providing a suitable value to this parameter, these non-existent frequency components can be suppressed.</paragraph> + + <embed href="text/scalc/06/calcsamplefiles.xhp#func_fourier"/> + <embed href="text/scalc/01/ful_func.xhp#func_head_example"/> + <paragraph role="paragraph" id="par_id731561827207828">The source data for this example is the same of the <link href="text/scalc/01/func_fourier.xhp" name="Fourier function">FOURIER function page</link>.</paragraph> + <table id="Tabela1"> + <tablerow> + <tablecell colspan="2"> + <paragraph id="par_id290620191257279817" role="tablehead">Fourier Transform</paragraph> + </tablecell> + <tablecell> + </tablecell> + <tablecell colspan="2"> + <paragraph id="par_id29062019125727379" role="tablehead">Fourier Transform</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell colspan="2"> + <paragraph id="par_id290620191257276510" role="tablecontent"><emph>Input data range : $B$6:$C$40</emph></paragraph> + </tablecell> + <tablecell> + </tablecell> + <tablecell colspan="2"> + <paragraph id="par_id290620191257273433" role="tablecontent"><emph>Input data range : $B$6:$C$40</emph></paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id290620191257273688" role="tablecontent"><emph>Real</emph></paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id290620191257276202" role="tablecontent"><emph>Imaginary</emph></paragraph> + </tablecell> + <tablecell> + </tablecell> + <tablecell> + <paragraph id="par_id481561825547527" role="tablecontent"><emph>Magnitude</emph></paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id751561825556834" role="tablecontent"><emph>Phase</emph></paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id29062019125727529" role="tablecontent" localize="false">17.1775578743134</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id290620191257277650" role="tablecontent" localize="false">3.88635177703826E-15</paragraph> + </tablecell> + <tablecell> + </tablecell> + <tablecell> + <paragraph id="par_id711561825563346" role="tablecontent" localize="false">17.1775578743134</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id901561825568423" role="tablecontent" localize="false">2.26245884628906E-16</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id290620191257274698" role="tablecontent" localize="false">3.428868795359</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id290620191257276895" role="tablecontent" localize="false">2.37164790000189</paragraph> + </tablecell> + <tablecell> + </tablecell> + <tablecell> + <paragraph id="par_id201561825580585" role="tablecontent" localize="false">4.16915518748944</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id101561825584332" role="tablecontent" localize="false">0.605113892937279</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id290620191257278831" role="tablecontent" localize="false">-6.80271615433369</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id290620191257273532" role="tablecontent" localize="false">-15.1345439297576</paragraph> + </tablecell> + <tablecell> + </tablecell> + <tablecell> + <paragraph id="par_id711561825589842" role="tablecontent" localize="false">16.5931120359682</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id81561825619703" role="tablecontent" localize="false">-1.99322000923881</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id290620191257274709" role="tablecontent" localize="false">-1.605447356601</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id290620191257276525" role="tablecontent" localize="false">-5.08653060378972</paragraph> + </tablecell> + <tablecell> + </tablecell> + <tablecell> + <paragraph id="par_id991561825625022" role="tablecontent" localize="false">5.33387802617444</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id21561825629228" role="tablecontent" localize="false">-1.87652762269615</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id290620191257272245" role="tablecontent" localize="false">0.395847917447356</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id290620191257274310" role="tablecontent" localize="false">-2.41926785527625</paragraph> + </tablecell> + <tablecell> + </tablecell> + <tablecell> + <paragraph id="par_id701561825635119" role="tablecontent" localize="false">2.45143886917874</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id831561825638615" role="tablecontent" localize="false">-1.40861048708919</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id29062019125727326" role="tablecontent" localize="false">-1.49410383304833</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id290620191257275013" role="tablecontent" localize="false">-2.39148041275</paragraph> + </tablecell> + <tablecell> + </tablecell> + <tablecell> + <paragraph id="par_id241561825641911" role="tablecontent" localize="false">2.81984482347817</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id221561825645728" role="tablecontent" localize="false">-2.12922380028329</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id290620191257277775" role="tablecontent" localize="false">0.87223579298981</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id290620191257277856" role="tablecontent" localize="false">-1.14394086206797</paragraph> + </tablecell> + <tablecell> + </tablecell> + <tablecell> + <paragraph id="par_id671561825649808" role="tablecontent" localize="false">1.43853952829993</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id321561825657817" role="tablecontent" localize="false">-0.919353665468368</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id290620191257274532" role="tablecontent" localize="false">1.5332458505929</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id290620191257279129" role="tablecontent" localize="false">0.678159168870983</paragraph> + </tablecell> + <tablecell> + </tablecell> + <tablecell> + <paragraph id="par_id681561825661535" role="tablecontent" localize="false">1.6765269746366</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id671561825665344" role="tablecontent" localize="false">0.416434654153369</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id290620191257287695" role="tablecontent" localize="false">0.450563708411459</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id290620191257286376" role="tablecontent" localize="false">0.22911248792634</paragraph> + </tablecell> + <tablecell> + </tablecell> + <tablecell> + <paragraph id="par_id511561825670030" role="tablecontent" localize="false">0.505470263676592</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id761561825674325" role="tablecontent" localize="false">0.470425948779898</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id290620191257286648" role="tablecontent" localize="false">0.545106616940358</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id290620191257285951" role="tablecontent" localize="false">0.411028927740438</paragraph> + </tablecell> + <tablecell> + </tablecell> + <tablecell> + <paragraph id="par_id91561825686459" role="tablecontent" localize="false">0.682704916689207</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id561561825689880" role="tablecontent" localize="false">0.646077879418302</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id290620191257285124" role="tablecontent" localize="false">2.22685996425193</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id290620191257286584" role="tablecontent" localize="false">-2.43092236748302</paragraph> + </tablecell> + <tablecell> + </tablecell> + <tablecell> + <paragraph id="par_id151561825697930" role="tablecontent" localize="false">3.29670879167654</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id381561825701512" role="tablecontent" localize="false">-0.829181229907427</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id290620191257286986" role="tablecontent" localize="false">-1.61522859107175</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id290620191257281114" role="tablecontent" localize="false">-2.41682657284899</paragraph> + </tablecell> + <tablecell> + </tablecell> + <tablecell> + <paragraph id="par_id891561825705846" role="tablecontent" localize="false">2.90689079338124</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id11561825709464" role="tablecontent" localize="false">-2.15994697868441</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id290620191257283083" role="tablecontent" localize="false">1.30245078290168</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id290620191257287927" role="tablecontent" localize="false">1.45443785733126</paragraph> + </tablecell> + <tablecell> + </tablecell> + <tablecell> + <paragraph id="par_id611561825715444" role="tablecontent" localize="false">1.95237484175544</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id871561825718419" role="tablecontent" localize="false">0.840472341525344</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id290620191257281022" role="tablecontent" localize="false">1.57930628561185</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id290620191257288920" role="tablecontent" localize="false">-1.33862736591677</paragraph> + </tablecell> + <tablecell> + </tablecell> + <tablecell> + <paragraph id="par_id171561825722999" role="tablecontent" localize="false">2.07029745895472</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id381561825726528" role="tablecontent" localize="false">-0.70310180067089</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id29062019125728198" role="tablecontent" localize="false">-1.07572227365276</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id290620191257281880" role="tablecontent" localize="false">-0.921557968003809</paragraph> + </tablecell> + <tablecell> + </tablecell> + <tablecell> + <paragraph id="par_id621561825733235" role="tablecontent" localize="false">1.41649126309482</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id911561825736891" role="tablecontent" localize="false">-2.43322886402899</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id290620191257286891" role="tablecontent" localize="false">-0.055782417923803</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id290620191257285354" role="tablecontent" localize="false">-1.81336029451831</paragraph> + </tablecell> + <tablecell> + </tablecell> + <tablecell> + <paragraph id="par_id71561825745885" role="tablecontent" localize="false">1.81421807837012</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id341561825750480" role="tablecontent" localize="false">-1.60154853447151</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id290620191257283162" role="tablecontent" localize="false">-0.577666040004067</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id290620191257282542" role="tablecontent" localize="false">1.38887243891951</paragraph> + </tablecell> + <tablecell> + </tablecell> + <tablecell> + <paragraph id="par_id851561825755054" role="tablecontent" localize="false">1.50421564456836</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id141561825758670" role="tablecontent" localize="false">1.96495487990047</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id290620191257285160" role="tablecontent" localize="false">-0.826878282157686</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id290620191257287292" role="tablecontent" localize="false">-0.186591000796403</paragraph> + </tablecell> + <tablecell> + </tablecell> + <tablecell> + <paragraph id="par_id41561825766562" role="tablecontent" localize="false">0.847669685126376</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id721561825770334" role="tablecontent" localize="false">-2.91965280961949</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id290620191257285848" role="tablecontent" localize="false">-0.826878282157715</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id290620191257289336" role="tablecontent" localize="false">0.186591000796416</paragraph> + </tablecell> + <tablecell> + </tablecell> + <tablecell> + <paragraph id="par_id471561825776243" role="tablecontent" localize="false">0.847669685126408</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id991561825781290" role="tablecontent" localize="false">2.91965280961948</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id290620191257288490" role="tablecontent" localize="false">-0.577666040004051</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id290620191257284271" role="tablecontent" localize="false">-1.38887243891954</paragraph> + </tablecell> + <tablecell> + </tablecell> + <tablecell> + <paragraph id="par_id661561825788196" role="tablecontent" localize="false">1.50421564456838</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id321561825791887" role="tablecontent" localize="false">-1.96495487990045</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id29062019125728802" role="tablecontent" localize="false">-0.055782417923785</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id290620191257284034" role="tablecontent" localize="false">1.81336029451832</paragraph> + </tablecell> + <tablecell> + </tablecell> + <tablecell> + <paragraph id="par_id851561825796754" role="tablecontent" localize="false">1.81421807837012</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id691561825800702" role="tablecontent" localize="false">1.6015485344715</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id290620191257288282" role="tablecontent" localize="false">-1.07572227365276</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id290620191257283112" role="tablecontent" localize="false">0.921557968003802</paragraph> + </tablecell> + <tablecell> + </tablecell> + <tablecell> + <paragraph id="par_id171561825805651" role="tablecontent" localize="false">1.41649126309482</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id651561825809772" role="tablecontent" localize="false">2.433228864029</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id290620191257287702" role="tablecontent" localize="false">1.57930628561187</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id290620191257293964" role="tablecontent" localize="false">1.33862736591678</paragraph> + </tablecell> + <tablecell> + </tablecell> + <tablecell> + <paragraph id="par_id31561825813387" role="tablecontent" localize="false">2.07029745895474</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id261561825818319" role="tablecontent" localize="false">0.703101800670888</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id290620191257298813" role="tablecontent" localize="false">1.3024507829017</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id290620191257292229" role="tablecontent" localize="false">-1.45443785733125</paragraph> + </tablecell> + <tablecell> + </tablecell> + <tablecell> + <paragraph id="par_id811561825823956" role="tablecontent" localize="false">1.95237484175543</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id781561825828580" role="tablecontent" localize="false">-0.840472341525331</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id29062019125729581" role="tablecontent" localize="false">-1.61522859107176</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id290620191257299086" role="tablecontent" localize="false">2.416826572849</paragraph> + </tablecell> + <tablecell> + </tablecell> + <tablecell> + <paragraph id="par_id1001561825833977" role="tablecontent" localize="false">2.90689079338125</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id11561825837094" role="tablecontent" localize="false">2.15994697868441</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id290620191257296839" role="tablecontent" localize="false">2.22685996425191</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id290620191257292861" role="tablecontent" localize="false">2.43092236748304</paragraph> + </tablecell> + <tablecell> + </tablecell> + <tablecell> + <paragraph id="par_id791561825843164" role="tablecontent" localize="false">3.29670879167653</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id41561825846486" role="tablecontent" localize="false">0.829181229907435</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id290620191257291686" role="tablecontent" localize="false">0.545106616940365</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id290620191257299836" role="tablecontent" localize="false">-0.411028927740441</paragraph> + </tablecell> + <tablecell> + </tablecell> + <tablecell> + <paragraph id="par_id771561825852156" role="tablecontent" localize="false">0.682704916689214</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id941561825855686" role="tablecontent" localize="false">-0.646077879418299</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id290620191257292523" role="tablecontent" localize="false">0.450563708411458</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id290620191257295218" role="tablecontent" localize="false">-0.229112487926344</paragraph> + </tablecell> + <tablecell> + </tablecell> + <tablecell> + <paragraph id="par_id61561825860084" role="tablecontent" localize="false">0.505470263676594</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id741561825863994" role="tablecontent" localize="false">-0.470425948779905</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id290620191257297879" role="tablecontent" localize="false">1.53324585059292</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id290620191257293381" role="tablecontent" localize="false">-0.678159168870965</paragraph> + </tablecell> + <tablecell> + </tablecell> + <tablecell> + <paragraph id="par_id661561825873072" role="tablecontent" localize="false">1.6765269746366</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id81561825876773" role="tablecontent" localize="false">-0.416434654153355</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id29062019125729145" role="tablecontent" localize="false">0.872235792989797</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id290620191257299200" role="tablecontent" localize="false">1.14394086206799</paragraph> + </tablecell> + <tablecell> + </tablecell> + <tablecell> + <paragraph id="par_id221561825883285" role="tablecontent" localize="false">1.43853952829994</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id281561825886634" role="tablecontent" localize="false">0.919353665468386</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id290620191257298876" role="tablecontent" localize="false">-1.49410383304834</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id290620191257295073" role="tablecontent" localize="false">2.39148041275001</paragraph> + </tablecell> + <tablecell> + </tablecell> + <tablecell> + <paragraph id="par_id411561825892297" role="tablecontent" localize="false">2.81984482347818</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id631561825897202" role="tablecontent" localize="false">2.12922380028329</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id290620191257295843" role="tablecontent" localize="false">0.395847917447327</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id290620191257292406" role="tablecontent" localize="false">2.41926785527626</paragraph> + </tablecell> + <tablecell> + </tablecell> + <tablecell> + <paragraph id="par_id941561825902058" role="tablecontent" localize="false">2.45143886917875</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id101561825905350" role="tablecontent" localize="false">1.4086104870892</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id290620191257294283" role="tablecontent" localize="false">-1.60544735660102</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id290620191257293991" role="tablecontent" localize="false">5.08653060378972</paragraph> + </tablecell> + <tablecell> + </tablecell> + <tablecell> + <paragraph id="par_id811561825912635" role="tablecontent" localize="false">5.33387802617445</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id461561825916257" role="tablecontent" localize="false">1.87652762269616</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id290620191257291705" role="tablecontent" localize="false">-6.80271615433379</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id290620191257294294" role="tablecontent" localize="false">15.1345439297575</paragraph> + </tablecell> + <tablecell> + </tablecell> + <tablecell> + <paragraph id="par_id831561825920319" role="tablecontent" localize="false">16.5931120359682</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id441561825923790" role="tablecontent" localize="false">1.99322000923882</paragraph> + </tablecell> + </tablerow> + <tablerow> + <tablecell> + <paragraph id="par_id290620191257297686" role="tablecontent" localize="false">3.42886879535907</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id290620191257296150" role="tablecontent" localize="false">-2.37164790000194</paragraph> + </tablecell> + <tablecell> + </tablecell> + <tablecell> + <paragraph id="par_id151561825927729" role="tablecontent" localize="false">4.16915518748952</paragraph> + </tablecell> + <tablecell> + <paragraph id="par_id551561825934063" role="tablecontent" localize="false">-0.605113892937279</paragraph> + </tablecell> + </tablerow> + </table> +<section id="relatedtopics"> +<embed href="text/scalc/01/stat_data.xhp#otherstat"/> +</section> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/statistics_movingavg.xhp b/helpcontent2/source/text/scalc/01/statistics_movingavg.xhp new file mode 100644 index 000000000..1a9faf27e --- /dev/null +++ b/helpcontent2/source/text/scalc/01/statistics_movingavg.xhp @@ -0,0 +1,155 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + --> + +<meta> +<topic id="movingavgtopic" indexer="include" status="PUBLISH"> +<title xml-lang="en-US" id="tit">Moving Average in Calc</title> +<filename>/text/scalc/01/statistics_movingavg.xhp</filename> +</topic> +</meta> +<body> + +<bookmark xml-lang="en-US" branch="index" id="bm_id04001"> +<bookmark_value>Analysis toolpack;moving average</bookmark_value> +<bookmark_value>moving average;Analysis toolpack</bookmark_value> +<bookmark_value>Data statistics;moving average</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/movingaveragedialog/MovingAverageDialog" id="bm_id04002" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/movingaveragedialog/@@nowidget@@" id="bm_id04002" localize="false"/> +<section id="movingaverage"> +<h1 id="hd_id1000130"><variable id="movingaverageh1"><link href="text/scalc/01/statistics_movingavg.xhp" name="Moving Average">Moving Average</link></variable></h1> +<paragraph id="par_id1002500" role="paragraph" xml-lang="en-US"><ahelp hid="modules/scalc/ui/movingaveragedialog/MovingAverageDialog">Calculates the moving average of a time series</ahelp></paragraph> +</section> +<section id="howtoget"> +<paragraph id="par_id1002510" role="paragraph" xml-lang="en-US"><variable id="sam01">Choose <menuitem>Data - Statistics - Moving Average</menuitem></variable></paragraph> +</section> +<note id="par_id1002520">For more information on the moving average, refer to the <link href="https://en.wikipedia.org/wiki/Moving_average" name="English Wikipedia: Moving average">corresponding Wikipedia article</link>.</note><embed href="text/scalc/01/stat_data.xhp#data"/><embed href="text/scalc/01/stat_data.xhp#grouped"/> +<h2 id="hd_id1000140">Parameters</h2> +<paragraph id="par_id1002530" role="paragraph" xml-lang="en-US"><emph>Interval</emph>: The number of samples used in the moving average calculation.</paragraph><embed href="text/scalc/01/stat_data.xhp#timeseries01"/> +<h2 id="hd_id1000171">Results of the moving average:</h2> +<table id="Tabela10"> +<tablerow> +<tablecell> +<paragraph id="par_id1002540" role="tablehead" xml-lang="en-US">Column 1</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1002550" role="tablehead" xml-lang="en-US">Column 2</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph id="par_id1002560" role="tablecontent" xml-lang="en-US">#N/A</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1002570" role="tablecontent" xml-lang="en-US">#N/A</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph id="par_id1002580" role="tablecontent" xml-lang="en-US" localize="false">0.3333333333</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1002590" role="tablecontent" xml-lang="en-US" localize="false">0.3333333333</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph id="par_id1002600" role="tablecontent" xml-lang="en-US" localize="false">0</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1002610" role="tablecontent" xml-lang="en-US" localize="false">0.3333333333</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph id="par_id1002620" role="tablecontent" xml-lang="en-US" localize="false">0</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1002630" role="tablecontent" xml-lang="en-US" localize="false">0.3333333333</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph id="par_id1002640" role="tablecontent" xml-lang="en-US" localize="false">0</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1002650" role="tablecontent" xml-lang="en-US" localize="false">0</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph id="par_id1002660" role="tablecontent" xml-lang="en-US" localize="false">0</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1002670" role="tablecontent" xml-lang="en-US" localize="false">0</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph id="par_id1002680" role="tablecontent" xml-lang="en-US" localize="false">0</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1002690" role="tablecontent" xml-lang="en-US" localize="false">0</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph id="par_id1002700" role="tablecontent" xml-lang="en-US" localize="false">0</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1002710" role="tablecontent" xml-lang="en-US" localize="false">0</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph id="par_id1002720" role="tablecontent" xml-lang="en-US" localize="false">0</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1002730" role="tablecontent" xml-lang="en-US" localize="false">0</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph id="par_id1002740" role="tablecontent" xml-lang="en-US" localize="false">0</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1002750" role="tablecontent" xml-lang="en-US" localize="false">0</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph id="par_id1002760" role="tablecontent" xml-lang="en-US" localize="false">0</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1002770" role="tablecontent" xml-lang="en-US" localize="false">0</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph id="par_id1002780" role="tablecontent" xml-lang="en-US" localize="false">0</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1002790" role="tablecontent" xml-lang="en-US" localize="false">0</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph id="par_id1002800" role="tablecontent" xml-lang="en-US">#N/A</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1002810" role="tablecontent" xml-lang="en-US">#N/A</paragraph> +</tablecell> +</tablerow> +</table> +<section id="relatedtopics"> +<embed href="text/scalc/01/stat_data.xhp#otherstat"/> +</section> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/statistics_regression.xhp b/helpcontent2/source/text/scalc/01/statistics_regression.xhp new file mode 100644 index 000000000..165ff3e31 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/statistics_regression.xhp @@ -0,0 +1,85 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . +--> + +<meta> + <topic id="regressiontopic" indexer="include" status="PUBLISH"> + <title id="tit" xml-lang="en-US">Regression Analysis</title> + <filename>/text/scalc/01/statistics_regression.xhp</filename> + </topic> +</meta> +<body> +<bookmark xml-lang="en-US" branch="index" id="bm_id2764278"> +<bookmark_value>Analysis toolpack;regression analysis</bookmark_value> +<bookmark_value>regression analysis;Analysis toolpack</bookmark_value> +<bookmark_value>Data statistics;regression analysis</bookmark_value> +<bookmark_value>Confidence level;regression analysis</bookmark_value> +<bookmark_value>regression analysis;linear</bookmark_value> +<bookmark_value>regression analysis;power</bookmark_value> +<bookmark_value>regression analysis;logarithmic</bookmark_value> +</bookmark> + +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/regressiondialog/RegressionDialog" id="bm_id2745673" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/regressiondialog/@@nowidget@@" id="bm_id2745673" localize="false"/> +<section id="regression"> +<h1 id="hd_id1701201615033510"><variable id="regressionanalysish1"><link href="text/scalc/01/statistics_regression.xhp" name="regression analysis">Regression Analysis</link></variable></h1> +<paragraph id="par_id1001240" role="paragraph" xml-lang="en-US"><ahelp hid="modules/scalc/ui/regressiondialog/RegressionDialog">Performs linear, logarithmic, or power regression analysis of a data set comprising one dependent variable and multiple independent variables.</ahelp></paragraph> +</section> +<paragraph role="paragraph" id="par_id431629832333206">For example, a crop yield (dependent variable) may be related to rainfall, temperature conditions, sunshine, humidity, soil quality and more, all of them independent variables.</paragraph> +<section id="howtoget"> +<paragraph id="par_id1000040" role="paragraph" xml-lang="en-US"><variable id="sam01">Choose <menuitem>Data - Statistics - Regression</menuitem></variable></paragraph> +</section> +<paragraph id="par_id1001270" role="note" xml-lang="en-US">For more information on regression analysis, refer to the <link href="https://en.wikipedia.org/wiki/Regression_analysis" name="English Wikipedia: Regression analysis">corresponding Wikipedia article</link>.</paragraph> +<h2 id="hd_id891629830986496">Data</h2> +<h3 id="hd_id101629830993962">Independent variable(s) (X) range:</h3> +<paragraph role="paragraph" id="par_id961629834099308">Enter a single range that contains multiple independent variable observations (along columns or rows). All X variable observations need to be entered adjacent to each other in the same table.</paragraph> +<h3 id="hd_id871629830998653">Dependent variable (Y) range:</h3> +<paragraph role="paragraph" id="par_id391629834089370">Enter the range that contains the dependent variable whose regression is to be calculated.</paragraph> +<h3 id="hd_id931629831003368">Both X and Y ranges have labels</h3> +<paragraph role="paragraph" id="par_id261629834071776">Check to use the first line (or column) of the data sets as variable names in the output range.</paragraph> +<h3 id="hd_id11629831014811">Results to:</h3> +<paragraph role="paragraph" id="par_id441629834000533">The reference of the top left cell of the range where the results will be displayed.</paragraph> +<embed href="text/scalc/01/stat_data.xhp#grouped"/> + +<h2 id="hd_id1000070">Output Regression Types</h2> +<paragraph id="par_id1001280" role="paragraph" xml-lang="en-US">Set the regression type. Three types are available: </paragraph> + +<list type="unordered"> + <listitem> + <paragraph id="par_id1701201620334364" role="listitem" xml-lang="en-US"><emph>Linear Regression</emph>: finds a linear function in the form of y = b + a<sub>1</sub>.[x<sub>1</sub>] + a<sub>2</sub>.[x<sub>2</sub>] + a<sub>3</sub>.[x<sub>3</sub>] ..., where a<sub>i</sub> is the i-th slope, [x<sub>i</sub>] is the i-th independent variable, and b is the intercept that best fits the data.</paragraph> + </listitem> + <listitem> + <paragraph id="par_id1701201620340168" role="listitem" xml-lang="en-US"><emph>Logarithmic regression</emph>: finds a logarithmic curve in the form of y = b + a<sub>1</sub>.ln[x<sub>1</sub>] + a<sub>2</sub>.ln[x<sub>2</sub>] + a<sub>3</sub>.ln[x<sub>3</sub>] ..., where a<sub>i</sub> is the i-th coefficient, b is the intercept and ln[x<sub>i</sub>] is the natural logarithm of the i-th independent variable, that best fits the data.</paragraph> + </listitem> + <listitem> + <paragraph id="par_id1701201620340139" role="listitem" xml-lang="en-US"><emph>Power regression</emph>: finds a power curve in the form of y = exp( b + a<sub>1</sub>.ln[x<sub>1</sub>] + a<sub>2</sub>.ln[x<sub>2</sub>] + a<sub>3</sub>.ln[x<sub>3</sub>] ...), where a<sub>i</sub> is the i-th power, [x<sub>i</sub>] is the i-th independent variable, and b is intercept that best fits the data.</paragraph> + </listitem></list> + + <h2 id="hd_id331629834218606">Options</h2> + <h3 id="hd_id481629834269509">Confidence level</h3> + <paragraph role="paragraph" id="par_id971629835636129">A numeric value between 0 and 1 (exclusive), default is 0.95. Calc uses this percentage to compute the corresponding confidence intervals for each of the estimates (namely the slopes and intercept).</paragraph> + <h3 id="hd_id751629834274709">Calculate residuals</h3> + <paragraph role="paragraph" id="par_id401629835408653">Select whether to opt in or out of computing the residuals, which may be beneficial in cases where you are interested only in the slopes and intercept estimates and their statistics. The residuals give information on how far the actual data points deviate from the predicted data points, based on the regression model.</paragraph> + <h3 id="hd_id861629834279039">Force intercept to be zero</h3> + <paragraph role="paragraph" id="par_id121629837424848">Calculates the regression model using zero as the intercept, thus forcing the model to pass through the origin.</paragraph> +<section id="relatedtopics"> +<embed href="text/scalc/01/stat_data.xhp#otherstat"/> +</section> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/statistics_sampling.xhp b/helpcontent2/source/text/scalc/01/statistics_sampling.xhp new file mode 100644 index 000000000..753f70cb7 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/statistics_sampling.xhp @@ -0,0 +1,242 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + --> + +<meta> +<topic id="datasampligtopic" indexer="include" status="PUBLISH"> +<title xml-lang="en-US" id="tit">Data Sampling in Calc</title> +<filename>/text/scalc/01/statistics_sampling.xhp</filename> +</topic> +</meta> +<body> +<bookmark xml-lang="en-US" branch="index" id="bm_id2764278"> +<bookmark_value>Analysis toolpack;sampling</bookmark_value> +<bookmark_value>sampling;Analysis toolpack</bookmark_value> +<bookmark_value>Data statistics;sampling</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/samplingdialog/SamplingDialog" id="bm_id2745673" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/samplingdialog/@@nowidget@@" id="bm_id2745673" localize="false"/> +<section id="datasampling"> +<h1 id="hd_id1000020"><variable id="datasamplingh1"><link href="text/scalc/01/statistics_sampling.xhp" name="Sampling">Sampling</link></variable></h1> +<paragraph id="par_id1000030" role="paragraph" xml-lang="en-US"><ahelp hid="modules/scalc/ui/samplingdialog/SamplingDialog">Create a table with data sampled from another table.</ahelp></paragraph> +</section> +<section id="howtoget"> +<paragraph id="par_id1000040" role="paragraph" xml-lang="en-US"><variable id="sam01">Choose <menuitem>Data - Statistics - Sampling</menuitem></variable></paragraph> +</section> +<paragraph id="par_id1000050" role="paragraph" xml-lang="en-US">Sampling allows you to pick data from a <emph>source</emph> table (population) to fill a <emph>target</emph> table. The sampling can be random or in a periodic basis, as well as with or without sample replacement in the source table.</paragraph> +<note id="par_id1000060">Sampling is done row-wise. That means, the sampled data will pick the whole line of the source table and copy into a line of the target table.</note><embed href="text/scalc/01/stat_data.xhp#data"/> +<h2 id="hd_id1000030">Sampling Method</h2> +<h3 id="hd_id611623249550632">Random</h3> +<paragraph role="paragraph" id="par_id711623249563655">Picks exactly <emph>Sample Size</emph> lines of the source table in a random way.</paragraph> +<h3 id="hd_id431623249579089">Sample size</h3> +<paragraph role="paragraph" id="par_id461623249594879">Number of lines sampled from the source table. The Sample size is limited to the population size for all sampling methods without replacement.</paragraph> +<h3 id="hd_id931623249610097">With replacement</h3> +<paragraph role="paragraph" id="par_id191623249619384">When checked, put back samples in population (source table) after draw. A sample can be drawn more than once and therefore a larger sample size than population is possible. This option is mutually exclusive with <emph>Keep order</emph>. When unchecked, a sample drawn is not put back to the population and sample size is limited to population size.</paragraph> +<h3 id="hd_id791623249632175">Keep order</h3> +<paragraph role="paragraph" id="par_id741623249641180">When checked, samples are drawn in order of population data. Samples are not put back to the population (exclusive with <emph>With replacement</emph>). This option is automatically checked for <emph>Periodic</emph> sampling. When unchecked, samples are drawn in random order.</paragraph> +<h3 id="hd_id461623249656476">Periodic</h3> +<paragraph role="paragraph" id="par_id481623249667345">Picks lines in a pace defined by <emph>Period</emph>.</paragraph> +<h3 id="hd_id101623249682605">Period</h3> +<paragraph role="paragraph" id="par_id621623249692296">The number of lines to skip periodically when sampling. The <emph>Period</emph> is limited to the population size.</paragraph> +<embed href="text/scalc/01/common_func.xhp#sectionexample"/> +<paragraph id="par_id1000110" role="paragraph" xml-lang="en-US">The following data will be used as example of source data table for sampling:</paragraph> +<table id="Tabela1"> +<tablerow> +<tablecell> +</tablecell> +<tablecell> +<paragraph id="par_id1000120" role="tablehead" xml-lang="en-US" localize="false">A</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1000130" role="tablehead" xml-lang="en-US" localize="false">B</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1000140" role="tablehead" xml-lang="en-US" localize="false">C</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph id="par_id1000150" role="tablehead" xml-lang="en-US" localize="false">1</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1000160" role="tablecontent" xml-lang="en-US" localize="false">11</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1000170" role="tablecontent" xml-lang="en-US" localize="false">21</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1000180" role="tablecontent" xml-lang="en-US" localize="false">31</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph id="par_id1000190" role="tablehead" xml-lang="en-US" localize="false">2</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1000200" role="tablecontent" xml-lang="en-US" localize="false">12</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1000210" role="tablecontent" xml-lang="en-US" localize="false">22</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1000220" role="tablecontent" xml-lang="en-US" localize="false">32</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph id="par_id1000230" role="tablehead" xml-lang="en-US" localize="false">3</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1000240" role="tablecontent" xml-lang="en-US" localize="false">13</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1000250" role="tablecontent" xml-lang="en-US" localize="false">23</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1000260" role="tablecontent" xml-lang="en-US" localize="false">33</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph id="par_id1000270" role="tablehead" xml-lang="en-US" localize="false">4</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1000280" role="tablecontent" xml-lang="en-US" localize="false">14</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1000290" role="tablecontent" xml-lang="en-US" localize="false">24</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1000300" role="tablecontent" xml-lang="en-US" localize="false">34</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph id="par_id1000310" role="tablehead" xml-lang="en-US" localize="false">5</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1000320" role="tablecontent" xml-lang="en-US" localize="false">15</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1000330" role="tablecontent" xml-lang="en-US" localize="false">25</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1000340" role="tablecontent" xml-lang="en-US" localize="false">35</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph id="par_id1000350" role="tablehead" xml-lang="en-US" localize="false">6</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1000360" role="tablecontent" xml-lang="en-US" localize="false">16</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1000370" role="tablecontent" xml-lang="en-US" localize="false">26</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1000380" role="tablecontent" xml-lang="en-US" localize="false">36</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph id="par_id1000390" role="tablehead" xml-lang="en-US" localize="false">7</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1000400" role="tablecontent" xml-lang="en-US" localize="false">17</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1000410" role="tablecontent" xml-lang="en-US" localize="false">27</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1000420" role="tablecontent" xml-lang="en-US" localize="false">37</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph id="par_id1000430" role="tablehead" xml-lang="en-US" localize="false">8</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1000440" role="tablecontent" xml-lang="en-US" localize="false">18</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1000450" role="tablecontent" xml-lang="en-US" localize="false">28</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1000460" role="tablecontent" xml-lang="en-US" localize="false">38</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph id="par_id1000470" role="tablehead" xml-lang="en-US" localize="false">9</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1000480" role="tablecontent" xml-lang="en-US" localize="false">19</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1000490" role="tablecontent" xml-lang="en-US" localize="false">29</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1000500" role="tablecontent" xml-lang="en-US" localize="false">39</paragraph> +</tablecell> +</tablerow> +</table> + +<paragraph id="par_id1000510" role="paragraph" xml-lang="en-US">Sampling with a period of 2 will result in the following table:</paragraph> +<table id="Tabela2"> +<tablerow> +<tablecell> +<paragraph id="par_id1000520" role="tablecontent" xml-lang="en-US" localize="false">12</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1000530" role="tablecontent" xml-lang="en-US" localize="false">22</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1000540" role="tablecontent" xml-lang="en-US" localize="false">32</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph id="par_id1000550" role="tablecontent" xml-lang="en-US" localize="false">14</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1000560" role="tablecontent" xml-lang="en-US" localize="false">24</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1000570" role="tablecontent" xml-lang="en-US" localize="false">34</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph id="par_id1000580" role="tablecontent" xml-lang="en-US" localize="false">16</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1000590" role="tablecontent" xml-lang="en-US" localize="false">26</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1000600" role="tablecontent" xml-lang="en-US" localize="false">36</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph id="par_id1000610" role="tablecontent" xml-lang="en-US" localize="false">18</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1000620" role="tablecontent" xml-lang="en-US" localize="false">28</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1000630" role="tablecontent" xml-lang="en-US" localize="false">38</paragraph> +</tablecell> +</tablerow> +</table> +<section id="relatedtopics"> +<embed href="text/scalc/01/stat_data.xhp#otherstat"/> +</section> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/statistics_test_chisqr.xhp b/helpcontent2/source/text/scalc/01/statistics_test_chisqr.xhp new file mode 100644 index 000000000..04052f547 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/statistics_test_chisqr.xhp @@ -0,0 +1,91 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * +--> + +<meta> +<topic id="chisquaretest" indexer="include" status="PUBLISH"> +<title xml-lang="en-US" id="tit">Chi Square Statistics in Calc</title> +<filename>/text/scalc/01/statistics_test_chisqr.xhp</filename> +</topic> +</meta> +<body> +<bookmark xml-lang="en-US" branch="index" id="bm_id05004"> +<bookmark_value>Analysis toolpack;Chi-square test</bookmark_value> +<bookmark_value>Chi-square test;Analysis toolpack</bookmark_value> +<bookmark_value>Data statistics;Chi-square test</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/chisquaretestdialog/ChiSquareTestDialog" id="bm_id05005" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/chisquaretestdialog/@@nowidget@@" id="bm_id05005" localize="false"/> +<section id="chisqtest"> + <h1 id="hd_id1000240"><variable id="chisqtesth1"><link href="text/scalc/01/statistics_test_chisqr.xhp" name="Chi-square test">Chi-square test</link></variable></h1> +<paragraph id="par_id1003641" role="paragraph" xml-lang="en-US"><ahelp hid="modules/scalc/ui/chisquaretestdialog/ChiSquareTestDialog">Calculates the Chi-square test of a data sample.</ahelp></paragraph> +</section> +<section id="howtoget"> +<paragraph id="par_id1003990" role="paragraph" xml-lang="en-US"><variable id="sam02">Choose <menuitem>Data - Statistics - Chi-square Test</menuitem></variable></paragraph> +</section> +<note id="par_id1004000">For more information on chi-square tests, refer to the <link href="https://en.wikipedia.org/wiki/Chi-square_test" name="English Wikipedia: Chi-square_test">corresponding Wikipedia article</link>.</note> +<embed href="text/scalc/01/stat_data.xhp#data"/> +<embed href="text/scalc/01/stat_data.xhp#grouped"/> +<embed href="text/scalc/01/stat_data.xhp#datafortests"/> +<h2 id="hd_id1000231">Results for Chi-square Test:</h2> +<table id="tablechisq"> +<tablerow> +<tablecell> +<paragraph id="par_id1004030" role="tablehead" xml-lang="en-US">Test of Independence (Chi-Square)</paragraph> +</tablecell> +<tablecell> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph id="par_id1004040" role="tablecontent" xml-lang="en-US">Alpha</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1004050" role="tablecontent" xml-lang="en-US" localize="false">0.05</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph id="par_id1004060" role="tablecontent" xml-lang="en-US">df</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1004070" role="tablecontent" xml-lang="en-US" localize="false">12</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph id="par_id1004080" role="tablecontent" xml-lang="en-US">P-value</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1004090" role="tablecontent" xml-lang="en-US" localize="false">2.32567054678584E-014</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph id="par_id1004100" role="tablecontent" xml-lang="en-US">Test Statistic</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1004110" role="tablecontent" xml-lang="en-US" localize="false">91.6870055842</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph id="par_id1004120" role="tablecontent" xml-lang="en-US">Critical Value</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1004130" role="tablecontent" xml-lang="en-US" localize="false">21.0260698175</paragraph> +</tablecell> +</tablerow> +</table> +<section id="relatedtopics"> +<embed href="text/scalc/01/stat_data.xhp#otherstat"/> +</section> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/statistics_test_f.xhp b/helpcontent2/source/text/scalc/01/statistics_test_f.xhp new file mode 100644 index 000000000..1fdc54d46 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/statistics_test_f.xhp @@ -0,0 +1,191 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + --> + +<meta> +<topic id="fteststat" indexer="include" status="PUBLISH"> +<title xml-lang="en-US" id="tit">F Test Statistics in Calc</title> +<filename>/text/scalc/01/statistics_test_f.xhp</filename> +</topic> +</meta> +<body> + +<bookmark xml-lang="en-US" branch="index" id="bm_id05002"> +<bookmark_value>Analysis toolpack;F-test</bookmark_value> +<bookmark_value>F-test;Analysis toolpack</bookmark_value> +<bookmark_value>Data statistics;F-test</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/ttestdialog/TTestDialog" id="bm_id05003" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/ttestdialog/@@nowidget@@" id="@@nowidget@@" localize="false"/> +<section id="ftest"> +<h1 id="hd_id1000180"><variable id="ftesth1"><link href="text/scalc/01/statistics_test_f.xhp" name="F-test">F-test</link></variable></h1> +<paragraph id="par_id1003240" role="paragraph" xml-lang="en-US"><ahelp hid="modules/scalc/ui/ttestdialog/TTestDialog">Calculates the F-Test of two data samples.</ahelp></paragraph> +</section> +<section id="howtoget"> +<paragraph id="par_id1003250" role="paragraph" xml-lang="en-US"><variable id="sam02">Choose <menuitem>Data - Statistics - F-test</menuitem></variable></paragraph> +</section> +<paragraph id="par_id1003260" role="paragraph" xml-lang="en-US">A <emph>F-test</emph> is any statistical test based on the F-distribution under the null hypothesis.</paragraph> +<note id="par_id1003270">For more information on F-tests, refer to the <link href="https://en.wikipedia.org/wiki/F-test" name="English Wikipedia: F-test">corresponding Wikipedia article</link>.</note> +<h2 id="hd_id1000190">Data</h2> +<paragraph id="par_id1003280" role="paragraph" xml-lang="en-US"><emph>Variable 1 range</emph>: The reference of the range of the first data series to analyze.</paragraph> +<paragraph id="par_id1003290" role="paragraph" xml-lang="en-US"><emph>Variable 2 range</emph>: The reference of the range of the second data series to analyze.</paragraph> +<paragraph id="par_id1003300" role="paragraph" xml-lang="en-US"><emph>Results to</emph>: The reference of the top left cell of the range where the test will be displayed.</paragraph><embed href="text/scalc/01/stat_data.xhp#grouped"/><embed href="text/scalc/01/stat_data.xhp#datafortests"/> +<h2 id="hd_id1000200">Results for F-Test:</h2> +<paragraph id="par_id1003310" role="paragraph" xml-lang="en-US">The following table shows the <emph>F-Test</emph> for the data series above:</paragraph> +<table id="Tabela12"> +<tablerow> +<tablecell> +<paragraph id="par_id1003320" role="tablecontent" xml-lang="en-US">Ftest</paragraph> +</tablecell> +<tablecell> +</tablecell> +<tablecell> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph id="par_id1003330" role="tablecontent" xml-lang="en-US">Alpha</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1003340" role="tablecontent" xml-lang="en-US" localize="false">0.05</paragraph> +</tablecell> +<tablecell> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +</tablecell> +<tablecell> +<paragraph id="par_id1003350" role="tablecontent" xml-lang="en-US">Variable 1</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1003360" role="tablecontent" xml-lang="en-US">Variable 2</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph id="par_id1003370" role="tablecontent" xml-lang="en-US">Mean</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1003380" role="tablecontent" xml-lang="en-US" localize="false">16.9230769231</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1003390" role="tablecontent" xml-lang="en-US" localize="false">20.4615384615</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph id="par_id1003400" role="tablecontent" xml-lang="en-US">Variance</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1003410" role="tablecontent" xml-lang="en-US" localize="false">125.0769230769</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1003420" role="tablecontent" xml-lang="en-US" localize="false">94.4358974359</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph id="par_id1003430" role="tablecontent" xml-lang="en-US">Observations</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1003440" role="tablecontent" xml-lang="en-US" localize="false">13</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1003450" role="tablecontent" xml-lang="en-US" localize="false">13</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph id="par_id1003460" role="tablecontent" xml-lang="en-US">df</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1003470" role="tablecontent" xml-lang="en-US" localize="false">12</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1003480" role="tablecontent" xml-lang="en-US" localize="false">12</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph id="par_id1003490" role="tablecontent" xml-lang="en-US">F</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1003500" role="tablecontent" xml-lang="en-US" localize="false">1.3244637524</paragraph> +</tablecell> +<tablecell> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph id="par_id1003510" role="tablecontent" xml-lang="en-US">P (F<=f) right-tail</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1003520" role="tablecontent" xml-lang="en-US" localize="false">0.3170614146</paragraph> +</tablecell> +<tablecell> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph id="par_id1003530" role="tablecontent" xml-lang="en-US">F Critical right-tail</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1003540" role="tablecontent" xml-lang="en-US" localize="false">2.6866371125</paragraph> +</tablecell> +<tablecell> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph id="par_id1003550" role="tablecontent" xml-lang="en-US">P (F<=f) left-tail</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1003560" role="tablecontent" xml-lang="en-US" localize="false">0.6829385854</paragraph> +</tablecell> +<tablecell> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph id="par_id1003570" role="tablecontent" xml-lang="en-US">F Critical left-tail</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1003580" role="tablecontent" xml-lang="en-US" localize="false">0.3722125312</paragraph> +</tablecell> +<tablecell> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph id="par_id1003590" role="tablecontent" xml-lang="en-US">P two-tail</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1003600" role="tablecontent" xml-lang="en-US" localize="false">0.6341228293</paragraph> +</tablecell> +<tablecell> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph id="par_id1003610" role="tablecontent" xml-lang="en-US">F Critical two-tail</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1003620" role="tablecontent" xml-lang="en-US" localize="false">0.3051313549</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1003630" role="tablecontent" xml-lang="en-US" localize="false">3.277277094</paragraph> +</tablecell> +</tablerow> +</table> +<section id="relatedtopics"> +<embed href="text/scalc/01/stat_data.xhp#otherstat"/> +</section> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/statistics_test_t.xhp b/helpcontent2/source/text/scalc/01/statistics_test_t.xhp new file mode 100644 index 000000000..6a013e6a5 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/statistics_test_t.xhp @@ -0,0 +1,211 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + --> + +<meta> +<topic id="tteststat" indexer="include" status="PUBLISH"> +<title xml-lang="en-US" id="tit">T Test Statistics in Calc</title> +<filename>/text/scalc/01/statistics_test_t.xhp</filename> +</topic> +</meta> +<body> + +<bookmark xml-lang="en-US" branch="index" id="bm_id05001"> +<bookmark_value>Analysis toolpack;t-test</bookmark_value> +<bookmark_value>Analysis toolpack;paired t-test</bookmark_value> +<bookmark_value>t-test;Analysis toolpack</bookmark_value> +<bookmark_value>paired t-test;Analysis toolpack</bookmark_value> +<bookmark_value>Data statistics;paired t-test</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/ttestdialog/TTestDialog" id="bm_id05002" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/ttestdialog/@@nowidget@@" id="bm_id05002" localize="false"/> +<section id="ttest"> + <h1 id="hd_id1000150"><variable id="ttesth1"><link href="text/scalc/01/statistics_test_t.xhp" name="Paired t-test">Paired t-test</link></variable></h1> +<paragraph id="par_id1002820" role="paragraph" xml-lang="en-US"><ahelp hid="modules/scalc/ui/ttestdialog/TTestDialog">Calculates the paired t-Test of two data samples.</ahelp></paragraph> +</section> +<section id="howtoget"> +<paragraph id="par_id1002830" role="paragraph" xml-lang="en-US"><variable id="sam01">Choose <menuitem>Data - Statistics - Paired t-test</menuitem></variable></paragraph> +</section> +<paragraph id="par_id1002840" role="paragraph" xml-lang="en-US">A <emph>paired t-test</emph> is any statistical hypothesis test that follows a Student's t distribution.</paragraph> +<note id="par_id1002850">For more information on paired t-tests, refer to the <link href="https://en.wikipedia.org/wiki/T-test" name="English Wikipedia: T-test">corresponding Wikipedia article</link>.</note> +<h2 id="hd_id1000160">Data</h2> +<paragraph id="par_id1002860" role="paragraph" xml-lang="en-US"><emph>Variable 1 range</emph>: The reference of the range of the first data series to analyze.</paragraph> +<paragraph id="par_id1002870" role="paragraph" xml-lang="en-US"><emph>Variable 2 range</emph>: The reference of the range of the second data series to analyze.</paragraph> +<paragraph id="par_id1002880" role="paragraph" xml-lang="en-US"><emph>Results to</emph>: The reference of the top left cell of the range where the test will be displayed.</paragraph><embed href="text/scalc/01/stat_data.xhp#grouped"/><embed href="text/scalc/01/stat_data.xhp#datafortests"/> +<h2 id="hd_id1000170">Results for paired t-test:</h2> +<paragraph id="par_id1002890" role="paragraph" xml-lang="en-US">The following table shows the <emph>paired t-test</emph> for the data series above:</paragraph> +<table id="Tabela11"> +<tablerow> +<tablecell> +<paragraph id="par_id1002900" role="tablehead" xml-lang="en-US">paired t-test</paragraph> +</tablecell> +<tablecell> +</tablecell> +<tablecell> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph id="par_id1002910" role="tablecontent" xml-lang="en-US">Alpha</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1002920" role="tablecontent" xml-lang="en-US" localize="false">0.05</paragraph> +</tablecell> +<tablecell> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph id="par_id1002930" role="tablecontent" xml-lang="en-US">Hypothesized Mean Difference</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1002940" role="tablecontent" xml-lang="en-US" localize="false">0</paragraph> +</tablecell> +<tablecell> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +</tablecell> +<tablecell> +<paragraph id="par_id1002950" role="tablecontent" xml-lang="en-US">Variable 1</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1002960" role="tablecontent" xml-lang="en-US">Variable 2</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph id="par_id1002970" role="tablecontent" xml-lang="en-US">Mean</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1002980" role="tablecontent" xml-lang="en-US" localize="false">16.9230769231</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1002990" role="tablecontent" xml-lang="en-US" localize="false">20.4615384615</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph id="par_id1003000" role="tablecontent" xml-lang="en-US">Variance</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1003010" role="tablecontent" xml-lang="en-US" localize="false">125.0769230769</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1003020" role="tablecontent" xml-lang="en-US" localize="false">94.4358974359</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph id="par_id1003030" role="tablecontent" xml-lang="en-US">Observations</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1003040" role="tablecontent" xml-lang="en-US" localize="false">13</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1003050" role="tablecontent" xml-lang="en-US" localize="false">13</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph id="par_id1003060" role="tablecontent" xml-lang="en-US">Pearson Correlation</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1003070" role="tablecontent" xml-lang="en-US" localize="false">-0.0617539772</paragraph> +</tablecell> +<tablecell> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph id="par_id1003080" role="tablecontent" xml-lang="en-US">Observed Mean Difference</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1003090" role="tablecontent" xml-lang="en-US" localize="false">-3.5384615385</paragraph> +</tablecell> +<tablecell> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph id="par_id1003100" role="tablecontent" xml-lang="en-US">Variance of the Differences</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1003110" role="tablecontent" xml-lang="en-US" localize="false">232.9358974359</paragraph> +</tablecell> +<tablecell> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph id="par_id1003120" role="tablecontent" xml-lang="en-US">df </paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1003130" role="tablecontent" xml-lang="en-US" localize="false">12</paragraph> +</tablecell> +<tablecell> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph id="par_id1003140" role="tablecontent" xml-lang="en-US">t Stat</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1003150" role="tablecontent" xml-lang="en-US" localize="false">-0.8359262137</paragraph> +</tablecell> +<tablecell> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph id="par_id1003160" role="tablecontent" xml-lang="en-US">P (T<=t) one-tail</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1003170" role="tablecontent" xml-lang="en-US" localize="false">0.2097651442</paragraph> +</tablecell> +<tablecell> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph id="par_id1003180" role="tablecontent" xml-lang="en-US">t Critical one-tail</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1003190" role="tablecontent" xml-lang="en-US" localize="false">1.7822875556</paragraph> +</tablecell> +<tablecell> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph id="par_id1003200" role="tablecontent" xml-lang="en-US">P (T<=t) two-tail</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1003210" role="tablecontent" xml-lang="en-US" localize="false">0.4195302884</paragraph> +</tablecell> +<tablecell> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph id="par_id1003220" role="tablecontent" xml-lang="en-US">t Critical two-tail</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1003230" role="tablecontent" xml-lang="en-US" localize="false">2.1788128297</paragraph> +</tablecell> +<tablecell> +</tablecell> +</tablerow> +</table> +<section id="relatedtopics"> +<embed href="text/scalc/01/stat_data.xhp#otherstat"/> +</section> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/statistics_test_z.xhp b/helpcontent2/source/text/scalc/01/statistics_test_z.xhp new file mode 100644 index 000000000..b54ba44fd --- /dev/null +++ b/helpcontent2/source/text/scalc/01/statistics_test_z.xhp @@ -0,0 +1,188 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . + --> + +<meta> +<topic id="zteststat" indexer="include" status="PUBLISH"> +<title xml-lang="en-US" id="tit">Z Test Statistics in Calc</title> +<filename>/text/scalc/01/statistics_test_z.xhp</filename> +</topic> +</meta> +<body> + +<bookmark xml-lang="en-US" branch="index" id="bm_id05003"> +<bookmark_value>Analysis toolpack;Z-test</bookmark_value> +<bookmark_value>Z-test;Analysis toolpack</bookmark_value> +<bookmark_value>Data statistics;Z-test</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/ztestdialog/ZTestDialog" id="bm_id05004" localize="false"/> +<bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/ztestdialog/@@nowidget@@" id="bm_id05004" localize="false"/> +<section id="ztest"> + <h1 id="hd_id1000210"><variable id="ztesth1"><link href="text/scalc/01/statistics_test_z.xhp" name="Z-test">Z-test</link></variable></h1> +<paragraph id="par_id1003640" role="paragraph" xml-lang="en-US"><ahelp hid="modules/scalc/ui/ztestdialog/ZTestDialog">Calculates the z-Test of two data samples.</ahelp></paragraph> +</section> +<section id="howtoget"> +<paragraph id="par_id1003650" role="paragraph" xml-lang="en-US"><variable id="sam02">Choose <menuitem>Data - Statistics - Z-test</menuitem></variable></paragraph> +</section> +<note id="par_id1003660">For more information on Z-tests, refer to the <link href="https://en.wikipedia.org/wiki/Z-test" name="English Wikipedia: Z-test">corresponding Wikipedia article</link>.</note> +<h2 id="hd_id1000220">Data</h2> +<paragraph id="par_id1003670" role="paragraph" xml-lang="en-US"><emph>Variable 1 range</emph>: The reference of the range of the first data series to analyze.</paragraph> +<paragraph id="par_id1003680" role="paragraph" xml-lang="en-US"><emph>Variable 2 range</emph>: The reference of the range of the second data series to analyze.</paragraph> +<paragraph id="par_id1003690" role="paragraph" xml-lang="en-US"><emph>Results to</emph>: The reference of the top left cell of the range where the test will be displayed.</paragraph><embed href="text/scalc/01/stat_data.xhp#grouped"/><embed href="text/scalc/01/stat_data.xhp#datafortests"/> +<h2 id="hd_id1000230">Results for z-Test:</h2> +<paragraph id="par_id1003700" role="paragraph" xml-lang="en-US">The following table shows the <emph>z-Test</emph> for the data series above:</paragraph> +<table id="Tabela13"> +<tablerow> +<tablecell> +<paragraph id="par_id1003710" role="tablecontent" xml-lang="en-US">z-test</paragraph> +</tablecell> +<tablecell> +</tablecell> +<tablecell> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph id="par_id1003720" role="tablecontent" xml-lang="en-US">Alpha</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1003730" role="tablecontent" xml-lang="en-US" localize="false">0.05</paragraph> +</tablecell> +<tablecell> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph id="par_id1003740" role="tablecontent" xml-lang="en-US">Hypothesized Mean Difference</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1003750" role="tablecontent" xml-lang="en-US" localize="false">0</paragraph> +</tablecell> +<tablecell> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +</tablecell> +<tablecell> +<paragraph id="par_id1003760" role="tablecontent" xml-lang="en-US">Variable 1</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1003770" role="tablecontent" xml-lang="en-US">Variable 2</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph id="par_id1003780" role="tablecontent" xml-lang="en-US">Known Variance</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1003790" role="tablecontent" xml-lang="en-US" localize="false">0</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1003800" role="tablecontent" xml-lang="en-US" localize="false">0</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph id="par_id1003810" role="tablecontent" xml-lang="en-US">Mean</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1003820" role="tablecontent" xml-lang="en-US" localize="false">16.9230769231</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1003830" role="tablecontent" xml-lang="en-US" localize="false">20.4615384615</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph id="par_id1003840" role="tablecontent" xml-lang="en-US">Observations</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1003850" role="tablecontent" xml-lang="en-US" localize="false">13</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1003860" role="tablecontent" xml-lang="en-US" localize="false">13</paragraph> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph id="par_id1003870" role="tablecontent" xml-lang="en-US">Observed Mean Difference</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1003880" role="tablecontent" xml-lang="en-US" localize="false">-3.5384615385</paragraph> +</tablecell> +<tablecell> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph id="par_id1003890" role="tablecontent" xml-lang="en-US">z</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1003900" role="tablecontent" xml-lang="en-US">#DIV/0!</paragraph> +</tablecell> +<tablecell> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph id="par_id1003910" role="tablecontent" xml-lang="en-US">P (Z<=z) one-tail</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1003920" role="tablecontent" xml-lang="en-US">#DIV/0!</paragraph> +</tablecell> +<tablecell> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph id="par_id1003930" role="tablecontent" xml-lang="en-US">z Critical one-tail</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1003940" role="tablecontent" xml-lang="en-US" localize="false">1.644853627</paragraph> +</tablecell> +<tablecell> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph id="par_id1003950" role="tablecontent" xml-lang="en-US">P (Z<=z) two-tail</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1003960" role="tablecontent" xml-lang="en-US">#DIV/0!</paragraph> +</tablecell> +<tablecell> +</tablecell> +</tablerow> +<tablerow> +<tablecell> +<paragraph id="par_id1003970" role="tablecontent" xml-lang="en-US">z Critical two-tail</paragraph> +</tablecell> +<tablecell> +<paragraph id="par_id1003980" role="tablecontent" xml-lang="en-US" localize="false">1.9599639845</paragraph> +</tablecell> +<tablecell> +</tablecell> +</tablerow> +</table> +<section id="relatedtopics"> +<embed href="text/scalc/01/stat_data.xhp#otherstat"/> +</section> +</body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/text2columns.xhp b/helpcontent2/source/text/scalc/01/text2columns.xhp new file mode 100644 index 000000000..dec39b985 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/text2columns.xhp @@ -0,0 +1,64 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> + +<!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . + --> + + +<meta> + <topic id="textscalc01text2columnsxml" indexer="include"> + <title xml-lang="en-US" id="tit">Text to Columns</title> + <filename>/text/scalc/01/text2columns.xhp</filename> + </topic> +</meta> +<body> +<bookmark xml-lang="en-US" branch="index" id="bm_id8004394"><bookmark_value>text to columns</bookmark_value> +</bookmark> +<bookmark xml-lang="en-US" branch="hid/.uno:TextToColumns" id="bm_id1029200802260951" localize="false"/> + +<section id="t2cheader"> +<h1 id="hd_id2300180"><link href="text/scalc/01/text2columns.xhp">Text to Columns</link></h1> +<paragraph xml-lang="en-US" id="par_id655232" role="paragraph"><variable id="text2columns">Opens the Text to Columns dialog, where you enter settings to expand the contents of selected cells to multiple cells.</variable></paragraph> +</section> + <section id="howtoget"> + <embed href="text/scalc/00/00000412.xhp#text2columns"/> + </section> + <h2 id="hd_id9599597">To expand cell contents to multiple cells</h2> + <paragraph xml-lang="en-US" id="par_id2021546" role="paragraph">You can expand cells that contain comma separated values (CSV) into multiple cells in the same row. </paragraph> + <paragraph xml-lang="en-US" id="par_id2623981" role="paragraph">For example, cell A1 contains the comma separated values <item type="literal">1,2,3,4</item>, and cell A2 contains the text <item type="literal">A,B,C,D</item>. </paragraph> + <list type="ordered"> + <listitem> + <paragraph xml-lang="en-US" id="par_id7242042" role="paragraph">Select the cell or cells that you want to expand.</paragraph> + </listitem> + <listitem> + <paragraph xml-lang="en-US" id="par_id6999420" role="paragraph">Choose <emph>Data - Text to Columns</emph>.</paragraph> + <paragraph xml-lang="en-US" id="par_id6334116" role="paragraph">You see the Text to Columns dialog.</paragraph> + </listitem> + <listitem> + <paragraph xml-lang="en-US" id="par_id9276406" role="paragraph">Select the separator options. The preview shows how the current cell contents will be transformed into multiple cells.</paragraph> + </listitem> + </list> + <paragraph xml-lang="en-US" id="par_id8523819" role="paragraph">You can select a fixed width and then click the ruler on the preview to set cell breakup positions.</paragraph> + <paragraph xml-lang="en-US" id="par_id1517380" role="paragraph">You can select or enter separator characters to define the positions of breaking points. The separator characters are removed from the resulting cell contents.</paragraph> + <paragraph xml-lang="en-US" id="par_id7110812" role="paragraph">In the example, you select the comma as a delimiter character. Cells A1 and A2 will be expanded to four columns each. A1 contains 1, B1 contains 2, and so on.</paragraph> + <section id="relatedtopics"> + <embed href="text/scalc/guide/csv_files.xhp#csv_files"/> + <embed href="text/scalc/guide/csv_formula.xhp#csv_formula"/> + </section> + </body> +</helpdocument> diff --git a/helpcontent2/source/text/scalc/01/xml_source.xhp b/helpcontent2/source/text/scalc/01/xml_source.xhp new file mode 100644 index 000000000..5fe8bfdf9 --- /dev/null +++ b/helpcontent2/source/text/scalc/01/xml_source.xhp @@ -0,0 +1,81 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> + <!-- + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . + --> + + <meta> + <topic id="textscalc01xml_sourcexml"> + <title id="tit" xml-lang="en-US">XML Data</title> + <filename>/text/scalc/01/xml_source.xhp</filename> + </topic> + </meta> + + <body> + + <bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/xmlsourcedialog/XMLSourceDialog" id="bm_id240920171033409926" localize="false"/> + <bookmark xml-lang="en-US" branch="hid/modules/scalc/ui/xmlsourcedialog/@@nowidget@@" id="bm_id240920171033409926" localize="false"/> + <bookmark xml-lang="en-US" branch="index" id="bm_id240920171018528200"> + <bookmark_value>XML Source;load XML data in spreadsheets</bookmark_value> + </bookmark> + <section id="xml_source"> + <h1 id="hd_id240920171003006302"><link href="text/scalc/01/xml_source.xhp">XML Source</link></h1> + <paragraph id="par_id240920171003293400" role="paragraph" xml-lang="en-US"><ahelp hid=".">Import XML data in a spreadsheet.</ahelp></paragraph> + </section> + <paragraph role="paragraph" id="par_id861521496523519" xml-lang="en-US">The XML Source feature allows to import data from arbitrarily structured XML content into cells in an existing spreadsheet document. It allows XML content to be imported either partially or in full, depending on the structure of the XML content and the map definitions that the user defines. The user can specify multiple non-overlapping sub-structures to be mapped to different cell positions within the same document. The user can import either element contents, attribute values or both.</paragraph> + + <section id="howtoget"> + <paragraph id="par_id240920171007389295" role="paragraph" xml-lang="en-US">Choose <item type="menuitem">Data - XML Source</item>.</paragraph> + </section> + <h2 id="hd_id801521494731764">XML Source Dialog</h2> + <embed href="text/shared/06/sc_screenshots.xhp#xmlsource"/> + + <paragraph role="paragraph" id="par_id291521494762812" xml-lang="en-US">The dialog consists of four parts.</paragraph> + + <h3 id="hd_id601521494755603">Source file</h3> + <paragraph role="paragraph" id="par_id161521494769832" xml-lang="en-US">This lets you specify the path to the XML file that you wish to import into your document.</paragraph> + + <h3 id="hd_id491521494788029">Map to Document</h3> + <paragraph role="paragraph" id="par_id211521494776007" xml-lang="en-US">This pane shows the structure of the source XML content as a tree. This is initially empty, and gets populated when you specify the source file.</paragraph> + + <paragraph role="paragraph" id="par_id161521494796604" xml-lang="en-US">Each element in the tree can be one of three types:</paragraph> + <list type="unordered"> + <listitem> + <paragraph id="par_id931521494810426" role="listitem" xml-lang="en-US">attribute, represented by the symbol <emph>@</emph></paragraph> + </listitem> + <listitem> + <paragraph id="par_id521521494825665" role="listitem" xml-lang="en-US">single non-recurring element, represented by the symbol <emph></></emph>, and</paragraph> + </listitem> + <listitem> + <paragraph id="par_id691521494844848" role="listitem" xml-lang="en-US">recurring element, represented by the symbol <emph><//></emph>.</paragraph> + </listitem> + </list> + + <paragraph role="paragraph" id="par_id451521494864514" xml-lang="en-US">A non-recurring element is an element that can only occur once under the same parent. It is mapped to a single cell in the document.</paragraph> + + <paragraph role="paragraph" id="par_id361521494872103" xml-lang="en-US">A recurring element is an element that can appear multiple times under the same parent. It serves as an enclosing parent of a single record entry of multiple record entries. These entries are imported into a range those height equals the number of entries plus one additional header row.</paragraph> + + <h3 id="hd_id581521494885433">Mapped cell</h3> + <paragraph role="paragraph" id="par_id661521494897796" xml-lang="en-US">This field specifies the position of a cell in the document that an element or an attribute is linked to. If it is a non-recurring element or an attribute, it simply points to the cell where the value of the linked element/attribute will get imported. If it is a recurring element, it points to the top-left cell of the range where the whole record entries plus header will get imported.</paragraph> + <h3 id="hd_id151521553082338">Import</h3> + <paragraph role="paragraph" id="par_id131521553077261" xml-lang="en-US">Pressing the Import button starts the import process based on the link definitions that the user has provided. Once the import finishes, the dialog will close.</paragraph> + <section id="relatedtopics"> + <paragraph id="par_id240920171007419799" role="paragraph" xml-lang="en-US"><link href="https://wiki.documentfoundation.org/Development/Calc/XMLSource" target="_blank" name="Wiki page on XML Source">Wiki page on XML Source</link></paragraph> + </section> +</body> + +</helpdocument> |