1. 1 How to use the TIMESTAMPDIFF parameter to perform a mathematical operation on two columns in an Alma Analytics report Yoel Kortick Senior Librarian

2. 2 Copyright Statement and Disclaimer CONFIDENTIAL INFORMATION The information herein is the property of Ex Libris Ltd. or its affiliates and any misuse or abuse will result in economic loss. DO NOT COPY UNLESS YOU HAVE BEEN GIVEN SPECIFIC WRITTEN AUTHORIZATION FROM EX LIBRIS LTD. This document is provided for limited and restricted purposes in accordance with a binding contract with Ex Libris Ltd. or an affiliate. The information herein includes trade secrets and is confidential. DISCLAIMER The information in this document will be subject to periodic change and updating. Please confirm that you have the most current documentation. There are no warranties of any kind, express or implied, provided in this documentation, other than those expressly agreed upon in the applicable Ex Libris contract. This information is provided AS IS. Unless otherwise agreed, Ex Libris shall not be liable for any damages for use of this document, including, without limitation, consequential, punitive, indirect or direct damages. Any references in this document to third-party material (including third-party Web sites) are provided for convenience only and do not in any manner serve as an endorsement of that third-party material or those Web sites. The third-party materials are not part of the materials for this Ex Libris product and Ex Libris has no liability for such materials. TRADEMARKS "Ex Libris," the Ex Libris Bridge to Knowledge, Primo, Aleph, Voyager, SFX, MetaLib, Verde, DigiTool, Rosetta, bX, URM, Alma, and other marks are trademarks or registered trademarks of Ex Libris Ltd. or its affiliates. The absence of a name or logo in this list does not constitute a waiver of any and all intellectual property rights that Ex Libris Ltd. or its affiliates have established in any of its products, features, or service names or logos. Trademarks of various third-party products, which may include the following, are referenced in this documentation. Ex Libris does not claim any rights in these trademarks. Use of these marks does not imply endorsement by Ex Libris of these third-party products, or endorsement by these third parties of Ex Libris products. Oracle is a registered trademark of Oracle Corporation. UNIX is a registered trademark in the United States and other countries, licensed exclusively through X/Open Company Ltd. Microsoft, the Microsoft logo, MS, MS-DOS, Microsoft PowerPoint, Visual Basic, Visual C++, Win32, Microsoft Windows, the Windows logo, Microsoft Notepad, Microsoft Windows Explorer, Microsoft Internet Explorer, and Windows NT are registered trademarks and ActiveX is a trademark of the Microsoft Corporation in the United States and/or other countries. Unicode and the Unicode logo are registered trademarks of Unicode, Inc. Google is a registered trademark of Google, Inc. Web address: http://www.exlibrisgroup.comhttp://www.exlibrisgroup.com

3. 3 Agenda Introduction Applying the TIMESTAMPDIFF filter on two dates

4. 4 Introduction There may be cases where the library has created a report with two date columns and then wants to further process the two columns by performing an additional mathematical operation on them. In the case here the library has a report of items including the PO Line send date and the item receiving date

5. 5 Agenda Introduction Applying the TIMESTAMPDIFF filter on two dates

6. 6 In this example we will make a report in the physical items subject area and include the Barcode and Receiving Date from the Physical Item Details Vendor Name and Sent Date from the PO Line Applying the TIMESTAMPDIFF filter on two dates

7. 7 We can then say as follows: Send date – Receiving Date = days it took to arrive from time of sending By including also the vendor in the report we can see which vendors take more or less time ands thereby make strategic decisions regarding which vendors to use Applying the TIMESTAMPADD filter on transaction date

8. 8 We will first add a new field in the criteria tab. It can be any field. It does not matter what the fields is because we will soon change the formula of the field. The field will merely act as a “placeholder’ Applying the TIMESTAMPADD filter on transaction date New ‘placeholder’ field

9. 9 On the field we will do “Edit Formula” and add the following formula: Applying the TIMESTAMPADD filter on transaction date TIMESTAMPDIFF(SQL_TSI_DAY,"PO Line"."Sent Date","Physical Item Details"."Receiving Date") These are the parts of formula: The TIMESTAMPDIFF gives the difference of two dates. The SQL_TSI_DAY gives the unit in days. The first value is the date from which you want to subtract The second value is the date to subtract. The comma separates the first and second value

10. 10 Add new formula and change column heading: Applying the TIMESTAMPADD filter on transaction date Edit the formula:

11. 11 See results Applying the TIMESTAMPADD filter on transaction date Sent March 5, 2013 Received March 15, 2013 Days to arrive = 10

12. 12 Here we have the table arranged by Vendor and have included only the vendor, barcode and days to arrive Applying the TIMESTAMPADD filter on transaction date

13. 13 In order to get the Average Days to arrive we can change the formula from Applying the TIMESTAMPADD filter on transaction date TIMESTAMPDIFF(SQL_TSI_DAY,"PO Line"."Sent Date","Physical Item Details"."Receiving Date") To Avg(TIMESTAMPDIFF(SQL_TSI_DAY,"PO Line"."Sent Date","Physical Item Details"."Receiving Date")) And we will remove the barcode, because now we want one average per vendor

14. 14 Applying the TIMESTAMPADD filter on transaction date Now we have each vendor and the average days to arrive

15. 15 Applying the TIMESTAMPADD filter on transaction date We can also make a filter on the ‘Days to arrive’ field and filter by only those with more than 30 days average (we want to concern ourselves with the “slow” vendors)

16. 16 Applying the TIMESTAMPADD filter on transaction date This will be much more clear and easy to understand in a graph form

17. 17 Applying the TIMESTAMPADD filter on transaction date Now we can clearly see which vendors take the longest to send items

18. 18 THANK YOU! xxxx.xxxx@exlibrisgroup.com