https://github.com/excel-projects/excel-timesheet
:alarm_clock: This Add-In is used to produce a timesheet file with functionality to import your Google Timeline. The standard timesheet has options for start and end dates, day of week and default start, end and break times. The Google timeline options are start and end dates, UTC selection, daylight savings time parameters and title filter for timeline entries. There is also a right click shortcut to open your Google timeline to the date of the row that is currently selected. The only version is currently in VBA/XML ribbon.
https://github.com/excel-projects/excel-timesheet
addin bulk-data bulk-loader calendar excel excel-2016 google-timeline kml ribbon timeline-entries timesheet vba windows-7 xml
Last synced: 2 months ago
JSON representation
:alarm_clock: This Add-In is used to produce a timesheet file with functionality to import your Google Timeline. The standard timesheet has options for start and end dates, day of week and default start, end and break times. The Google timeline options are start and end dates, UTC selection, daylight savings time parameters and title filter for timeline entries. There is also a right click shortcut to open your Google timeline to the date of the row that is currently selected. The only version is currently in VBA/XML ribbon.
- Host: GitHub
- URL: https://github.com/excel-projects/excel-timesheet
- Owner: Excel-projects
- License: mit
- Created: 2018-08-31T06:36:40.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2020-10-30T14:47:47.000Z (over 4 years ago)
- Last Synced: 2024-09-28T22:41:01.616Z (7 months ago)
- Topics: addin, bulk-data, bulk-loader, calendar, excel, excel-2016, google-timeline, kml, ribbon, timeline-entries, timesheet, vba, windows-7, xml
- Language: Visual Basic .NET
- Homepage:
- Size: 16.4 MB
- Stars: 31
- Watchers: 2
- Forks: 8
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
This Add-In is used to produce a timesheet file with functionality to import your [Google Timeline](https://www.google.com/maps/timeline). The standard timesheet has options for start and end dates, day of week and default start, end and break times. The Google timeline options are start and end dates, UTC selection, daylight savings time parameters and title filter for timeline entries. There is also a right click shortcut to open your Google timeline to the date of the row that is currently selected. I used [Terence Eden's blog post](https://shkspr.mobi/blog/2015/09/get-your-google-location-history-the-hard-way-again/) as a reference to write the procedure for downloading the Google Timeline files. Code review suggestions have been applied from this [article](https://codereview.stackexchange.com/q/206017/158032).
[](LICENSE "MIT License Copyright © Anthony Duguid")
[](https://github.com/Excel-projects/Excel-Timesheet/releases)
[](https://github.com/Excel-projects/Excel-Timesheet/commits/master)
[](https://github.com/Excel-projects/Excel-Timesheet/issues)
-----
## Table of Contents
- Install
- Dependencies
- Glossary of Terms
- Functionality
- Insert Data
- Date Options
- Day Options
- Time Options
- Help
- Admin
- About
## Install
Instructions for installation of VBA version
### VBA
How to install the VBA version
1. Download the VBA Add-In file [](https://github.com/Excel-projects/Excel-Timesheet/raw/master/VBA/Timesheet.xlsm?raw=true "Download the VBA Add-In").
## Dependencies
|Software |Dependency |Project |
|:------------------------------------------|:--------------------------|:--------------------------|
|[Microsoft Excel 2010 (or later)](https://www.microsoft.com/en-au/software-download/office)|Project|VBA|
|[Visual Basic for Applications](https://msdn.microsoft.com/en-us/vba/vba-language-reference)|Code|VBA|
|[Extensible Markup Language (XML)](https://www.rondebruin.nl/win/s2/win001.htm)|Ribbon|VBA, VSTO|
|[ScreenToGif](http://www.screentogif.com/)|Read Me|VBA, VSTO|
|[Snagit](http://discover.techsmith.com/snagit-non-brand-desktop/?gclid=CNzQiOTO09UCFVoFKgod9EIB3g)|Read Me|VBA, VSTO|
|Badges ([Library](https://shields.io/), [Custom](https://rozaxe.github.io/factory/), [Star/Fork](http://githubbadges.com))|Read Me|VBA, VSTO|
| Term | Meaning |
|:--------------------------|:-----------------------------------------------------------------------------------------|
| COM |Component Object Model (COM) is a binary-interface standard for software components introduced by Microsoft in 1993. It is used to enable inter-process communication and dynamic object creation in a large range of programming languages. COM is the basis for several other Microsoft technologies and frameworks, including OLE, OLE Automation, ActiveX, COM+, DCOM, the Windows shell, DirectX, UMDF and Windows Runtime. |
| VBA |Visual Basic for Applications (VBA) is an implementation of Microsoft's event-driven programming language Visual Basic 6 and uses the Visual Basic Runtime Library. However, VBA code normally can only run within a host application, rather than as a standalone program. VBA can, however, control one application from another using OLE Automation. VBA can use, but not create, ActiveX/COM DLLs, and later versions add support for class modules.|
| VSTO |Visual Studio Tools for Office (VSTO) is a set of development tools available in the form of a Visual Studio add-in (project templates) and a runtime that allows Microsoft Office 2003 and later versions of Office applications to host the .NET Framework Common Language Runtime (CLR) to expose their functionality via .NET.|
| XML|Extensible Markup Language (XML) is a markup language that defines a set of rules for encoding documents in a format that is both human-readable and machine-readable.The design goals of XML emphasize simplicity, generality, and usability across the Internet. It is a textual data format with strong support via Unicode for different human languages. Although the design of XML focuses on documents, the language is widely used for the representation of arbitrary data structures such as those used in web services.|
| KML|Keyhole Markup Language (KML) is an XML notation for expressing geographic annotation and visualization within Internet-based, two-dimensional maps and three-dimensional Earth browsers. KML was developed for use with Google Earth, which was originally named Keyhole Earth Viewer.|
## Functionality
This Excel ribbon is inserted after the “Home” tab when Excel opens. Listed below is the detailed functionality of this application and its components.
### Insert Data (Group)
Insert rows of data into the active table with the following controls.
#### Add Days (Button)
* Add days from the textbox values in the start and end dates in the "Date Options" group.
* Optional filter for day of week in "Day Options" group.
#### Add Timeline (Button)
* Add timeline events filter from the start and end dates in the "Date Options" group.
* Downloads the .kml files per day from Google Timeline
* Imports each .kml file with optional filters for Title (using a delimited list in the settings) and day of week in "Day Options" group.
#### UTC (Dropdown)
* This is the timezone offset for the stored date & time values in your Google Timeline.
* Uses a hidden sheet for the list of Timezones
#### Apply DST (Toggle Button)
* This will apply the daylight savings time to the Google Timeline import.
#### Filter Title (Toggle Button)
* This will apply the title filter from the settings to the Google Timeline import.
### Date Options (Group)
These date options will filter the selected table.
#### Start Date (Textbox)
* The value that is used to filter inserts.
#### End Date (Textbox)
* The value that is used to filter inserts.
#### Column (Combobox)
* This refers to the column name that date values get added to.
#### Calendar (Buttons)
* These buttons allow the user to select a date from a calendar.
* Note: The calendar has a reference to Common Controls
#### Refresh (Button)
* This button will refresh the list of column names in the combobox.
#### Current Week (Button)
* This button will set the start and end dates in the textboxes to the current week.
#### Next 7 Days (Button)
* This button will set the start and end dates in the textboxes to the next 7 days using the maximum date from the selected table.
#### Filter Table (Button)
* This button will filter the selected table with the start and end dates from the textboxes.
#### Sun, Mon, Tue, Wed, Thu, Fri, Sat (Checkboxes)
* These checkboxes allow the user to limit the records inserted into the table by selected days
#### Start Time (Combobox)
* The column name of the start time
#### End Time (Combobox)
* The column name of the end time
#### Break Time (Combobox)
* The column name of the break time
#### Refresh (Buttons)
* Refreshes the list of column name from the selected table
#### Start Time (Textbox)
* The default value for the start time when inserted into the selected table
#### End Time (Textbox)
* The default value for the end time when inserted into the selected table
#### Break Time (Textbox)
* The default value for the break time when inserted into the selected table
#### How To… (Button)
* Opens a webpage of the read me documentation
#### Report Issue (Button)
* Opens a page to create a new issue for the product
#### Settings (Button)
* Settings represent user preferences or valuable information the application needs to use.
* This opens the settings form. The settings are stored as custom properties and can be changed by double-clicking the item or using the update button.
VBA
- VBA Settings
- To add a new setting
```vbnet
ThisWorkbook.CustomDocumentProperties.Add _
Name:="App_ReleaseDate" _
, LinkToContent:=False _
, Type:=msoPropertyTypeDate _
, Value:="31-Jul-2017 1:05pm"
```
- To update a setting
```vbnet
ThisWorkbook.CustomDocumentProperties.Item("App_ReleaseDate").Value = "31-Jul-2017 1:05pm"
```
- To delete a setting
```vbnet
ThisWorkbook.CustomDocumentProperties.Item("App_ReleaseDate").Delete
```
### Admin (Group)
This group's visibility is toggled with the F12 key
#### View Errors (Toggle Button)
* View a list of errors in a hidden sheet
#### Visual Basic (Button)
* Opens the Visual Basic editor
#### Export Code (Button)
* Export the VBA and XML code for this file to the current directory
#### Add-in Name (Label)
* The application name with the version
#### Release Date (Label)
* The release date of the application