• *add_days Function
• *add_hours Function
• *add_minutes Function
• *add_months Function
• *add_seconds Function
• *add_years Function
• *days_between Function
• *hours_between Function
• *minutes_between Function
• *months_between Function
• *seconds_between Function
• *years_between Function
• a5_add_timestamp Function
• A5_CONVERT_DATE_STRING Function
• A5_CONVERT_DATETIME_STRING Function
• a5_embeddedcalendargenie Function
• a5_get_date_format Function
• A5_GETDATEHTML Function
• a5_gettimeformats Function
• a5_gettimevalue Function
• a5_normalizedate Function
• A5_RFC1123DATE Function
• A5_RFC822DATE Function
• A5_RFC850DATE Function
• A5_T_FROM_RFCDATE Function
• a5_time_format_help Function
• A5_TIMESTAMP Function
• ADD_BUS_DAYS Function
• ADDMONTHS Function
• ADDYEARS Function
• AGE Function
• BUS_DAYS_BETWEEN Function
• CDATE Function
• CDOW Function
• CMONTH Function
• CONVERT_TYPE Function
• CShortTime Function
• CTIME Function
• CTOD Function
• CTODT Function
• CTOT Function
• CYEAR Function
• Date and Time Conversion Matrix
• Date and Time Format Elements
• Date and Time Functions
• DATE Function
• Date_FirstDayOfMonth Function
• Date_FirstDayOfPreviousMonth Function
• DATE_FORMAT Function
• DATE_FORMATS_BUILT_IN Function
• date_from_utc_date Function
• date_is_anniversary Function
• date_is_in_last_month Function
• DATE_IS_IN_MONTH Function
• date_is_in_previous_quarter Function
• date_is_in_previous_week Function
• date_is_in_previous_year Function
• date_is_in_same_week Function
• date_is_in_this_month Function
• date_is_in_this_month_todate Function
• date_is_in_this_quarter Function
• date_is_in_this_quarter_todate Function
• date_is_in_this_week Function
• date_is_in_this_week_todate Function
• date_is_in_this_year Function
• date_is_in_this_year_todate Function
• date_is_today Function
• date_is_yesterday Function
• Date_LastDayOfMonth Function
• Date_LastDayOfPreviousMonth Function
• date_quarternumber Function
• date_quarterstartend Function
• date_to_utc_date Function
• DATE_VALUE Function
• DAY Function
• DAY_NUMBER Function
• DMY Function
• DOW Function
• DOW_ISO Function
• DTOC Function
• DTOS Function
• FixDateString Function
• FORMAT_DATA Function
• GetTimeZoneOffset Function
• GMT Function
• Holidays
• httpdate Function
• international_days_of_week Function
• international_months Function
• JDATE Function
• JTODATE Function
• MDY Function
• MONTH Function
• MONTH_END Function
• MONTH_NUMBER Function
• MONTH_START Function
• NOW Function
• NTH_DOW Function
• ODBC_DT_TO_D Function
• Predefined Date Formats
• ProgressTimed Function
• SCANTIME Function
• ShortTime_Extract Function
• STOD Function
• Time and Date Functions
• TIME Function
• time_gmt_to_local Function
• time_to_unixtimestamp Function
• TIME_VAR Function
• timez Function
• TOSECONDS Function
• TOTIME Function
• TZ_OFFSET_TO_C Function
• unixtimestamp_to_time Function
• WEEK Function
• WEEK_ISO Function
• WEEK_ISO_FULL Function
• WIN_TIME Function
• WMI_DATE_TO_TIME Function
• wmi_datetime_to_time Function
• YEAR Function
• YearStart_ISO Function

BUS_DAYS_BETWEEN Function

Syntax

Arguments

startDate

The date to which you will add business days.

endDate

The number of business days to add. The function does not count weekend days.

flag

Default = "". If Ignore_Holiday_Flag is any non-null value, the function subtracts holidays from the number of non-weekend days.

holidayTable

Optional. Default = "a_holidays.dbf". If Ignore_Holiday_Flag is non-null, the function uses the list of holidays supplied in Holiday_Table. If Holiday_Table is blank, then Alpha Anywhere uses the a_holidays.dbf table which is contained in the Alpha Anywhere program folder. The holidays in the a_holidays.dbf table are defined in the Settings dialog box, accessed with the View > Settings > System > Holidays command from the Alpha Anywhere menus.

Description

BUS_DAYS_BETWEEN() returns the number of business days between two dates, ignoring weekends and holidays. To use a SQL datasource, 'holidayTable' can be a JSON string with these properties: connectionString, table, column. e.g. {connectionString: 'northwind', table: 'holidays', column: 'dates'}

Example

? bus_days_between({1/18/1948}, date() , "yes")
= 14348

The following scripts count the number of business days in the month that contains a specific date.

dim num_days as N 
 dim dd as D 
 dd = date() 
 num_days = bus_days_between(month_start({2/26/06}), month_end({2/26/06})) 
 num_days = bus_days_between(month_start(dd), month_end(dd))

SQL 'Holidays' Table

The Bus_days_between() can use a SQL table as the data source for the list of holiday dates. To specify a SQL table, the 'holidayTable' argument that is passed into the function is in the form of a JSON string with these properties:

• connectionString

  The connection string to the SQL database

• table

  The name of the table that contains the holiday dates. If this property is not specified a table called 'A5Holidays' is assumed.

• column

  The name of the column that contains the holiday dates. If this property is not specified, a column called 'Dates' is assumed.

• filterColumn

  (optional) the name of a column in the holiday table that you want to filter on

• filterColumnType

  (required if filterColumn is specified) - the data type of the filterColumn. Can be c,n,d,t,l.

• filterValue

  (required if filterColumn is specified) - the value to search for.

Example:

days = Bus_days_between(  {12/1/2013},{12/31/2013},"yes","{connectionstring: 
'myconnstring', table: 'holidays', column: 'dates'}") 
days = Bus_days_between(  {12/1/2013},{12/31/2013},"yes","{connectionstring: 
'myconnstring', table: 'holidays', column: 'dates', filterColumn: 'country', 
filterColumnType: 'c', filterValue: 'USA'}")

See Also

• ADD_BUS_DAYS()
• Settings
• Date and Time Functions